Получить дерево подчинённых подразделений
Робот «Получить дерево подчинённых подразделений». Возвращает доступные дочерние отделы и пути к ним для выбора сотрудников процесса.
Видимая часть формы настройки в Битрикс24. Скриншот показывает поля действия; он не подтверждает выполнение учебного примера.
Для кого и какую проблему решает
Для администратора распределения работ и руководителя крупного подразделения. Собирает подчинённые отделы и пути к ним, чтобы не перечислять изменяющуюся структуру вручную.
Что подготовить
Установите действие в каталоге приложения «CRM роботы 2.0 + AI», затем добавьте его в нужную точку автоматизации. Для чтения или изменения объектов нужен соответствующий доступ пользователя подключения. Идентификаторы берите из полей карточки или результатов предыдущих шагов: название объекта не заменяет его числовой ID.
Параметры и значения
| Поле в настройке | Тип | Обязательность и исходное значение |
|---|---|---|
| ID корневого подразделения | Целое число | Обязательное; значение по умолчанию не задано |
| Максимальная глубина | Целое число | Обязательное; по умолчанию 10 |
Поля, обозначенные JSON, заполняйте корректными массивами или объектами с двойными кавычками в строках. Подставляйте одно значение через штатный выбор данных редактора; не копируйте служебный идентификатор шага из другого шаблона.
Как использовать пошагово
- Укажите корневое подразделение, подчинённые отделы которого нужно получить.
- Выберите глубину от 1 до 50, по умолчанию 10.
- После чтения используйте список ID подчинённых отделов в последующем поиске сотрудников.
- Если в дальнейшей выборке нужен сам корень, добавьте его отдельно: результат этого робота его не включает.
- Проверьте признак отделов за границей глубины и при необходимости увеличьте предел.
Учебный пример и ожидаемый результат
У отдела 10 есть дочерний 11, у него: 12. При глубине 2 ожидаются ID 11 и 12 с путями от корня, без самого отдела 10. При глубине 1 наличие доступного отдела 12 будет отмечено сокращением. Все номера объектов в примере условные; замените их данными своего портала. Пример объясняет настройку, а не подтверждает выполненный запуск.
Какие результаты передать дальше
- Дерево в формате JSON: строка.
- ID подчинённых отделов: целое число, список.
- Количество отделов: целое число.
- Есть отделы за границей глубины: да/нет (Y/N).
В следующем действии откройте выбор данных и выберите результат этого робота по названию. Сначала проверьте статус выполнения; при ошибке передайте её пояснение на разбор и не используйте пустые значения как подтверждённый результат. Успех шага и положительный ответ на бизнес-проверку: разные условия.
Ограничения и исправление ошибок
До 1000 отделов. Отказ чтения, цикл или превышение количества являются ошибкой. Невидимые приложению подразделения и команды вне структуры не обнаруживаются. Действие не меняет структуру и не гарантирует актуальность списка после последующих организационных правок.
Если доступ изменился, сначала проверьте объект под пользователем подключения и актуальность ID. Повторяйте действие после устранения причины. Для действий с записью предварительно сверяйте фактическое состояние: сообщение об ошибке само по себе не доказывает, что ни одна правка не сохранилась.