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

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

В этом разделе

  • Шаг 1. Файл данных
  • Шаг 2. Формат
  • Шаг 3. Поля
  • Шаг 4. Результат
  • Форма импорта (Контент > Информационные блоки > Импорт > CSV) предназначен для импорта данных в формате CSV в информационный блок.

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

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

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

    Шаг 2. Формат

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

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

    Шаг 3. Поля

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

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

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

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

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

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

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

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

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

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

    Смотри также

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

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

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

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

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

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