Сколько документов в выбранной сущности

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

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

Робот полезен для координатора документов, который проверяет выбранную CRM-карточку. Перед следующим шагом нужно узнать, созданы ли документы у конкретной сущности. Робот возвращает число доступных документов по явно указанным типу и ID, без ручного открытия карточки.

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

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

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

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

Укажите тип CRM и ID нужной карточки. Не путайте ID сущности с ID отдельного документа генератора. Количество относится к созданным документам, а не к любым файлам на Диске.

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

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

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

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

Поле в настройках	Что передать	Обязательность и исходное значение
ID типа сущности (entityTypeId)	Формат: целое число.	Обязательно. Значение по умолчанию в настройках не задано
ID сущности (entityId)	Формат: целое число.	Обязательно. Значение по умолчанию в настройках не задано

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

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

• ID типа сущности (entityTypeId): 2.
• ID сущности (entityId): 501.

Если у учебной сделки есть два доступных документа, результат count равен 2. Это не подтверждает их подписание или оплату. При успешном пустом поиске число равно нулю.

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

Результат	Какое значение получает следующий шаг
Количество документов (count)	целое число
Статус выполнения (status)	да/нет

Используйте «Количество документов» в условии существования. Для выбора конкретного договора или счёта дополнительно получите список или последний документ нужного шаблона.

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

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