Получить руководителей выбранного подразделения

Активити (робот) «Получить руководителей выбранного подразделения» предназначено для использования в роботах и может быть полезно в следующих сценариях: когда нужно по одному или нескольким подразделениям получить список руководителей (пользователей) и передать их идентификаторы в согласования, задачи или уведомления.

Результат формируется запросом к REST-методу im.department.managers.get.
В запросе подробные карточки пользователей не запрашиваются: активити собирает только идентификаторы руководителей.
Список ID в результате уникален, отсортирован по возрастанию числового значения.

Как работает активити (робот):
- Вы указываете ID подразделений и при необходимости Формат получения данных;
- Активити вызывает метод и объединяет руководителей по выбранным подразделениям в один набор ID;
- При успехе возвращаются массив, строка, первый и последний ID в выбранном формате;
- Если подразделения не указаны, список руководителей пуст или ответ API с ошибкой, активити завершится с ошибкой или вернёт признак неуспеха в зависимости от ситуации.

Сценарий работы активити бизнес-процесса

Типичная цепочка: указать ID отделов из оргструктуры, получить значения параметра "Результат поиска (массив для итератора)" или "Результат поиска (строка)", проверить параметр "Успех выполнения операции", затем назначить согласование или задачу руководителям.

Описание параметров активити (робота)

Название поля	Описание и примеры использования
ID подразделений	Один или несколько идентификаторов подразделений через запятую. Пробелы вокруг запятой допускаются. Пример: 2,9 Поле должно быть заполнено, иначе активити завершится с ошибкой «Не указаны ID подразделений».
Формат получения данных	Определяет вид значений в результатах. Число (1,2,3) — в массиве и строке возвращаются числовые ID пользователей. Пользователь (user_1,user_2,user_3) — те же ID в виде строк с префиксом user_, удобно для роботов, где ожидается формат пользователя.

Название поля

Описание и примеры использования

ID подразделений

Один или несколько идентификаторов подразделений через запятую.
Пробелы вокруг запятой допускаются.

Пример: 2,9
Поле должно быть заполнено, иначе активити завершится с ошибкой «Не указаны ID подразделений».

Формат получения данных

Определяет вид значений в результатах.

Число (1,2,3) — в массиве и строке возвращаются числовые ID пользователей.
Пользователь (user_1,user_2,user_3) — те же ID в виде строк с префиксом user_, удобно для роботов, где ожидается формат пользователя.

Состав руководителей зависит от данных оргструктуры и прав приложения.
При ошибке REST текст смотрите значение параметра "Сообщение об ошибке".
Если по указанным подразделениям руководителей нет, активити завершится с ошибкой «Список пуст».

Примеры использования активити

Описание примера	Решение
Один отдел: согласование с руководителем	ID подразделений = 6, Формат получения данных = Пользователь (user_1,user_2,user_3). Подставьте search_result_first_string в шаг согласования.
Несколько отделов: объединённый список руководителей	ID подразделений = 4,5,11, Формат получения данных = Число (1,2,3). Один человек не дублируется, если числится в нескольких выбранных отделах.
Массовая задача всем руководителям из выборки	Формат получения данных = Число (1,2,3). Используйте параметр "Результат поиска (массив для итератора)" как источник для итератора или множественного назначения.
Строка ID для интеграции	Формат получения данных = Число (1,2,3). Передайте параметр "Результат поиска (строка)" во внешний вебхук.
Сравнить с ответственным по сделке	Формат получения данных = Число (1,2,3). Проверьте вхождение {=Document:ASSIGNED_BY_ID} в параметре "Результат поиска (массив для итератора)".
Остановка при отсутствии руководителей	После шага проверьте параметры "Успех выполнения операции" = Y и "Количество найденных элементов" больше нуля перед рассылкой.
Комментарий: сколько руководителей найдено	Запишите текст «Руководителей: » и значение параметра "Количество найденных элементов" в комментарий к задаче.
Последний ID в отсортированном списке	Формат получения данных = Число (1,2,3). Используйте параметр "Последний результат поиска" как наибольший ID в выборке.
ID отделов из переменной процесса	ID подразделений = {=Variable:DEPT_LIST} (строка с числами через запятую). Убедитесь, что переменная не пустая.
Формат user для уведомлений портала	Формат получения данных = Пользователь (user_1,user_2,user_3). Значения из параметра "" подходят для шагов с типом пользователь в формате user_ID.

Возвращаемые параметры данного активити:
- Успех выполнения операции — признак успешного результата (Y при непустом списке ID);
- Количество найденных элементов — количество найденных подразделений в виде числового значения;
- Результат поиска (массив для итератора) — массив числовых ID подразделений;
- Результат поиска (строка) — те же ID в одной строке через запятую;
- Первый результат поиска — первый ID в массиве результатов;
- Последний результат поиска — последний ID в массиве результатов;
- Сообщение об ошибке — служебное сообщение по результату выполнения шага.

Важно о возвращаемых параметрах: отдельного поля «текст ошибки API» нет: при сбое REST детали смотрите в результатах параметра "Сообщение об ошибке".
Если не заполнены ID подразделений или список руководителей пуст, процесс уйдёт в ветку ошибки активити.

Ваша корзина пуста

Получить руководителей выбранного подразделения