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

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

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


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

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

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