Возвращает список документов текущей сущности с ключевыми полями.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Робот полезен для менеджера, собирающего документы карточки, где уже идёт процесс. Документы нужно передать на проверку без ручного поиска по каждому номеру. Робот использует текущий CRM-элемент и возвращает доступный перечень документов с их реквизитами.
Что делает и когда применять
Робот нужен, когда требуется получить полный список документов по текущей сущности для последующей обработки.
Что подготовить
Нужен установленный робот из приложения «CRM роботы 2.0 + AI» и право на настройку автоматизации нужной CRM-воронки или шаблона бизнес-процесса. Пользователю, от имени которого работает приложение, должны быть доступны выбранные CRM-элементы и нужное действие с ними.
Проверьте контекст запуска. Параметры не задаются; в списке будут документы текущей сущности, а не всех связанных заказов или всех файлов её таймлайна.
Как настроить и использовать
- Откройте автоматизацию нужной сущности и выберите стадию, на которой нужен робот «Список документов текущей сущности». В шаблоне бизнес-процесса добавьте одноимённое действие.
- Проверьте контекст запуска. Параметры не задаются; в списке будут документы текущей сущности, а не всех связанных заказов или всех файлов её таймлайна.
- Проверьте контекст текущего CRM-документа. Отдельных входных параметров у этого действия нет; оно читает карточку, в которой запущено.
- Сохраните действие и укажите, какие его результаты будут использованы в следующих условиях или полях процесса.
- Выполните пробный запуск на отдельном учебном элементе. Проверьте статус и возвращённые данные; если действие не завершилось, разберите ошибку в журнале процесса до использования результата.
Параметры робота
Имена полей ниже совпадают с настройками действия. Значения из таблицы относятся к самому роботу; результаты предыдущих шагов выбирайте через подстановку значения в редакторе.
Отдельных входных полей нет. Действие использует текущий CRM-элемент.
Учебный пример
Пример показывает способ настройки на вымышленных данных и ожидаемый смысл результата; это не отчёт о запуске на вашем портале.
Добавьте действие в учебную карточку нужной сущности и проверьте возвращённые значения.
Если текущая карточка содержит договор и акт, результаты включат обе записи и их количество. Номер, название и ID шаблона полезны для проверки назначения документа до его дальнейшей передачи.
Какие данные возвращает и что делать дальше
| Результат | Какое значение получает следующий шаг |
|---|---|
ID документов (documentIds) |
целое число, несколько значений |
Номера документов (numbers) |
строка, несколько значений |
Названия документов (titles) |
строка, несколько значений |
Ссылки на скачивание (downloadUrls) |
строка, несколько значений |
ID шаблонов документов (templateIds) |
целое число, несколько значений |
Количество документов (documentsCount) |
целое число |
Статус выполнения (status) |
да/нет |
Используйте «ID документов» для отдельного получения файла или состояния. Ссылки и реквизиты не следует публиковать без проверки доступа и принадлежности нужному заказу.
Ошибки и ограничения
Проверяйте результат действия до следующего изменения карточки. Ошибка доступа, неверный идентификатор и отсутствие найденного элемента требуют разных веток процесса. Не подставляйте нулевой или пустой результат как идентификатор существующего документа.