Преобразования значений

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

Что это

Преобразования меняют выбранное значение перед выгрузкой: убирают лишние символы, заменяют текст, считают цену, заполняют пустые значения или очищают одно поле.

Коротко

Откройте настройки значения, которое хотите изменить, найдите блок Преобразования и нажмите Добавить правило. Правило задаёт, какое значение проверить, когда оно должно сработать и что сделать.

Правила работают одинаково независимо от того, откуда пришли данные. Отличается только экран, на котором вы открываете значение. Ниже показаны три варианта результата без лишней терминологии. price, stock и Debit — названия из примеров; ваши поля могут называться иначе.

Где открыть преобразования

Табличный редактор

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

Анимация открытия окна преобразований в табличном редакторе
Клик по настройкам столбца price открывает реальное окно столбца с блоком "Преобразования".

XML-снапшот

В XML-снапшоте наведите курсор на нужное значение внутри структуры, например текст между тегами <section_path> и </section_path>, и нажмите его. Откроется окно настроек значения, а результат преобразования отразится прямо в снапшоте.

Анимация открытия окна преобразований в XML-снапшоте
Клик по значению XML-снапшота открывает настройки значения, где можно добавить правило преобразования.

JSON-редактор

В JSON-редакторе выберите ключ или значение в дереве результата. Настройки открываются для выбранного блока JSON.

Анимация открытия окна преобразований в JSON-редакторе
Клик по JSON-полю открывает то же окно преобразований для выбранного значения.

Сводный каталог

В сводном каталоге преобразование открывается из привязки поля каталога. Нажмите на выбранное поле, например "Наименование [NAME]" или "Артикул [SKU]", и откройте настройки значения.

Анимация открытия окна преобразований в сводном каталоге
Клик по полю сводного каталога открывает то же окно настроек с блоком "Преобразования".

Подробнее об этих экранах: результат в виде таблицы, результат JSON и результат XML.

Как устроено правило

Одна строка в блоке Преобразования отвечает на три вопроса:

  1. Какое значение проверить. Обычно это Текущее значение. При необходимости можно выбрать другое исходное поле.
  2. Когда выполнить действие. Например, Любое, Пустое, Равно или Содержит подстроку.
  3. Что сделать. Например, Убрать пробелы по краям, Заменить на, Удалить подстроку, Увеличить на % или Округлить.

Простой пример очистки текста: Текущее значениеЛюбоеУбрать пробелы по краям. Значение   Настольная лампа   станет Настольная лампа.

После настройки нажмите Сохранить.

Ниже показан отдельный пример: два правила для Debit. Он нужен, чтобы показать порядок нескольких правил, а не предыдущую очистку пробелов.

Два последовательных правила преобразования значения Debit в Eofferix
На примере Debit видно: правила выполняются сверху вниз, а кнопки со стрелками меняют их порядок.

Почему порядок правил важен

Текущее значение меняется после каждой сработавшей строки. Например, сначала примените Убрать пробелы по краям, затем Схлопнуть двойные пробелы, а после этого Удалить подстроку. Расставьте правила в нужном порядке кнопками со стрелками вверх и вниз.

Если нужно проверить исходное значение, которое ещё не менялось, выберите исходное поле, а не Текущее значение. Как использовать соседние поля, описано в статье Значения из других полей в преобразованиях.

Что можно сделать

ЗадачаПодходГотовый пример
Очистить текстУбрать пробелы по краям, Схлопнуть двойные пробелы, Удалить подстроку или Удалить HTML-теги.Очистка артикула
Привести разные обозначения к одномуПроверить значение через Равно или Содержит подстроку и применить Заменить на.Нормализация остатка
Добавить текст к значениюДобавить в начало или Добавить в конец, не меняя исходную часть.Префикс и суффикс для артикула
Заполнить пустое значениеПустоеЗаменить на → значение по умолчанию.Значение по умолчанию
Пересчитать ценуУвеличить на %, Прибавить, Вычесть, Умножить или Округлить.Наценка и округление
Разнести сумму по двум значениямПроверить знак через Меньше или равно и Больше или равно, очистить через Не загружать поле, затем применить Удалить подстроку.Credit и Debit

Полный список условий и примеры их применения находятся в статье Условия правил преобразования.

Изменить значение или исключить запись целиком

Преобразование работает с выбранным значением. Действие Не загружать поле очищает только это значение и завершает его цепочку; строка таблицы, JSON-объект или XML-запись остаётся.

Если нужно решить, выгружать ли поле, строку или элемент целиком, используйте отдельный блок Условия выгрузки. Разница и области действия описаны в статье Условия выгрузки. Практический пример удаления всей записи: нулевая цена или пустой остаток.