Проверить готовность доступного дерева подзадач

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

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

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

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

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

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

Настройки робота

Поле	Тип и значение
ID задачи	Обязательное положительное целое число: корень проверки.
Максимальная глубина	Обязательное целое число от 1 до 10, по умолчанию 3. Один уровень: непосредственные подзадачи.
Допустимые статусы: JSON	Обязательный непустой массив кодов от 1 до 7, по умолчанию [5].

Для обычной проверки завершения оставьте [5]. Среди используемых статусов: 2: ждёт выполнения, 3: выполняется, 4: ожидает контроля, 5: завершена, 6: отложена, 7: отклонена. Если ваша приёмка допускает ожидание контроля, явно задайте [4,5]. Не включайте незавершённый статус только ради получения положительного результата.

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

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

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

У родителя 410 есть подзадачи 411 и 412, а у 412: подзадача 413. Для глубины 2 и допустимых статусов [5] проверяются три подзадачи. Если 411 и 413 завершены, а 412 выполняется, ожидаются количество 3, отрицательная готовность и ID 412 среди неготовых. После завершения 412 следующий запуск даст положительный результат, если доступная структура не изменилась. Числа условные.

Результаты для следующего шага

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

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

Дерево свыше 1000 подзадач или обнаруженная вложенность глубже выбранного предела приводят к ошибке, а не к усечённому положительному ответу. Увеличьте глубину в пределах 10 либо разделите проверку на несколько ветвей. Повторы или циклы в полученной структуре также останавливают проверку. Результат отражает прочитанные статусы на момент запуска; он не блокирует дальнейшее изменение задач другими пользователями.

Как заполнять JSON-поля

Каждый блок ниже вставляется целиком в своё поле. Не добавляйте внешние кавычки вокруг всего массива или объекта. Учебные ID и названия замените фактическими данными.

Допустимые статусы: JSON

[
  5
]

Непустой JSON-массив числовых кодов 1–7. В примере разрешены только завершённые подзадачи, код 5. Для готовности с ожиданием контроля можно явно выбрать [4,5], если так устроена ваша приёмка. Это коды статусов, а не ID задач или сотрудников. По умолчанию [5]; [] и {} не подходят.