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