Obter participantes do projeto
O robô «Obter participantes do projeto» retorna ao processo de negócios a composição de um grupo de trabalho ou projeto do Bitrix24 (Alaio) pelo ID: o proprietário, a lista de moderadores, a lista completa de participantes e sua quantidade, além de um indicador «Encontrado» Y/N. As listas de participantes chegam como arrays de IDs de funcionários, prontas para uma notificação, uma tarefa ou o próximo robô.
O designer padrão de processos de negócios do Bitrix24 (Alaio) não oferece forma de obter a composição de um projeto: nem campo nem ação para grupos de trabalho. O robô lê os participantes via REST pelo ID do grupo ou projeto e retorna três listas: o proprietário (um funcionário), os moderadores e todos os participantes ativos, incluindo o proprietário e os moderadores. Funcionários convidados que ainda não aceitaram não são contados. Também retorna o número de participantes e o indicador «Encontrado» Y/N: N significa que não existe grupo com esse ID ou que ele não está acessível a quem inicia o processo. Cenários típicos: notificar todos os participantes do projeto quando um negócio muda de etapa; criar uma tarefa para os moderadores do projeto; verificar se o projeto tem pelo menos um moderador e nomear um caso não tenha. O robô combina com «Obter projetos do funcionário» e «Informações do projeto». Requer a permissão «Grupos de trabalho» (sonet).
Quais parâmetros de entrada o robô aceita?
| Parâmetro | Tipo | Obrigatório? | Padrão |
|---|---|---|---|
| ID do grupo / projeto | int | sim |
O que o robô retorna?
| Parâmetro | Tipo |
|---|---|
| Proprietário | int |
| Moderadores | int |
| Todos os participantes (incluindo proprietário e moderadores) | int |
| Número de participantes | int |
| Encontrado (Y/N) | 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: ID do grupo / projeto não informado
- Erro ao acessar o grupo (verifique o ID e a permissão «Grupos de trabalho»)
Cenário: avisar a equipe do projeto
- Um negócio passa para a etapa «Lançamento», um campo do negócio contém o ID do projeto
- O robô obtém todos os participantes do projeto por esse ID
- O processo envia a cada participante uma notificação de lançamento