Проверить шаблон документа и обязательные поля
Робот «Проверить шаблон документа и обязательные поля». Проверяет доступность активного шаблона, явную привязку и наличие полей для выбранной CRM-сущности.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Для администратора генерации документов, проверяющего шаблон до использования. Позволяет обнаружить неактивный шаблон, неверную привязку или отсутствие нужных описаний полей до последующей генерации.
Что подготовить
Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.
Параметры и значения
| Поле в настройке | Тип | Обязательность и исходное значение |
|---|---|---|
| ID шаблона | Целое число | Обязательное; значение по умолчанию не задано |
| Тип CRM-сущности | Целое число | Обязательное; значение по умолчанию не задано |
| ID CRM-сущности | Целое число | Обязательное; значение по умолчанию не задано |
| Точная привязка шаблона | Строка | Обязательное; значение по умолчанию не задано |
| Обязательные имена полей JSON | Текст | Обязательное; значение по умолчанию не задано |
Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.
Как использовать пошагово
- Укажите ID шаблона, тип и ID конкретной CRM-сущности.
- Передайте точную привязку из настроек шаблона, например
2_category_0только если именно она подходит выбранному объекту. - Перечислите до 50 обязательных имён полей JSON-массивом. Используйте реальные имена полей шаблона.
- Проверьте состояние
usable,unusableилиunknown, а также причины и отсутствующие поля. - Продолжайте с этим шаблоном только после положительного результата нужных проверок.
Учебный пример и ожидаемый результат
Для учебного шаблона 100 и сделки 900 указаны его фактическая привязка и обязательное поле DocumentNumber. При активном доступном шаблоне и наличии описания этого поля соответствующие проверки могут дать положительный результат. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.
Какие результаты передать дальше
- ID шаблона: целое число.
- Указанные проверки пройдены: да/нет (Y/N).
- usable/unusable/unknown: строка.
- Причины: строка, список.
- Отсутствующие поля: строка, список.
В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.
Ограничения и исправление ошибок
Привязка сравнивается точно; её соответствие бизнес-категории выбирает автор процесса. Пропуск активности, удаления или привязок даёт неизвестность. Наличие описания поля не означает проверку картинки, заполненность всех значений или гарантию успешного создания документа.
Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.
Как заполнять JSON-поля
Каждый блок ниже вставляется целиком в своё поле. Не добавляйте внешние кавычки вокруг всего массива или объекта. Учебные ID и названия замените фактическими данными.
Обязательные имена полей JSON
[
"DocumentNumber"
]
Массив до 50 строк с точными именами полей шаблона для выбранной сущности. DocumentNumber приведён как пример: используйте его только если поле действительно существует в вашем шаблоне. Имена берите из описания полей генератора, а не из визуальной подписи в PDF. [] означает отсутствие дополнительных требований к именам полей; объект {} вместо массива неверен.