Проверить заполнение заданных полей

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

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

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

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

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

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

Поля задаются JSON-массивом кодов, например ["title","UF_CRM_123"]. Числовой ноль и «Нет» считаются заполненными. Неизвестное или отсутствующее в ответе поле вызывает ошибку проверки.

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

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

Составьте JSON-массив исходных кодов проверяемых полей. Выберите реальный тип и ID карточки; названия полей в интерфейсе не заменяют их коды.

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

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

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

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

Поле в настройках	Что передать	Обязательность и исходное значение
Тип CRM: 1 — лид, 2 — сделка, 3 — контакт, 4 — компания, 31 — счёт, ID смарт-процесса (ENTITY_TYPE_ID)	Формат: целое число.	Обязательно. Значение по умолчанию в настройках не задано
ID элемента CRM (ITEM_ID)	Формат: целое число.	Обязательно. Значение по умолчанию в настройках не задано
Массив кодов проверяемых полей в JSON (FIELDS)	Формат: текст.	Обязательно. Значение по умолчанию в настройках не задано

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

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

• Тип CRM: 1 — лид, 2 — сделка, 3 — контакт, 4 — компания, 31 — счёт, ID смарт-процесса (ENTITY_TYPE_ID): 2.
• ID элемента CRM (ITEM_ID): 501.
• Массив кодов проверяемых полей в JSON (FIELDS): ["title","UF_CRM_DELIVERY_NOTE"].

Массив кодов проверяемых полей в JSON (FIELDS)

Копируйте в это поле только содержимое блока, без названия поля и внешней обёртки со всеми настройками. Здесь нужен JSON-массив в квадратных скобках. Пустой массив [] означает отсутствие элементов; объект {} его не заменяет. Учебные ID замените реальными ID выбранных карточек, дел, шаблонов или сотрудников; их можно передать из результатов предыдущего поиска. Коды полей берите из настроек вашей CRM. Элементы массива являются строками с кодами полей. title и opportunity относятся к имени и сумме в показанном примере. Пользовательские коды получите из настроек нужной сущности; подпись поля в интерфейсе не заменяет код. Пустой список не задаёт набор для проверки или снимка.

[
  "title",
  "UF_CRM_DELIVERY_NOTE"
]

Если название заполнено, а заметка о доставке пуста, итог покажет незаполненную заметку и отсутствие полноты. Это проверка наличия выбранных значений, а не подтверждение их смысла или согласования клиентом.

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

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

В ветке «Все поля заполнены» продолжите согласование, а список пропущенных полей передайте менеджеру в задачу. Смысловую полноту заявки проверяйте отдельно, если для решения важен текст, а не только наличие значения.

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

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