Вернуться на сайт

Создание фида каталога по шаблону

Фид для интеграции можно создать с помощью экспорта каталога по шаблону. Для этого небходимо создать профиль экспорта:

  • Перейдите на страницу "Настройки"
  • Перейдите на вкладку "Экспорт"
  • Нажмите на кнопку "+"
  • Укажите название профиля экспорта, выберите профиль ценообразования, по которому будет подготовлен фид, и выберите формат "Каталог по шаблону"
  • Нажмите "Сохранить"

После сохранения профиля экспорта станет доступна настройка шаблона интеграции.

Редактирование существующего профиля:

  • Нажмите напротив этого профиля на значок карандашика.
  • Отредактируйте название или добавьте/удалите профиль ценообразования.
  • Нажмите кнопку "Сохранить".

Удаление существующего профиля:

  • Нажмите напротив этого профиля на значок корзинки.
  • Подтвердите удаление.

Настройка шаблона интеграции:

  • Перейдите на вкладку "Настройка шаблона".
  • Выберите тип выгрузки параметров.
  • Выберите тип валидации (при необходимости).
  • Выберите шаблон (нажамите кнопку "Шаблоны") или напишите свой.
  • Нажмите кнопку "Сохранить".

Для написания шаблона мы используем язык Scriban. Scriban - это быстрый, мощный, безопасный и легкий язык сценариев. Подробнее с языком можно ознакимиться здесь. Проверить корректность работы шаблона можно нажав на кнопку "Тест". После этого появится окно "Результаты", в котором, при корректнонаписаном шаблоне, появится результат (как будет выглядеть фид).

Шаблон на вход получает объект model, содержащий следующие поля:

  • Categories - [список объектов] - список категорий каталога
  • Products - [список объектов] - список товаров каталога

Объекты из списка Categories содержит следующие данные о категории:

  • Id - [число] - Id
  • Name - [текст] - название категории
  • SingularName - [текст] - название категории в единственном числе
  • ParentId - [число или null] - Id родительской категории

Объекты из списка Products содержит следующие данные о товаре:

Объекты из списка Parameters содержит следующие данные о характеристиках товара:

  • Name - [текст] - название характеристики
  • DefinitionId - [текст] - идентификатор характеристики
  • DefinitionExternalId - [текст или null] - внешний идентификатор характеристики
  • Order - [текст] - порядок сортировки характеристики
  • Group - [текст или null] - группа характеристики
  • GroupId - [число или null] - идентификатор группы характеристики
  • GroupOrder - [число или null] - порядок сортировки группы
  • Value - [текст] - значение характеристики (формат зависит от типа: Да/Нет, число, диапазон min...max, одно значение enum, список флагов через ; , список моделей через ; , строка/выражение)
  • Unit - [текст] - единица измерения (только для числовых/диапазонных и numeric enum/flags)

Объекты из списка Tags содержит следующие данные о тегах товара:

  • Id - [число] - Id
  • Name - [текст] - название тега

Добавление условий в шаблон

Условия помогают в выборе товаров, соответствующих определенным критериям. Для добавления условий удобно пользоваться функциями. Функции небходимо определить до шаблона и вызвать внутри шаблона. Условий может быть несколько (при этом они должны называться по разному), несколько условий можно скомбинировать в одно, a также добавлять свои условия. Проверить корректность условий можно здесь.

Для выполнения экспорта:

  • Перейдите на страницу "Задачи".
  • Перейдите на вкладку "Экспорт".
  • Выберите необходимый профиль экспорта.
  • Нажмите кнопку "Запустить".

Статус задачи, а также историю последних выполненых экспортов можно посмотреть в списке "Последние экспорты". Результатом выполнения задачи является файл в формате .xml, который можно скачать нажав напротив нужного экспорта "Скачать". В настройках шаблона можно посмотеть ссылку на этот файл.

К оглавлению