Сопоставление значения по справочнику

Как заменить ID из товара на название или полный путь из справочника в XML, JSON или таблице.

Сопоставить по справочнику используется, когда в товаре, строке или элементе хранится ID, а название лежит в отдельном справочнике того же источника.

Анимация сопоставления значения по справочнику в Eofferix
Сопоставление по справочнику связывает текущий ID с ID и названием в списке справочника.

Типовой пример: в товаре есть category_id = 12, а в списке категорий есть запись id = 12, parent_id = 3, name = Стулья. Eofferix может вывести Стулья или полный путь Мебель > Стулья.

Где включить

  • Откройте настройки поля, узла или столбца результата, куда нужно вывести название или путь.
  • В блоке Дополнительные настройки включите Сопоставить по справочнику.
  • В таблицах справочник может быть на другом листе. В JSON и XML выберите пути к полям справочника внутри исходного документа.

Что подставлять

РежимКогда использоватьРезультат
Значение из справочникаНужно заменить ID на название, код или другое поле справочника.12 становится Стулья.
Путь разделовНужно получить название раздела или полный путь по parent_id.12 становится Мебель > Стулья.

Поля настройки

ПолеЧто выбрать
Где лежит ID у текущего элементаПоле товара или строки, где хранится ID. Если оставить пустым, сервис использует текущее значение настраиваемого поля.
Откуда брать ID в справочникеПоле записи справочника, с которым сравнивается ID текущего элемента.
Откуда брать значение / названиеПоле записи справочника, которое надо вывести в результат.
Составлять полный путьВключается для режима "Путь разделов", если нужен путь от родительского раздела до текущего.
Откуда брать ID родителяПоле parent_id в той же записи справочника. Нужно только для полного пути.
Разделитель путиТекст между уровнями пути, например > или /.
Множественное значениеВключается, если в текущем поле несколько ID через разделитель.

Пример

ТоварСправочникНастройкаРезультат
category_id = 12id = 12, name = СтульяЗначение из справочникаСтулья
category_id = 12id = 12, parent_id = 3, name = Стулья; id = 3, name = МебельПуть разделов + полный путьМебель > Стулья
category_ids = 12;15Категории с ID 12 и 15Множественное значение, разделитель ;Стулья;Столы

Если совпадение не найдено

Если ID не найден в справочнике или справочник настроен не полностью, сервис оставляет исходное значение. Это помогает не потерять данные при неполном справочнике поставщика.

Что проверить

  • ID текущего элемента и ID справочника должны быть в одном формате: например, оба 12, а не 12 и cat-12.
  • Поля ID, parent_id и названия должны относиться к одной записи справочника.
  • Для полного пути обязательно укажите поле ID родителя.
  • Для нескольких ID включите Множественное значение и проверьте разделитель.
  • Эта настройка не является справочником свойств сводного каталога. Она читает справочник из исходного файла или таблицы.