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