Obter projetos do funcionário
O robô «Obter projetos do funcionário» retorna ao processo de negócios a lista de grupos de trabalho e projetos do Bitrix24 (Alaio) dos quais um funcionário participa: um array de IDs, um array de nomes, a quantidade e um indicador «Encontrado» Y/N. A seleção pode ser limitada a projetos ou a grupos, pela função do funcionário (proprietário, moderador, participante) e incluir grupos arquivados.
As ferramentas padrão do Bitrix24 (Alaio) não permitem que um processo de negócios saiba de quais projetos um funcionário participa: o designer não tem campo nem ação para grupos de trabalho, e o método REST «meus grupos» responde apenas pelo dono do token. O robô fecha essa lacuna. A entrada é o funcionário (campo «Funcionário» ou ID), o tipo de objetos (grupos e projetos, somente projetos, somente grupos), a função (qualquer, proprietário, moderador, participante) e o indicador «Incluir arquivados». O robô percorre os grupos do portal e verifica a participação do funcionário em cada um. A saída é um array de IDs, um array de nomes, a quantidade, o ID e o nome do primeiro projeto encontrado e o indicador «Encontrado» Y/N. Cenários típicos: no desligamento de um funcionário, reunir seus projetos e transferir a propriedade; ao criar uma tarefa, verificar se o responsável participa do projeto; em um relatório ao gestor, listar os projetos de um subordinado. O robô vê apenas os grupos aos quais quem inicia o processo tem acesso; para a lista completa, execute o processo como administrador. Requer a permissão «Grupos de trabalho» (sonet).
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| Funcionário | user | sim | |
| O que buscar | select | — | all |
| Função do funcionário | select | — | any |
| Incluir arquivados | bool | — | N |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| IDs dos projetos | int |
| Nomes dos projetos | string |
| Quantidade | int |
| Encontrado (Y/N) | string |
| ID do primeiro projeto | int |
| Nome do primeiro projeto | string |
Quais erros o robô pode retornar?
O robô grava essas mensagens no histórico do processo de negócios quando não consegue concluir uma etapa. O texto mostra o que corrigir nas configurações ou nos dados.
- Erro: funcionário não informado
- Erro ao acessar os grupos de trabalho (é necessária a permissão «Grupos de trabalho»)
Cenário: um funcionário está saindo da empresa
- O processo de desligamento começa no cartão do funcionário
- O robô reúne todos os projetos dos quais o funcionário é proprietário
- Com «Encontrado» = Y o processo notifica o gestor com a lista de projetos a transferir