Преобразование значения - это правило, которое меняет выбранное поле перед выгрузкой результата. Источник при этом не переписывается: меняется только итоговый XML, JSON, таблица или данные, которые уходят в сводный каталог.
Правило читается как короткая фраза: если выбранное значение подходит под условие, выполнить действие и получить новый результат. Если условие не подходит, правило пропускается и значение идет дальше без изменений.
Как выглядит правило
В окне настройки поля есть блок "Преобразования". В нем можно добавить одно правило или цепочку из нескольких правил.
Из чего состоит строка
Что проверяем
Первый выбор отвечает за то, какое значение проверять. Чаще всего это "Текущее значение", то есть то поле, которое вы сейчас настраиваете. В сложных профилях можно проверять другое поле той же строки, товара или элемента.
Когда применять
Условие отвечает за момент срабатывания: всегда, только если значение пустое, только если содержит нужный текст, только если число больше заданного значения и так далее. Подробный список условий вынесен в статью "Условия в преобразованиях".
Что искать или с чем сравнивать
Поле "Значение" рядом с условием используется для сравнения. Например, для условия "содержит" сюда пишут фрагмент текста, который нужно найти. Для условий "любое", "пустое" и "не пустое" это поле не нужно.
Что сделать
Действие меняет значение: заменить, удалить фрагмент, добавить текст, привести регистр, очистить HTML, преобразовать дату, посчитать цену или не загружать значение. Подробное поведение действий описано в статье "Действия преобразований".
Что получится
Последнее поле задает новый текст, число или настройку действия. Например, для "заменить на" это новый текст, для "умножить" это множитель, для "увеличить на %" это процент.
Как работает цепочка правил
Правила выполняются сверху вниз. Результат первого правила становится входом для второго. Поэтому порядок важен.
| Задача | Хороший порядок | Почему так |
|---|---|---|
| Убрать лишние пробелы и добавить префикс | Сначала "схлопнуть пробелы", потом "убрать пробелы по краям", потом "добавить в начало" | Префикс добавится уже к чистому значению. |
| Посчитать цену с наценкой | Сначала очистить число, потом "увеличить на %", потом "округлить" | Математика должна получать число, а округление лучше делать в конце. |
| Не выгружать пустые значения | Сначала проверить пустоту, потом использовать "не загружать" | Иначе можно сначала изменить значение, а потом проверять уже измененный результат. |
Где применяются преобразования
- XML-редактор: к тексту элемента, атрибуту или собранному значению.
- JSON-редактор: к значению поля, объекта или элемента массива.
- Табличный редактор: к значению ячейки или колонки в CSV, XLS и XLSX.
- Сводный каталог: к данным перед записью в поля товаров, предложений, разделов, цен и остатков.
Когда использовать не преобразование, а условие выгрузки
Преобразование меняет значение. Условие выгрузки решает, попадет ли поле, строка, товар или элемент в результат. Если нужно убрать весь товар с нулевой ценой, лучше настраивать условие выгрузки для элемента целиком. Если нужно только очистить поле цены, используйте преобразование значения.
Как проверить результат
- Сохраните настройки поля.
- Откройте предпросмотр или тестовый запуск профиля.
- Найдите 2-3 строки: обычную, пустую и строку с необычным значением.
- Проверьте не только измененное поле, но и то, не исчезла ли вся строка или элемент.
- Если результат неожиданный, временно оставьте одно правило и проверьте его отдельно.