Получить участников проекта
Робот «Получить участников проекта» возвращает в бизнес-процесс состав рабочей группы или проекта Битрикс24 по его ID: владельца, список модераторов, полный список участников и их количество, а также признак «Найдено» Y/N. Списки участников приходят массивами ID сотрудников — их можно сразу подставить в уведомление, задачу или следующий робот.
В штатном дизайнере бизнес-процессов Битрикс24 нет способа получить состав проекта: ни поля, ни действия для рабочих групп. Робот читает участников через REST по ID группы или проекта и возвращает три списка: владелец (один сотрудник), модераторы и все активные участники, включая владельца и модераторов. Приглашённые, но ещё не принявшие приглашение сотрудники не учитываются. Дополнительно возвращаются количество участников и признак «Найдено» Y/N: N означает, что группа с таким ID не существует или недоступна пользователю, запустившему процесс. Типовые сценарии: разослать уведомление всем участникам проекта при смене стадии сделки; поставить задачу модераторам проекта; проверить, что у проекта есть хотя бы один модератор, и назначить его при отсутствии. Робот работает в паре с «Получить проекты сотрудника» и «Информация о проекте». Требует право доступа «Рабочие группы» (sonet).
Какие параметры принимает робот?
| Параметр | Тип | Обязательный? | По умолчанию |
|---|---|---|---|
| ID группы / проекта | int | да |
Что возвращает робот?
| Параметр | Тип |
|---|---|
| Владелец | int |
| Модераторы | int |
| Все участники (включая владельца и модераторов) | int |
| Количество участников | int |
| Найдено (Y/N) | string |
Какие ошибки может вернуть робот?
Эти сообщения робот пишет в журнал бизнес-процесса, когда не может выполнить шаг. По тексту видно, что исправить в настройках или данных.
- Ошибка: не указан ID группы / проекта
- Ошибка при обращении к группе (проверьте ID и право доступа «Рабочие группы»)
Сценарий: уведомить команду проекта
- Сделка переходит на стадию «Запуск», в поле сделки указан ID проекта
- Робот получает всех участников проекта по этому ID
- Процесс отправляет каждому участнику уведомление о запуске