Была ли полезна для вас статья?
Да Нет

Создание выгрузки XML


Для создания выгрузки формата XML необходимо подготовить три файла — filters.xml, params.xml и items.xml в кодировке UTF-8, следуя установленной структуре каждого из файлов, описанной ниже, чтобы ваша выгрузка XML была полной и корректной. 



Файл filters.xml

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



1) Тег <filter> — этот тег представляет сам фильтр. Каждый фильтр описывается отдельным тегом <filter>.


атрибут значение
name название фильтра
type тип фильтра: 
  • select — Список: доступно несколько вариантов для выбора;
  • radio — Переключатель: можно выбрать только один вариант;
  • input — Поле ввода (от-до): задается диапазон значений (минимальное и максимальное);
  • checkbox — Галочка: позволяет выбрать одно из двух состояний Вкл./Выкл.
section принадлежность фильтра:
  • item — Товары; 
  • part — Разделы; 
  • all — Все (по умолчанию).
sort сортировка



2) Тег <value> — вложенный тег, который указывает значение фильтра. Для фильтров типа select и radio предусмотрено использование нескольких таких тегов, для типа input — два (минимальное и максимальное значение диапазона), а для типа checkbox — ни одного. 


атрибут значение
name значение фильтра (обязательный, по нему идет привязка к товару)
sort сортировка



3) Тег <part> — вложенный тег, определяющий раздел сайта, к которому данный фильтр относится. Если тегов <part> нет, фильтр применяется ко всем разделам. 


атрибут значение
id ID раздела из основной выгрузки (items.xml)




Файл params.xml

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



1) Тег <param> — этот тег представляет сам параметр. Каждый параметр описывается отдельным тегом <param>.

атрибут значение
name ID раздела из основной выгрузки (items.xml)
key ключ параметра (локальный ID параметра для синхронизации), должен содержать только буквы латинского алфавита без пробелов
type тип параметра:
  • text — Текст (по умолчанию);  
  • number — Число;
  • price — Цена;
  • date — Дата;
  • boolean — Переключатель: позволяет выбрать одно из двух состояний Вкл./Выкл.;
  • color — Цвет.
group название группы параметров (для объединения параметров в логический блок)
section принадлежность параметра:
  • item — Товары; 
  • part — Разделы; 
  • all — Все (по умолчанию).
sort сортировка
is_group указывает на то, что данный параметр является групповой характеристикой (если 1, то параметр является групповой характеристикой)



2) Тег <part> — вложенный тег, определяющий раздел сайта, к которому данный параметр относится. Если тегов <part> нет, параметр применяется ко всем разделам. 


атрибут значение
id ID раздела из основной выгрузки (items.xml)




Файл items.xml

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



1) Тег <part> — раздел или подраздел каталога, к которому данный параметр относится. Если тег <part> является подразделом, то обязательно указывается атрибут parent. 


атрибут значение
parent ID родительского раздела
name название раздела



2) Тег <item> — вложенный тег, который находится внутри тега <part> или <group> (в случае группировки). 


атрибут значение
id ID товара (обязательный)
vcode артикул
name название товара (обязательный)
desc_short анонс
desc_full полное описание
price цена (обязательный)
price_new цена с учетом скидки
amount количество (обязательный)
unit единица измерения
step шаг заказа
weight вес, г
width ширина, см
height высота, см
length длина, см
color цвет товара
sort сортировка
render отображать групповой товар в списке (если 1, то отображать)
main основной товар в группе (если 1, то основной)
extra_parts дополнительные разделы для товара (несколько ID разделов передавать через запятую)


При объединении товаров в группу дополнительно к тегу <item> необходимо указать групповые характеристики, по которым создается группа. Базовыми характеристиками являются: 

  • color (цвет);
  • weight (вес, г); 
  • width (ширина, см); 
  • height (высота, см); 
  • length (длина, см).

Внимание! При необходимости можно добавить дополнительные групповые характеристики в файле params.xml, если добавлять атрибут is_group для тега <param>.



3) Тег <param> — вложенный тег, который находится внутри тега <part> или <item>. В нем передаются дополнительные параметры (характеристики) раздела или товара, которые указываются во вложенных тегах <value>. 


атрибут значение
key ключ параметра, соответствующий данному параметру из файла params.xml


Внимание! Разделы, для которых допустимы параметры, обязательно должны соответствовать данным из файла params.xml.



4) Тег <filter> — вложенный тег, который находится внутри тега <part> или <item>. Обозначает, что по данному фильтру идет выборка раздела или товара согласно пунктам, указанным во вложенных тегах <value> .


атрибут значение
name название фильтра, соответствующее данному параметру из файла filters.xml


Внимание! Значения фильтров и разделы, для которых допустимы фильтры, обязательно должны соответствовать данным из файла filters.xml.



5) Тег <group> — вложенный тег, который находится внутри тега <part>. Необходим для группировки идентичных товаров с разными групповыми характеристиками (цвет, вес, размеры и т.д.).


атрибут значение
id ID группы


Внимание! Вложенными в тег <group> являются теги <item> — товары, которые необходимо объединить. В группе может быть сколько угодно товаров с атирибутом render="1", но необходимо помнить, что такие товары выводятся в списке товаров.



6) Тег <related> — вложенный тег, который находится внутри тега <item>. Указывает на связку данного товара с родительским тегом <item>.


атрибут значение
id ID связанного товара



7) Тег <tag> — вложенный тег, который находится внутри тега <item>. Задает теги указаннного товара (может быть несколько).


атрибут значение
name название тега 



8) Тег <brand> — вложенный тег, который находится внутри тега <item>. Задает бренды указаннного товара (может быть несколько).


атрибут значение
name название бренда
main основной бренд (если 1, то основной)



9) Тег <category> — вложенный тег, который находится внутри тега <item>. Задает категории (статусы) указанного товара (может быть несколько).


атрибут значение
name название категории (статуса)




Модуль «Цвета»

Цвета автоматически наполняются в модуль «Цвета» в SE4, если переданы в качестве атрибута color для тега <item> и/или если тег <filter> в файле filters.xml имеет название (атрибут name) «Цвет» или «Color».




Пример выгрузки XML

filters.xml filters.xml
 файл выгрузки, который содержит информацию обо всех фильтрах, используемых на сайте, включая их значения и связи с разделами.
params.xml params.xml
 файл выгрузки, который содержит информацию обо всех параметрах (характеристиках), используемых на сайте, включая их связи с разделами.
items.xml items.xml
 основной файл выгрузки, который содержит информацию обо всех разделах, товарах и группах, используемых на сайте.


Скачать все файлыСкачать все файлы




Поздравляем, теперь вы можете создать собственную выгрузку и протестировать ее на своем сайте!
Для этого перейдите в модуль административной панели «Синхронизация данных каталога».