Catálogo de Atores

Catálogo de atores

Na integração entre o Conecta e o Betha BPM, os Atores são os papéis genéricos (ex: "Contador", "Avaliador", "Fiscal") desenhados no fluxo do processo. O Catálogo de atores permite que a entidade relacione esses papéis abstratos aos usuários e grupos de trabalho reais do seu ambiente.

Essa estrutura confere flexibilidade ao sistema: um mesmo modelo de processo digital pode ser implantado em múltiplas prefeituras, e cada entidade mapeia os responsáveis de forma independente em seu próprio catálogo.

Como vincular um responsável a um ator

A resolução de atores é feita de forma visual, utilizando o recurso de arrastar e soltar (drag-and-drop).

1. Acesse o menu Configurações gerais.

2. Clique na aba Catálogo de atores.

3. Na listagem de atores importados do BPM (centro da tela), identifique os itens com o status Não vinculado.

4. Na listagem lateral direita, utilize os filtros Todos, Grupos ou Participantes para localizar o usuário ou grupo de trabalho da entidade que assumirá aquele papel.

5. Clique sobre o usuário ou grupo desejado, segure e arraste-o para cima do respectivo card do ator.

6. Solte o clique. O sistema salva a alteração e atualiza o status do ator automaticamente.

Comportamentos do catálogo

• Substituição rápida: para alterar o responsável por uma etapa, basta arrastar um novo usuário ou grupo para cima do mesmo ator. A substituição ocorre na hora.

• Múltiplos participantes: se o ator estiver configurado no modelo do BPM como um perfil de Grupo, você poderá arrastar múltiplos participantes do Conecta para o mesmo card, criando uma fila de atendimento compartilhada.

• Sincronização com o BPM: se o modelo do processo for atualizado no Betha BPM com a inclusão de novos atores, eles aparecerão automaticamente na tela do Conecta com o status Não vinculado. O administrador deve realizar o mapeamento para garantir o funcionamento do fluxo.

Integração entre Conecta e Betha BPM

Durante a tramitação de uma solicitação vinculada a um processo digital, o motor do Betha BPM consulta o Conecta em tempo real sempre que o fluxo avança para uma etapa que exige um responsável (ator).

O sucesso da criação da tarefa para o usuário final depende diretamente do mapeamento correto no Catálogo de atores.

Comportamento do sistema para atores não vinculados

Caso o fluxo do processo atinja uma etapa cujo ator correspondente não tenha sido mapeado previamente pelo administrador no Conecta, o sistema não gera a tarefa para um usuário específico. O comportamento ocorre em duas frentes:

• No Conecta (interface do usuário): a tarefa correspondente não é direcionada para a aba Pessoal. Ela fica retida na visualização de Todas as tarefas e exibe um alerta visual amarelo indicando que há um aviso de execução pendente.

• No Betha BPM (acompanhar): o sistema registra a parada do fluxo. No histórico da instância, é gerado um log de execução do tipo EXECUTION_AWAITING com a mensagem exata: "Não foi possível resolver os seguintes atores: [Nome do Ator]".

info

Impacto na tramitação do processo

Esse comportamento gera um Aviso no sistema, e não uma falha crítica de script. O processo não é cancelado e não corrompe os dados; ele entra em estado de espera (atendido por ninguém).

Como destravar o processo

Para que o fluxo volte a tramitar e a tarefa chegue ao destinatário correto:

1. O administrador deve acessar o menu Configurações gerais > Catálogo de atores no Conecta.

2. Identificar o ator mencionado no log de erro e realizar o vínculo com um usuário ou grupo.

3. No Acompanhar do Betha BPM, acessar a instância parada e solicitar o reprocessamento da etapa.

4. O sistema identificará o novo vínculo e a tarefa aparecerá imediatamente na caixa Minhas tarefas do usuário mapeado.