С чего начать

Что такое CSV-файл

If your code works fine don’t touch it!

CSV (от англ. Comma-Separated Values — значения, разделённые запятыми) — текстовый формат, предназначенный для представления табличных данных. Строка таблицы соответствует строке текста, которая содержит одно или несколько полей, разделенных запятыми (wikipedia.org).

Формат CSV стандартизирован не полностью. Название формата – CSV (значения, разделённые запятыми) – указывает что для разделения полей используется запятая. Тем не менее термин “CSV” может использоваться для обозначения схожих форматов. Много программ понимают под CSV более общий формат DSV (delimiter-separated values — значения разделённые разделителем), допускающий использование иных символов в качестве разделителя.

Другими словами, это текстовый файл, в котором содержится информация в виде отдельных строк, где каждая строка это отдельная запись (например об одном товаре). Разделителем ( delimiter) значений колонок (разделитель полей CSV) является символ запятая (,) или точка с запятой (;).

Разделитель текста – значения, содержащие зарезервированные символы (двойная кавычка, запятая, точка с запятой, новая строка) обрамляются двойными кавычками (“). Если в значении встречаются кавычки — они представляются в файле в виде двух кавычек подряд.

Наименование полей CSV – первая строка файла обычно сдержит наименование CSV полей (колонок) для идентификации этих полей (колонок).

Пример CSV-файла

Исходный текст CSV-файла, где каждая строка это одна строка таблицы:

_ID_;_NAME_;_MODEL_;_PRICE_
28;"HTC Touch HD";"Product 1";1750.0000
29;"Palm Treo Pro";"Product 2";112.0000
30;"Canon EOS 5D";"Product 3";113.0000

Представление в виде втаблицы если открыть в Apache OpenOffice Calc:

_ID_ _NAME_ _MODEL_ _PRICE_
28 “HTC Touch HD” “Product 1” 1750.0000
29 “Palm Treo Pro” “Product 2” 112.0000
30 “Canon EOS 5D” “Product 3” 113.0000

Что бы посмотреть содержимое CSV-файла его можно открыть в любом текстовом редакторе, например в Notepad++ (Как проверить формат CSV-файла) или в любом другом тестовом редакторе.

Как создать CSV-файл

Наиболее удобный и быстрый способ получить шаблон CSV-файла  правильного формата  – это сделать экспорт товаров через расширение CSV Price Pro import/export. Для этого в разделе Товары (eng. Products) перейдите на вкладку Экспорт (eng. Export)., выберите справа необходимые поля для экспорта и сделайте экспорт, в результате вы получите готовый для работы CSV-файл

Чем открывать и редактировать CSV-файл

Первое что нужно сделать, это скачать и установить офисный пакет Apache OpenOffice, в составе которого есть Apache OpenOffice Calc, приложение для электронных таблиц, позволяющее работать с файлами в формате  CSV.

При открытии CSV-файла в приложении Apache OpenOffice Calc выберите параметры в соответствии с настройками как показано на скриншоте ниже:
  • Кодировка файла: Юникод (UTF-8)
  • Разделитель значений колонок (разделитель полей CSV):  точка с запятой (;)
  • Разделитель текста и зарезервированных символов: двойная кавычка (“)
  • Поля в кавычках как текст – выбрать
  • Меню по правому клику мышки для определения типа колонки (всегда текстовое eng. Text)
 Open CSV-file

Как правильно сохранить CSV-файл

Нет вежливых ответов на вопросы формы «Почему Excel делает X?».

Microsoft Excel умеет открывать CSV-файлы в кодировке Unicode (UTF-8) через импорт данных из файла… и пожалуй на этом можно остановиться!

Microsoft Excel не умеет сохранять CSV-файлы должным образом, при сохранении в Microsoft Excel, вы получите CSV-файл в зависимости от региональных настроек системы, обычно это разделитель табуляция или запятая и кодировка Windows-1251 (для России).
OpenCart работает в кодировке Unicode (UTF-8), что бы избегать проблем связянных с обработкой CSV-файлов в различных кодировках, используйте файлы в кодировке Unicode (UTF-8).

Для того что бы сохранить файл в  формате CSV выберите Файл > Сохранить как.

В появившемся окне выбрать тип файла Текст CSV (.csv), установите “галочку” напротив появившегося внизу пункта Изменение настроек фильтра Edit filter settings

Нажать кнопку Сохранить.

В открывшемся окне выберите вариант Использовать текущий формат

В открывшемся окне Экспорт в текстовый файл выберите:

  • Кодировка: Юникод (UTF-8)
  • Разделитель поля: точка с запятой (;)
  • Разделитель текста: двойная кавычка (“)
  • Текстовые значения в кавычках – выбрать

Нажать кнопку OK для сохранения.

Как проверить формат CSV-файла

CSV является простым и распространенным форматом для табличных данных, это простой текстовый файл, который cодержит текст без форматирования и имеет расширение CSV (.csv) вместо традиционного расширения TXT (.txt), такой файл может быть открыт любой программой для работы с текстом.

Вот неполный список приложений для открытия простых текстовых файлов .txt или .csv:

  • Microsoft Notepad (Windows)
  • Microsoft WordPad (Windows)
  • Helios TextPad (Windows)
  • Notepad++ (Windows)
  • Notepad2 (Windows)
  • Geany (Windows, Mac, Linux)
  • Apple TextEdit (Mac)
  • Apple Pages (iOS)
  • Leafpad (Linux)
  • gedit (Linux)
  • KWrite (Linux)
Установка
Описание полей CSV