Get employee projects
The "Get employee projects" robot returns to a business process the list of Bitrix24 (Alaio) workgroups and projects an employee belongs to: an array of IDs, an array of names, the count and a Found Y/N flag. The selection can be limited to projects only or groups only, by the employee role (owner, moderator, member), and archived groups can be included.
Standard Bitrix24 (Alaio) tools give a business process no way to learn which projects an employee belongs to: the designer has no field or action for workgroups, and the REST "my groups" method answers only for the token owner. The robot closes this gap. The input is the employee (an Employee field or an ID), the object kind (groups and projects, projects only, groups only), the role (any, owner, moderator, member) and the Include archived flag. The robot walks the portal groups and checks the employee membership in each. The output is an array of IDs, an array of names, the count, the ID and name of the first project found and a Found Y/N flag. Typical scenarios: when an employee leaves, collect their projects and hand over ownership; when a task is created, check that the assignee is in the project; list a subordinate's projects in a manager report. The robot sees only the groups the process starter has access to; run the process as an administrator for a complete list. Requires the "Workgroups" (sonet) permission.
What input parameters does the robot accept?
| Parameter | Type | Required? | Default |
|---|---|---|---|
| Employee | user | yes | |
| What to search | select | — | all |
| Employee role | select | — | any |
| Include archived | bool | — | N |
What does the robot return?
| Parameter | Type |
|---|---|
| Project IDs | int |
| Project names | string |
| Count | int |
| Found (Y/N) | string |
| First project ID | int |
| First project name | string |
What errors can the robot return?
The robot writes these messages to the business process log when it cannot complete a step. The text tells you what to fix in the settings or the data.
- Error: employee is not set
- Error accessing workgroups (the "Workgroups" permission is required)
Scenario: an employee is leaving
- The offboarding process starts on the employee card
- The robot collects every project where the employee is the owner
- When Found = Y the process notifies the manager with the list of projects to hand over