Файл CSV

Прежде чем импортировать данные, нужно создать файл CSV, который будет применяться как источник для импорта.

По умолчанию, в «1С-Битрикс: Управление сайтом» для файлов импорта используется разделитель ;. Если вы в своем файле будете использовать иной разделитель, то при выполнении самого импорта не забудьте указать нужный.

Удобнее всего для создания файла использовать программу MS Excel. Можно использовать и другие, вплоть до простейшего Блокнота, но этот табличный редактор удобен и им привычно пользоваться обычным пользователям.

Cамый простой способ подготовки файла .csv – сначала экспортировать каталог (получив готовый файл-образец для наполнения именно вашего каталога), а затем добавлять новые товары по образцу:

  Создание файла .csv

Откройте программу MS Excel.

Создайте новый файл под любым именем (в нашем случае пусть это будет: baza) и сохраните его с расширением csv.

В файле CSV должно присутствовать хотя бы одно из двух полей (по этим полям элементы сопоставляются с базой данных):

• Название элемента (так элемент будет отображаться в каталоге);
• Внешний код элемента (XML_ID).

Рассмотрим случаи, когда и какое из полей должно быть обязательно:

• Если Вы только вносите изменения в уже существующие на сайте элементы, то можно указывать только XML_ID (в первую очередь база данных сверяется именно по XML_ID);
• Если Вы создаете новый элемент, то Вам достаточно При создании нового элемента можно (но не обязательно) добавить колонку с уникальными идентификаторами элементов XML_ID (в этом случае Вы самостоятельно сможете задать этот идентификатор — можно использовать буквы латинского алфавита и цифры).
  
  Если же такую колонку не создавать, то внешние коды будут присвоены новым элементам автоматически. указать название элемента, а XML_ID будет добавлен автоматически при импорте.
  Однако если еще планируется импорт торговых предложений Товары, имеющие торговые предложения, выводятся двумя инфоблоками: инфоблоком товаров (импорт которого вы научились делать ранее ) и инфоблоком торговых предложений.
  
  В этом уроке рассмотрим подробнее, как импортировать инфоблок торговых предложений, сохранив привязку к нужным товарам (т.е. к элементам инфоблока товаров).
  
  Подробнее... (то есть вы готовите два файла: с товарами и с торговыми предложениями этих товаров), то удобнее в первом файле прописать XML_ID, чтобы указать во втором файле эти же XML_ID в поле для привязки предложений к нужному товару.

Название колонок с параметрами не обязательно должно совпадать с названиями параметров в системе. Главное, что бы они были понятны вам, и при задании условий импорта у вас не возникло затруднений в определении соответствий полей создаваемого вами сейчас файла CSV и полей формы импорта.

Создайте обязательную колонку Название и внесите названия товаров так, как они должны отражаться в списке товаров.

Готов необходимый минимум параметров. При желании можно сохранить файл и импортировать его на сайт, технически операция импорта осуществится. Но это – технический минимум, нормальную торговлю на этих данных организовать невозможно. Значит, будем дополнять файл дальше.

Нам нужно, чтобы каждый товар попадал строго в нужную папку в рамках уже созданной структуры каталога. Для этого в процедуре импорта все предусмотрено. Нужно только создать колонки, которые будут объяснять, куда какому товару попадать. У нас крайне простая структура с одним уровнем вложенности. Значит, надо создать одну колонку с названиями папок в каталоге.

Создадим колонку для первого уровня и назовем ее Первый уровень.

Заполните колонку Первый уровень для всех элементов, согласно нашей структуре.

В принципе можно структуру каталога заранее не создавать. При первом импорте будут созданы разделы нужного уровня вложенности с названиями, заданными в колонках файла. Но при регулярном импорте важно указать точное название разделов для импорта элементов.

Теперь можно приступать к созданию колонок с данными о товаре.

Создайте колонки, соответствующие необходимым данным для импорта и заполните колонки данными.

  Важные моменты

• Если в качестве описания используется текст, отформатированный html-тегами, то необходимо в настройках модуля Торговый каталог, на закладке Экспорт / Импорт добавить в качестве используемой строку Тип детального описания . Если html-форматирование используется и для анонсового описания, то нужно добавить соответствующую строку и для анонсового описания. Соответственно, в CSV-файле должны быть добавлены колонки, указывающие на тип описания.
• Добавление элемента в колонки со свойством типа Привязка к элементу не произведет автоматического привязывания элемента, если элементы еще не созданы (так как заполнить эту колонку можно только ID элементов, а они еще неизвестны). Привязку необходимо осуществить после экспорта, вручную. Однако, если элементы инфоблоков уже созданы, то можно в соответствующие колонки ввести код элемента.
• При добавлении численных значений необходимо следить, чтобы разделитель десятичных знаков, используемый в «1С-Битрикс: Управление сайтом» совпадал с разделителем, используемым в CSV-файле. В системе «1С-Битрикс: Управление сайтом» в качестве разделителя десятичных знаков используется точка.
• Одновременно с указанием цены, в CSV-файле обязательно необходимо предусмотреть колонку валюта, в которой будет указана используемая валюта. Без этого импорт не произойдет. Точнее – импорт элементов осуществится, но цены не будут добавлены или обновлены.
  В колонках Цена и Валюта не должно быть пробелов Корректное заполнение:
  ;; (Если не нужно добавлять, обновлять цену)
  1234;RUB; (Если нужно добавить или обновить цену).
  
  Ошибочное заполнение:
    ;RUB; (Пробел в колонке Цена или Валюта)
  ;RUB; (Отсутствие значения цены)
  123123;; (Отсутствие значения валюты) .
  
