Проверить признаки готовности файла документа

Робот «Проверить признаки готовности файла документа». Показывает, подтверждают ли данные документа наличие DOCX или PDF, и отдельно отмечает ошибку или неизвестность.

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

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

Для координатора, который проверяет состояние сформированного документа перед следующим шагом. Отличает признаки готовности PDF или DOCX от ожидания преобразования и неполных данных.

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

Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.

Параметры и значения

Поле в настройке	Тип	Обязательность и исходное значение
ID документа	Целое число	Обязательное; значение по умолчанию не задано
Формат файла	Выбор из списка	Обязательное; значение по умолчанию не задано
Варианты поля «Формат файла»		docx: DOCX; pdf: PDF

Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.

Как использовать пошагово

1. Укажите ID уже сформированного документа.
2. Выберите формат PDF либо DOCX.
3. Разберите состояние: metadata_ready, pending, error или unknown.
4. Положительный признак готовности используйте как условие следующего шага, которому достаточно сведений генератора.
5. ID файла используйте только при положительном признаке его явного получения; ноль не является полноценным файловым ID.

Учебный пример и ожидаемый результат

У документа 500 для PDF явно указаны отсутствие ошибки преобразования и корректная защищённая ссылка. Ожидаются признаки готовности метаданных. Если ссылка явно пустая, состояние: ожидание, а не готовность. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.

Какие результаты передать дальше

• ID документа: целое число.
• В метаданных есть признаки готовности: да/нет (Y/N).
• metadata_ready/pending/error/unknown: строка.
• Причина состояния: строка.
• ID файла при наличии: целое число.
• ID файла явно получен: да/нет (Y/N).

В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.

Ограничения и исправление ошибок

Робот не открывает и не возвращает ссылку, не проверяет доступность скачивания и байты файла. Преобразование не запускает и готовности не ждёт. Пропуски полей не считаются ложными значениями; неполные или противоречивые сведения дают неизвестное состояние.

Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.