Получить незавершённые задания процессов документа

Возвращает доступные пары «задание — исполнитель», по которым ещё ожидается действие.

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

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

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

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

Возвращает доступные пары «задание: исполнитель», по которым ещё ожидается действие.

Принимает DOCUMENT_ID: полный идентификатор документа из трёх строк в JSON, необязательные USER_IDS и LIMIT до 500 строк. Отбирает открытые задания и незавершённые назначения сотрудникам, сравнивая документ точно. Возвращает ID задания, строковый ID процесса, название, исполнителя, шаблон и срок, если он задан. deadlineKnown отличает известное отсутствие срока от неизвестного ответа. Одно задание разных сотрудников возвращается отдельными строками; это доступные назначения, а не гарантия списка всех участников. Пустой доступный поиск успешен. Более 5000 строк/неполное чтение: ошибка; усечение вывода и количество строк указаны отдельно.

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

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

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

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

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

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

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

Поле в настройках	Что передать	Обязательность и исходное значение
Полный идентификатор документа: JSON из трёх строк (DOCUMENT_ID)	Формат: текст.	Обязательно. Значение по умолчанию в настройках не задано
Исполнители: JSON ID, пусто — доступные (USER_IDS)	Формат: текст.	Необязательно. По умолчанию: []
Лимит строк вывода (LIMIT)	Формат: целое число.	Обязательно. По умолчанию: 100

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

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

• Полный идентификатор документа: JSON из трёх строк (DOCUMENT_ID): ["crm","CCrmDocumentDeal","DEAL_501"].
• Исполнители: JSON ID, пусто — доступные (USER_IDS): [].
• Лимит строк вывода (LIMIT): 100.

Полный идентификатор документа: JSON из трёх строк (DOCUMENT_ID)

Копируйте в это поле только содержимое блока, без названия поля и внешней обёртки со всеми настройками. Здесь нужен JSON-массив в квадратных скобках. Пустой массив [] означает отсутствие элементов; объект {} его не заменяет. Учебные ID замените реальными ID выбранных карточек, дел, шаблонов или сотрудников; их можно передать из результатов предыдущего поиска. Коды полей берите из настроек вашей CRM. Все три элемента являются строками в фиксированном порядке: модуль документа, класс документа, идентификатор документа. В учебном примере crm / CCrmDocumentDeal / DEAL_501 относится к сделке 501. Используйте идентификатор именно выбранного документа; одного числа 501 вместо массива недостаточно.

[
  "crm",
  "CCrmDocumentDeal",
  "DEAL_501"
]

Исполнители: JSON ID, пусто — доступные (USER_IDS)

Копируйте в это поле только содержимое блока, без названия поля и внешней обёртки со всеми настройками. Здесь нужен JSON-массив в квадратных скобках. Пустой массив [] означает отсутствие элементов; объект {} его не заменяет. Учебные ID замените реальными ID выбранных карточек, дел, шаблонов или сотрудников; их можно передать из результатов предыдущего поиска. Коды полей берите из настроек вашей CRM. Массив содержит положительные ID сотрудников, по которым нужны назначения. [] означает все доступные назначения выбранного документа, а не всех сотрудников без ограничения прав. Для ограничения одним человеком передайте, например, [17].

[]

Если одно задание ожидает двух сотрудников, результат может содержать две строки назначений и один уникальный ID задания. При отсутствии открытых доступных назначений успешный результат будет пустым. Усечённый вывод нельзя трактовать как полный список.

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

Результат	Какое значение получает следующий шаг
Уникальные ID заданий (taskIds)	целое число, несколько значений
Задания и исполнители: JSON (assignmentsJson)	текст
Возвращено назначений (count)	целое число
Вывод усечён (truncated)	да/нет
Статус выполнения (status)	да/нет
Пояснение ошибки (error)	строка

Передайте «Задания и исполнители: JSON» в задачу координатору. Срок используйте только с учётом признака его известности: неизвестный ответ и известное отсутствие срока различаются.

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

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