Проверить значение для поля CRM

Проверяет тип, множественность и варианты списка до попытки записать значение в карточку.

Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.

Для кого и какую проблему решает

Робот полезен для интегратора, проверяющего внешнее значение до записи в CRM. Ошибка формата обнаруживается лишь на шаге изменения карточки, и цепочка обрывается. Робот заранее проверяет тип, множественность и допустимые варианты конкретного поля.

Что делает и когда применять

Проверяет тип, множественность и варианты списка до попытки записать значение в карточку.

Возвращает результат проверки и причину отказа. Не изменяет поле. Не проверяет права записи, существование связанных элементов и все бизнес-ограничения карточки. Поддерживаются строки, текст, ссылки, числа, Да/Нет, даты ISO, списки и простые привязки. Файлы и составные поля (включая телефоны и e-mail CRM) не изменяются. Код пользовательского поля указывайте в исходном виде UF_CRM_….

Что подготовить

Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.

Выберите существующее поле и передайте предполагаемое значение в JSON. Для числа нужен JSON-номер, для строки нужны кавычки; формат не должен зависеть от оформления в исходной системе.

Как настроить и использовать

1. Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Проверить значение для поля CRM». В шаблоне бизнес-процесса добавьте одноимённое действие.
2. Выберите существующее поле и передайте предполагаемое значение в JSON. Для числа нужен JSON-номер, для строки нужны кавычки; формат не должен зависеть от оформления в исходной системе.
3. Заполните Тип CRM: 1 — лид, 2 — сделка, 3 — контакт, 4 — компания, 31 — счёт, ID смарт-процесса, Код поля: title, TITLE или UF_CRM_…, Значение в JSON: "текст", 12, false или массив. Для рабочего сценария подставьте значения полей документа или результаты предыдущих действий вместо учебных данных ниже.
4. Проверьте обязательные поля и варианты выбора в таблице настроек. Сохраните действие и свяжите его результаты с дальнейшими условиями процесса.
5. Выполните пробный запуск на отдельном учебном элементе. Сначала проверьте статус и пояснение ошибки, затем содержательный результат и ветку, выбранную следующим действием.

Параметры робота

Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.

Поле в настройках	Что передать	Обязательность и исходное значение
Тип CRM: 1 — лид, 2 — сделка, 3 — контакт, 4 — компания, 31 — счёт, ID смарт-процесса (ENTITY_TYPE_ID)	Формат: целое число.	Обязательно. Значение по умолчанию в настройках не задано
Код поля: title, TITLE или UF_CRM_… (FIELD)	Формат: строка.	Обязательно. Значение по умолчанию в настройках не задано
Значение в JSON: "текст", 12, false или массив (VALUE)	Формат: текст.	Обязательно. Значение по умолчанию в настройках не задано

Учебный пример

Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.

• Тип CRM: 1 — лид, 2 — сделка, 3 — контакт, 4 — компания, 31 — счёт, ID смарт-процесса (ENTITY_TYPE_ID): 2.
• Код поля: title, TITLE или UF_CRM_… (FIELD): UF_CRM_PIECES.
• Значение в JSON: "текст", 12, false или массив (VALUE): 12.

Значение в JSON: "текст", 12, false или массив (VALUE)

Копируйте в это поле только содержимое блока, без названия поля и внешней обёртки со всеми настройками. Строковое JSON-значение пишется в двойных кавычках; число и true/false пишутся без кавычек. Выбирайте тип, совместимый с полем CRM. Это само новое или проверяемое значение, без объекта вида {"VALUE":...}. Для строкового поля нужен JSON-текст в кавычках, для числового число, для логического true/false, для множественного совместимый массив. Для поля-списка используйте ID существующего варианта, а не его подпись; ID можно получить отдельным поиском варианта.

12

Для числового поля целое значение 12 должно пройти проверку типа. Текст «двенадцать» для такого поля не подходит. Положительный вывод ещё не подтверждает права записи или все бизнес-ограничения карточки.

Какие данные возвращает и что делать дальше

Результат	Какое значение получает следующий шаг
Значение подходит (valid)	да/нет
Причина несоответствия (reason)	строка
Статус выполнения (status)	да/нет
Пояснение ошибки (error)	строка

Выполняйте запись отдельным действием только в ветке «Значение подходит». Причину несоответствия передайте сотруднику или в шаг исправления данных; этот робот само поле не меняет.

Ошибки и ограничения

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