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

Импорт каталога из 1С

Компонент выполняет импорт данных из 1С в формате CommerceML v2. Компонент является стандартным и входит в дистрибутив модуля.

В визуальном редакторе компонент расположен по пути Контент > Обмен с 1С > Импорт каталога из 1c.

Компонент относится к модулю Торговый каталог.

Пример вызова компонента catalog.import.1c

Секции настроек компонента:

  • Основные параметры
  • Картинка анонса
  • Транслитерация символьного кода из названия
  • Описание параметров

    Поле Параметр Описание
    Основные параметры
    Тип инфо-блока IBLOCK_TYPE В выпадающем списке списке перечислены все уже созданные в системе типы инфоблоков. При выборе пункта Создать по необходимости в случае отсутствия необходимого типа инфоблока, будет создан новый.
    Параметр играет роль только при первом импорте каталога (когда он создается). При последующих операциях импорта того же каталога этот параметр игнорируется.
    Сайты, к которым привязывать инфоблоки при создании SITE_LIST Указывается сайт(ы), к которому будут привязываться новые инфоблоки, создаваемые при импорте. Привязка может производиться либо к текущему сайту, либо к одному определённому сайту из имеющихся в системе.
    Интервал одного шага в секундах (0 - выполнять загрузку за один шаг) INTERVAL Указывается интервал одного шага в секундах при импорте каталога в систему. 0 - выполнять загрузку за один шаг.
    Группы пользователей, которым разрешена загрузка GROUP_PERMISSIONS Указывается группа(-ы) пользователей, обладающие правом загрузки каталога на сайт.
    Вести предложения в отдельном инфоблоке USE_OFFERS [Y|N] При отмеченной опции предложения будут загружены в отдельный инфоблок.
    Цены только в инфоблоке предложений FORCE_OFFERS [Y|N] Данная опция имеет смысл, если некоторые товары выгружаются без характеристик:
    • если опция отмечена, то при выгрузке товаров из 1С, цены на товары будут храниться в торговых предложениях. Т.е для каждого товара будет создано 1 торговое предложение, в котором и будет храниться цена;
    • если опция не отмечена, то для выгруженных из 1С товаров торговые предложения создаваться не будут, цена будет храниться в самом товаре.
    Для тех товаров, у которых есть характеристики, будут созданы торговые предложения в соответствии с количеством характеристик и цены будет храниться в этих торговых предложениях.

    Хранение самих торговых предложений определяется опцией "Вести предложения в отдельном инфоблоке".
    Импортировать с учетом типа инфоблока USE_IBLOCK_TYPE_ID [Y|N] При отмеченной опции данные будут импортированы с учетом типа инфоблока(ов).
    Не импортировать корневой раздел инфоблока, если он единственный SKIP_ROOT_SECTION [Y|N] При отмеченной опции корневой раздел инфоблока импортироваться не будет, если он единственный.
    Что делать с элементами, отсутствующими в файле импорта ELEMENT_ACTION Указывается действие с элементами, которые есть в системе, но отсутствуют в файле импорта:
    • N (ничего) - игнорировать, т.е. никаких действий не совершать;
    • A (деактивировать) - сделать такие элементы неактивными;
    • D (удалить) - удалить такие элементы.
    Что делать с разделами, отсутствующими в файле импорта SECTION_ACTION Указывается действие с разделами, которые есть в системе, но отсутствуют в файле импорта:
    • N (ничего) - игнорировать, т.е. никаких действий не совершать;
    • A (деактивировать) - сделать такие разделы неактивными;
    • D (удалить) - удалить такие разделы.
    Размер единовременно загружаемой части файла (в байтах) FILE_SIZE_LIMIT Указывается размер единовременно загружаемой части файла в байтах.
    Использовать контрольные суммы элементов для оптимизации обновления каталога USE_CRC [Y|N] При отмеченной опции при выгрузке полного каталога изменению подвергнуться только изменившиеся элементы, что значительно снизит нагрузку на сервер и позволит процедуре обновления отработать значительно быстрее.
    Использовать сжатие zip, если доступно USE_ZIP [Y|N] При отмеченной опции данные сжимаются ZIP форматом (если доступно). Это позволяет заметно уменьшить размер файлов.
    Тегированный кеш инфоблока IBLOCK_CACHE_MODE Настройка управляет работой с тегированным кешем инфоблока при импорте.
    Картинка анонса
    Использовать настройки инфоблока для обработки изображений USE_IBLOCK_PICTURE_SETTINGS [Y|N] При отмеченной опции будут использоваться настройки инфоблока для обработки картинки анонса.При неотмеченной опции станут доступны дополнительные поля.
    Автоматически генерировать картинку анонса GENERATE_PREVIEW [Y|N] При отмеченной опции на основании фотографий, которые поступают из 1С, система будет самостоятельно генерировать картинку анонса (защита от поступления из 1С больших фотографий).
    Максимально допустимая ширина картинки анонса PREVIEW_WIDTH При отмеченной опции Автоматически генерировать картинку анонса в данном поле определяется максимальная ширина картинки анонса в пикселях.
    Максимально допустимая высота картинки анонса PREVIEW_HEIGHT При отмеченной опции Автоматически генерировать картинку анонса в данном поле определяется максимальная высота картинки анонса в пикселях.
    Изменять детальную картинку DETAIL_RESIZE [Y|N] При отмеченной опции на основании фотографий, которые поступают из 1С, система будет самостоятельно изменять детальную картинку (защита от поступления из 1С больших фотографий).
    Максимально допустимая ширина детальной картинки DETAIL_WIDTH При отмеченной опции Изменять детальную картинку в данном поле определяется максимальная ширина детальной картинки в пикселях.
    Максимально допустимая высота детальной картинки DETAIL_HEIGHT При отмеченной опции Изменять детальную картинку в данном поле определяется максимальная высота детальной картинки в пикселях.
    Транслитерация символьного кода из названия
    Транслитерировать при добавлении элемента или раздела TRANSLIT_ON_ADD [Y|N] При отмеченной опции при добавлении элемента или раздела будет происходить транслитерация символьного кода из его названия, станут доступны дополнительные поля.
    Максимальная длина результата транслитерации TRANSLIT_MAX_LEN Указывается максимальная длина символьного кода при транслетирации из названия в символах.
    Приведение к регистру TRANSLIT_CHANGE_CASE Указывается к какому регистру будет приводиться результат при транслитерации символьного кода элемента или раздела:
    • <пусто> - сохранить (регистр не меняется);
    • L - к нижнему регистру;
    • U - к верхнему регистру.
    Замена для символа пробела TRANSLIT_REPLACE_SPACE Указывается каким символом будет заменяться пробел при транслитерации символьного кода элемента или раздела из названия.
    Замена для прочих символов TRANSLIT_REPLACE_OTHER Указывается каким символом будет заменяться прочие символы при транслитерации символьного кода элемента или раздела из названия.
    Удалять лишние символы замены TRANSLIT_DELETE_REPEAT_REPLACE [Y|N] При отмеченной опции будут удаляться повторяющиеся символы при транслитерации символьного кода из названия.
    Транслитерировать при обновлении элемента или раздела TRANSLIT_ON_UPDATE [Y|N] При отмеченной опции при обновлении элемента или раздела будет происходить транслитерация символьного кода из его названия, станут доступны дополнительные поля.
    Максимальная длина результата транслитерации TRANSLIT_MAX_LEN Указывается максимальная длина символьного кода при транслетирации из названия в символах.
    Приведение к регистру TRANSLIT_CHANGE_CASE Указывается к какому регистру будет приводиться результат при транслитерации символьного кода элемента или раздела:
    • <пусто> - сохранить (регистр не меняется);
    • L - к нижнему регистру;
    • U - к верхнему регистру.
    Замена для символа пробела TRANSLIT_REPLACE_SPACE Указывается каким символом будет заменяться пробел при транслитерации символьного кода элемента или раздела из названия.
    Замена для прочих символов TRANSLIT_REPLACE_OTHER Указывается каким символом будет заменяться прочие символы при транслитерации символьного кода элемента или раздела из названия.
    Удалять лишние символы замены TRANSLIT_DELETE_REPEAT_REPLACE [Y|N] При отмеченной опции будут удаляться повторяющиеся символы при транслитерации символьного кода из названия.


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

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

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

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

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