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

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

Результат формируется запросом к REST-методу im.department.colleagues.list.
В запросе используется ограничение выборки до 50 записей за один вызов.
Пользователь, для которого запрашиваются коллеги, определяется контекстом запуска робота (от чьего имени выполняется действие), а не полями этой формы.

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

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

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

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

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

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

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

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

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

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

Список строится по данным портала и правам REST; если метод вернёт ошибку, в служебном поле лога будет текст с префиксом ошибки и описанием ответа сервера. Количество записей в одном ответе не превышает 50.

Если пользователь состоит в 2 подразделениях и более, то активити выдает ID сотрудников подразделения, которое помечено "Ваше подразделение" у него самого, при этом ID сотрудников второго подразделения - в возвращаемых параметрах не будет.
Это ограничение со стороны REST Api Б24.

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

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

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

Важно о возвращаемых параметрах: отдельного поля с текстом ошибки REST в этом активити нет; при сбое запроса детали попадают в значения параметра "Сообщение об ошибке".
При пустом списке коллег процесс уйдёт в ветку ошибки активити.

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

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