Добавить значение в множественное поле
Робот «Добавить значение в множественное поле» дописывает новое значение в множественное поле CRM-сущности (сделки, контакта, компании или лида) в бизнес-процессах и роботах Битрикс24, не затирая уже имеющиеся значения. По умолчанию дубликаты не добавляются. Возвращает признак «Успешно» Y/N и итоговое количество элементов в поле.
Робот добавляет одно значение в множественное поле CRM-сущности, сохраняя все ранее введённые значения — в отличие от обычного обновления поля, которое перезаписывает список целиком. На вход подаются тип сущности (deal, contact, company или lead), её ID, код поля (например UF_CRM_TAGS или PHONE) и добавляемое значение; флаг «Не добавлять если уже есть» (по умолчанию Y) предотвращает повторы. Типовые случаи применения: дописать тег к сделке при наступлении события; добавить дополнительный телефон контакту, не теряя основной; накапливать значения в пользовательском множественном поле по ходу процесса. Если сущность не найдена или параметры неверны, возвращается «Успешно» = N. Возвращает «Успешно» Y/N и итоговое количество элементов в поле — используйте их на следующих шагах бизнес-процесса.
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| Тип сущности: deal / contact / company / lead | string | да | |
| ID сущности | int | да | |
| Код поля (например UF_CRM_TAGS или PHONE) | string | да | |
| Добавляемое значение | string | да | |
| Не добавлять если уже есть (Y/N, по умолчанию Y) | string | — |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Успешно (Y/N) | string |
| Итоговое количество элементов в поле | int |
Сценарий: пометка сделки тегом при оплате
- Сделка переходит на стадию «Оплачено»
- Робот добавляет значение «оплачено» в множественное поле тегов сделки
- При «Успешно» = Y процесс продолжается, итоговое количество элементов учитывается дальше