• Для загрузки данных для свойств с признаком множественности, необходимо повторить строку с товаром столько раз, сколько будет множественных полей. Например, в случае со свойством Технические характеристики, нам нужно заполнить три поля. Следовательно, в файле CSV получится по три строки на каждый товар. Если множественных свойств несколько, то число строк должно равняться числу параметров наибольшего свойства. Ячейки для параметров свойств с меньшим числом можно просто оставить пустыми. Все строки должны быть одинаковыми по содержанию, за исключением множественных полей, которые изменяются указанием новых данных для этого свойства. Подобная особенность импорта с помощью стандартного механизма приводит к распуханию файла, если количество множественных свойств много и они интенсивно используются. При импорте больших файлов следует использовать пошаговые операции.
• Перед импортом необходимо загрузить картинки в систему. В файле CSV для них должна быть выделена своя отдельная колонка. Картинки могут быть расположены в любом месте в рамках файловой структуры, главное – указать при импорте правильный путь до них. Рекомендуется использовать папку /upload. Картинки загружаются в файловую структуру, если это разрешено настройками хостинга.
  
  Примечание: Изображения также можно добавить со сторонних сайтов (но не из облачных хранилищ), прописав полные URL этих картинок В случае, если в URL содержатся кириллические символы, они должны быть кодированы в формате Unicode. То есть, например, вместо https://www.google.ru/search?q=кодирование+кириллицы должно быть https://www.google.ru/search?q=%D0%BA%D0%BE%D0%B4%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5+%D0%BA%D0%B8%D1%80%D0%B8%D0%BB%D0%BB%D0%B8%D1%86%D1%8B. .
  
  Этот способ не рекомендуется для загрузки больших каталогов, т.к. при импорте каталога изображения будут копироваться на Ваш сайт (если php на сервере это разрешает), и сам процесс импорта займёт значительно большее время.

• Проверьте настройки инфоблока В данном примере опция Начало активности отмечена как обязательная, поэтому в создаваемом
  файле csv тоже должна быть колонка с указанием начала активности элемента.
  
  (Контент > Инфоблоки > Типы инфоблоков > [ваш тип инфоблока]/[ваш инфоблок]), в который Вы хотите загрузить файл: если во вкладках Поля или Поля разделов какие-либо поля отмечены как обязательные, то эти колонки должны быть обязательно и в загружаемом csv-файле.
• С версии В более ранних версиях поле Единица измерения остаётся пустым, если оно не заполнено в импортируемом файле. модуля Торговый каталог 20.0.100 при импорте для новых товаров устанавливается единица измерения по умолчанию, если в файле не указано иное значение.

  Пример итогового файла .csv

IE_NAME;IP_PROP9;IP_PROP11;IP_PROP13;IC_GROUP0;IC_GROUP1;IC_GROUP2;CV_PRICE_1;CV_CURRENCY_1

Ремень Класика;188-12-xx;кожа;/upload/classic1.jpg;Аксессуары;Ремни;Ремни Мужские;1190.00;RUB

Ремень Класика;188-12-xx;кожа;/upload/classic2.jpg;Аксессуары;Ремни;Ремни Мужские;1190.00;RUB

Ремень Класика;188-12-xx;кожа;/upload/classic3.jpg;Аксессуары;Ремни;Ремни Мужские;1190.00;RUB

Ремень Элегантность;188-13-xx;кожа;/upload/elegance1.jpg;Аксессуары;Ремни;Ремни Женские;730.00;RUB

Ремень Элегантность;188-13-xx;кожа;/upload/elegance2.jpg;Аксессуары;Ремни;Ремни Женские;730.00;RUB

Ремень Элегантность;188-13-xx;кожа;/upload/elegance3.jpg;Аксессуары;Ремни;Ремни Женские;730.00;RUB

В данном примере описана загрузка информации о двух новых товарах: мужского ремня "Классика" и женского ремня "Элегантность":

• прописываем название товара (для новых товаров будет сгенерирован автоматически XML_ID);
• формируем структуру разделов: в разделе Аксессуары находится раздел Ремни, в котором два подраздела – Ремни мужские и Ремни женские;
• прописываем свойства товаров, которые хотим указать (например, Артикул и Материал );
• у каждого ремня есть по 3 изображения (т.е. множественное свойство Картинки галереи), поэтому строки одного и того же товара дублируем и в каждой меняем только название картинки;
• указываем Цену и Валюту.

Примечание: в нашем случае в настройках наполняемого инфоблока во вкладках Поля (или Поля разделов) НЕТ каких-либо полей, отмеченных как обязательные (иначе эти поля нужно обязательно указывать в загружаемом файле .csv).