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