Документация для разработчиков
Темная тема

Импорт в формате CSV

Форма импорта (Контент > Инфоблоки > Импорт > CSV) предназначен для импорта данных в формате CSV в информационный блок.


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

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

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


Шаг 2. Формат

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

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



Шаг 3. Поля

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

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

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

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

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

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

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

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



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

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



Смотри также

  • Описание процесса импорта в курсе Контент-менеджер.


© «Битрикс», 2001-2024, «1С-Битрикс», 2024