Робот «Значение свойства товара и разделы каталога» по товарным позициям в элементе CRM возвращает значение выбранного свойства и раздел каталога (текущий и верхний). Если у позиции с торговым предложением значение пустое, подставляется значение с основного товара.
Для кого и какую задачу решает
Администратору CRM и автору документов, который читает одно свойство товаров всех строк выбранной карточки и разделы основных товаров.
Характеристика может быть заполнена у вариации или только у родителя. Робот сначала читает товар строки, а при пустом значении берёт свойство основного товара. Это удобно для общего свойства модели, которое не повторяется в каждой вариации.
Параметры и подготовка
| Поле | Как заполнить |
|---|---|
ID элемента (entityId) |
Обязательное поле |
ID инфоблока каталога (idIblock) |
Необязательное поле |
Код или числовой идентификатор свойства (codeField) |
Обязательное поле |
Перед настройкой выберите, откуда процесс получит каждое значение: постоянная настройка, поле карточки или результат предыдущего шага. Подписи в таблице соответствуют полям робота. Коды в скобках помогают различать похожие параметры при передаче данных между шагами.
Как использовать
- Укажите entityId карточки соответствующего типу процесса. Получите ID из текущего элемента либо явного предыдущего шага.
- В форме выберите каталог и код свойства. Допустим код или числовой ID свойства; не используйте пользовательскую подпись вместо кода.
- После выполнения читайте параллельные списки valueField и разделов по одинаковым позициям. Строки без связанного доступного товара могут быть пропущены.
- Если свойство вариации пустое, учтите подстановку значения родителя. Для чтения только самой вариации без такой подстановки выберите отдельный робот свойства предложения.
Учебный пример и ожидаемый результат
В учебной карточке строка относится к вариации 701, у которой свойство пустое, а у основного товара 500 оно равно «Модель А». Ожидается «Модель А» в соответствующей позиции valueField. Раздел и верхний раздел берутся у основного товара. При заполненном свойстве вариации возвращается её собственное значение.
Пример показывает подготовленные учебные данные. Фактический результат зависит от переданных значений и доступных данных вашего процесса.
Что возвращает и как продолжить процесс
- «Значения свойства по строкам товара» (
valueField), список значений. - «ID раздела основного товара» (
sectionId), список значений. - «Название раздела основного товара» (
sectionName), список значений. - «ID верхнего раздела в иерархии» (
topSectionId), список значений. - «Название верхнего раздела в иерархии» (
topSectionName), список значений.
Каждый выход свойства и разделов является списком, даже для одной обработанной позиции. sectionId/sectionName описывают непосредственный раздел, topSectionId/topSectionName верхний раздел иерархии. Сохраняйте соответствие списков при использовании итератора.
Выход «Статус выполнения» проверяйте перед передачей результата дальше. При отрицательном статусе прочитайте «Текст ошибки» и направьте процесс на исправление исходных данных. Успешный статус подтверждает выполнение действия; содержательные признаки результата проверяйте отдельно.
Ограничения и разбор ошибок
Читаются строки карточки соответствующего контексту типа CRM. Значение сначала с товара строки, при пустом значении с родителя. Разделы с основного товара. Результаты параллельными списками; свободные строки и недоступные связанные товары пропускаются. Параметр каталога нужен настройке выбора свойства, не задаёт отдельный поиск товаров.
Робот не пишет свойства и не переносит товары между разделами. Пустое свойство не всегда ошибка: при отсутствии значения у товара и родителя возвращается пустая строка. Проверьте доступ и корректный код свойства, если ожидалось заполненное значение.