Документация для разработчиков
Темная тема
Недоступно в редакциях: Стандарт, Старт

Ручной импорт в формате CSV (профиль по умолчанию)

Форма импорта каталога товаров

Форма импорта данных Import CSV (new) (пункт меню действий Импортировать для Import CSV (new)) предназначен для импорта данных в формате CSV в торговый каталог. Пример файла формата CSV для импорта.

Примечание: пути для импорта различаются для систем с установленным модулем Интернет-магазин (sale) и без него. В первом случае это будет: Магазин > Настройки > Импорт данных, во втором: Магазин > Торговый каталог > Импорт данных.

Обратите внимание, что импорт данных будет осуществляться не только согласно настройкам самой схемы импорта, но и согласно настройкам, заданным на закладке Экспорт/импорт формы настроек модуля Торговый каталог.


Предварительная настройка импорта

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

Для создания структуры выполните следующие действия.

  1. Создайте и настройте требуемый информационный блок, если его ещё нет.
  2. Создайте в информационном блоке все необходимые свойства (для элементов информационного блока должны быть заданы те же свойства, что и для товаров, импортируемых из CSV файла).
  3. Настройте информационный блок на использование в качестве торгового каталога (см. Торговый каталог).
  4. Загрузите иллюстрации товаров (если они есть) на сайт.

Смотрите также


Контекстная панель

Поле Описание
Вернуться в списокПереход на страницу со списком настроек импорта.


Шаг 1. Файл данных

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

ПолеОписание
Файл данныхС помощью кнопки выберите файл с загружаемыми данными.
Информационный блокВыберите сначала тип информационного блока, а затем и сам блок, в который будет выполняться загрузка данных.

Для продолжения процедуры загрузки данных нажмите кнопку Далее.



Шаг 2. Формат

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

Для возврата к предыдущему шагу воспользуйтесь кнопкой Назад. Для продолжения процедуры загрузки данных нажмите кнопку Далее.



Шаг 3. Поля

Форма служит для задания соответствия между полями инфоблока и загружаемого файла.

ПолеОписание
Задайте соответствие полей в файле полям в базе
Установите соответствие между полями загружаемого файла и полями информационного блока, в который выполняется загрузка данных.
ПолеОписание
Поля в файлеСписок полей загружаемого файла.
Поля в базе Список полей инфоблока, в который выполняется загрузка.

Важно! Обязательно должно быть выбрано хотя бы одно из полей Уникальный идентификатор (B_IBLOCK_ELEMENT.XML_ID) или Название (B_IBLOCK_ELEMENT.NAME). Эти поля используются для сопоставления записей в файле записям в базе данных.

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

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

Внимание! Убедитесь, что соответствия полей заданы корректно. В противном случае результат загрузки непредсказуем.

Дополнительные настройки
Путь к картинкам Для загрузки элементов с иллюстрациями необходимо предварительно выгрузить картинки в какую-либо папку на сайте с помощью любого FTP-клиента. Путь к папке с изображениями, нужно указать в этом поле.
Использовать настройки инфоблока для обработки изображенийПри отмеченной функции изображения, добавленные при импорте, будут преобразовываться согласно настройкам инфоблока.
Использовать настройки инфоблока для транслитерации символьных кодовПри отмеченной опции символьные коды будут транслитероваться согласно настройкам инфоблока (закладка Поля и закладка Поля разделов).
Язык для транслитерацииВыберете язык, который будет использоваться для транслитерации.
Товары, которых не было в файлеОпределяется выполняемое действие над товарами, которые уже есть в базе, но отсутствуют в загружаемом файле:
  • деактивировать - элементы инфоблока станут неактивными;
  • удалить - элементы будут удалены;
  • установить статус "нет в наличии" - для элемента будет установлено следующее:
    • количество на складе - 0;
    • уменьшать количество при заказе - да;
    • разрешать покупку при нулевом количестве - нет;
    • разрешать отрицательное количество товара - нет.
  • не трогать - элементы будут сохранены без изменений.
Неактивные товары / группы, которые есть в файле: Выберите действие, которое будет выполнено над неактивными товарами/группами каталога:
  • оставить как есть - товары/группы не будут изменены;
  • активировать - товары/группы станут активными (т.е. доступными для показа в публичном разделе).
Удалять существующую цену, если ее величина и валюта в файле заданы пустымиПри отмеченной опции существующая цена товара будет удалена, если величина цены и валюта заданы пустыми значениями Например, ;; (т.е. между разделителями ; отсутствует значение цены). в файле. При отключенной опции цена остаётся прежней.
Свойство привязки торговых предложений к товарам содержит внешний код товара (XML_ID)Если в файле импорта свойство привязки торговых предложений к товарам содержит внешний код товара, то опция должна быть отмечена. Если свойство привязки содержит ID товаров, то опция должна быть снята.

Опция доступна только при загрузке в инфоблок торговых предложений.
Время выполнения шагаДлительность одного шага загрузки данных из CSV-файла в секундах. При значении 0 загрузка данных выполняется за один шаг. Параметр Время выполнения шага сделан для больших файлов импорта. Большой – это несколько тысяч позиций. При таких файлах рекомендуется использовать шаг в 30-60 секунд.
Название схемы импорта
Данная секция доступна, если для запуска профиля было выбрано "Добавить профиль", а не "Импортировать".
Название схемы импортаУказывается название пользовательского профиля, под которым необходимо сохранить настройки текущего импорта данных.
Образцы данных
В поле представлен образец загружаемых данных.

Для возврата к предыдущему шагу воспользуйтесь кнопкой Назад. Для выполнения загрузки данных нажмите кнопку Загрузить данные.



Шаг 4. Результат

После того, как загрузка выполнилась, происходит переадресация на страницу Магазин > Торговый каталог > Импорт данных и выводится информация о результатах загрузки данных.



Пользовательские комментарии

Мы будем рады, если разработчики добавят свои комментарии по практическому использованию методов системы.

Для этого нужно всего лишь авторизоваться на сайте

Но помните, что Пользовательские комментарии, несмотря на модерацию, не являются официальной документацией. Ответственность за их использование несет сам пользователь.

Также Пользовательские комментарии не являются местом для обсуждения функционала. По подобным вопросам обращайтесь на форумы.
© «Битрикс», 2001-2024, «1С-Битрикс», 2024
Наверх