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

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

Получение состава рабочей группы для уведомлений или рассылок;
Проверка наличия пользователя в группе перед добавлением;
Разделение участников по ролям для дальнейшей обработки;
Передача списка участников в итератор для массовых операций;
Аналитика и отчётность по составу групп;
Уведомление модераторов или владельца группы;
Синхронизация состава группы с внешними системами;
Проверка прав доступа на основе роли в группе;
Автоматизация при назначении задач участникам группы;
Получение владельца группы для передачи прав или уведомления.

Как работает активити (робот):
- Активити (робот) получает список всех участников рабочей группы через API sonet_group.user.get;
- Участники разделяются на три категории: владелец (owner_id), модераторы (moderators_array), обычные участники (members_array);
- Поддерживается два формата ID: 1 (числовой) или user_1 (с префиксом user_);
- Роли: A - владелец/администратор, E - модератор, K - участник.

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

Название поля	Описание и примеры использования
ID рабочей группы	Обязательный параметр. Идентификатор группы, для которой получается список участников. Примеры: - {=Variable:GROUP_ID}, {=A12345:i_group_id}, 42
Формат пользователей	Необязательный параметр. 1 - числовой ID (по умолчанию), user_1 - формат user_ID. Выбор влияет на формат возвращаемых значений. Примеры: - 1 - для передачи в активити, ожидающие числовой ID; - user_1 - для полей типа "Пользователь" в Битрикс24.
Запускать от имени	Сотрудник с правами на просмотр состава группы.

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

Описание примера	Решение
Получить список для уведомления всех участников	group_id - {=Variable:GROUP_ID}, user_format - 1. Объедините members_array, moderators_array и owner_id для рассылки.
Уведомить только модераторов группы	group_id - {=Variable:GROUP_ID}. Используйте возвращаемый moderators_array.
Получить владельца группы для передачи задач	group_id - {=Variable:GROUP_ID}. Используйте owner_id.
Проверить, есть ли пользователь в группе	group_id - {=Variable:GROUP_ID}. Проверьте вхождение {=User:ID} в members_array, moderators_array или owner_id.
Удалить всех участников кроме владельца	group_id - {=Variable:GROUP_ID}. Передайте members_array и moderators_array в активити (робот) "Удаление участника(ов) из группы".
Назначить задачу первому модератору	group_id - {=Variable:GROUP_ID}. Используйте первый элемент moderators_array.
Итерация по участникам для массовой рассылки	group_id - {=Variable:GROUP_ID}. Передайте members_array в итератор, в цикле отправляйте уведомления.
Получить ID в формате user_ для поля "Пользователь"	group_id - {=Variable:GROUP_ID}, user_format - user_1
Проверить состав группы после добавления	group_id - {=Variable:GROUP_ID}. Вызовите после "Добавление участника(ов) в группу" для проверки.
Получить участников из найденной группы	group_id - {=A12345:search_result_first_string}. Сначала "Поиск групп", затем получение состава.

Возвращаемые параметры данного активити (робота):
- Обычные участники (members_array) - массив ID участников (роль K), множественное значение.
- Модераторы (moderators_array) - массив ID модераторов (роль E), множественное значение.
- Владелец (owner_id) - ID владельца группы (роль A), один пользователь.
- Соответствует условиям (math_search_results) - Y при успехе, N если участники не найдены.
- Сообщение об ошибке (s_error_logs) - информация об ошибке или успехе.

При пустой группе или ошибке, параметр "Соответствует условиям" = N.
Проверяйте перед использованием массивов.

Ограничения и рекомендации:

Пустая группа:
Если группа не существует или в ней нет участников, активити (робот) завершится с ошибкой "Участники не найдены".

Формат ID:
Выбор формата user_format влияет на совместимость с другими активити (роботами).
Для полей "Пользователь" используйте user_1.

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

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