Subprocessos e modularidade

Os subprocessos oferecem suporte à clareza do modelo agrupando atividades relacionadas em uma única estrutura reutilizável. Eles ajudam a reduzir a complexidade do diagrama, isolar a lógica de negócios e incentivar a reutilização.

No BPMN, um subprocesso pode ser modelado em linha (recolhido ou expandido dentro do mesmo diagrama) ou como uma atividade de chamada reutilizável.

No Maestro:

• Os subprocessos em linha (recolhidos ou expandidos) são suportados para agrupar e estruturar a lógica dentro do mesmo diagrama.
• Atividades de chamada são compatíveis para invocar um processo com agente separado (projeto).
• Não é possível chamar um arquivo BPMN diferente do mesmo projeto. Para uma lógica entre processos reutilizável, crie um processo com agente separado e invoque-o usando uma atividade de chamada.
• Ao usar uma Atividade de chamada, o processo de chamada passa a entrada e recebe a saída por meio de parâmetros explicitamente definidos.

Por que usar atividades de chamada?

Uma atividade de chamada faz referência a um subprocesso definido em outro lugar do projeto ou ambiente. Comporta-se como uma função reutilizável. Atividades de chamada melhoram a modelagem de processos por:

• Reduzindo a duplicação entre diagramas
• Isolar lógica reutilizável (por exemplo, aprovações, validações, despacho)
• Mantendo o diagrama principal conciso
• Suporte a comportamento consistente entre variantes de processo.

Como modelar subprocessos

No Maestro, você pode modelar subprocessos de duas maneiras:

• Como um subprocesso em linha (recolhido ou expandido dentro do mesmo diagrama)
• Como um subprocesso reutilizável usando uma Atividade de chamada

Modela um subprocesso em linha

Use um subprocesso em linha quando você quiser agrupar etapas relacionadas dentro da mesma instância de processo.

1. Insira um elemento Subprocesso em seu diagrama BPMN.
2. Escolha se deseja exibi-lo na visualização recolhida ou expandida .
3. Modele a lógica interna diretamente dentro do subprocesso.
4. Use o subprocesso para agrupar etapas relacionadas, mantendo o diagrama principal legível.

Os subprocessos em linha são executados dentro da mesma instância de processo e compartilham o mesmo contexto de execução.

Modela um subprocesso reutilizável usando uma Atividade de chamada

Use uma Atividade de chamada quando você quiser reutilizar a lógica em vários processos.

1. Crie um processo (projeto) do Agentic separado que contenha a lógica reutilizável.
2. No diagrama pai, insira uma Atividade de chamada.
3. Selecione o processo do agente de destino para invocar.
4. Configure variáveis de entrada e saída para trocar dados entre o processo pai e o processo chamado.

Uma Atividade de chamada invoca uma instância separada de processo do Agentic. Os dados devem ser mapeados explicitamente entre o processo pai e chamado.

Exemplos de modelagem

Caso de uso: um fluxo de trabalho de integração usa o mesmo subprocesso Collect Documents nos processos de integração de funcionários e fornecedores. Em vez de duplicar etapas, uma atividade de chamada é adicionada em cada processo pai fazendo referência ao mesmo subprocesso.

Caso de uso: este exemplo de subprocesso mostra um fluxo de trabalho condicional de download e upload de arquivos no Maestro. O processo começa com um evento de início de mensagem e se ramifica usando um gateway exclusivo. Dependendo da condição, ele baixa um anexo de e-mail ou um arquivo de um campo de registro. Ambos os caminhos convergem para uma tarefa Carregar arquivo, seguida por um elemento SubProcess chamado Sub-Process1. Esse subprocesso encapsula etapas adicionais relacionadas às ações pós-upload antes de concluir o fluxo de trabalho no evento final.

Convenções de Nomes

Os nomes dos subprocessos e atividades de chamada devem:

• Use linguagem de negócios, não termos técnicos
• Descreva o resultado (por exemplo, , não )
• Refletir o que o subprocesso realiza, não o modo como.
• As faixas de participante não são compatíveis dentro de subprocessos.

Não Compatível

• Não é possível chamar um arquivo BPMN separado dentro do mesmo projeto.
• Para uma lógica reutilizável em vários processos, crie um processo (projeto) com agente separado e invoque-o usando uma Atividade de chamada.
• Os subprocessos ad-hoc não são compatíveis.
• O compartilhamento implícito de variável entre limites do processo não é compatível. Os dados devem ser mapeados explicitamente por meio das associações de entrada/saída.
• As faixas de participante não são compatíveis dentro de subprocessos.

Marcadores de várias instâncias

Subprocessos em linha são compatíveis com a execução de várias instâncias.

As atividades de chamada também são compatíveis com a execução de várias instâncias ao invocar um processo com agente separado.

Subprocessos ad-hoc e subprocessos de evento não são suportados.

Marcadores aninhados

As seguintes variáveis de string são suportadas como iteradores aninhados:

Categoria	Atributos	Como usar/acessar
OuterSP - Obter informações de contato para cada usuário	InputCollection	var.GetUsers
OuterSP - Obter informações de contato para cada usuário	Iterator Item	iterator.item.gid
InnerSP - Obtenha todos os e-mails para cada contato	InputCollection	iterator[0].item.contactArray
InnerSP - Obtenha todos os e-mails para cada contato	Iterator Item	iterator[1].item.ContactId
Enviar Email	InputCollection	iterator[1].item.EmailArray
Enviar Email	Iterator Item	iterator[2]item.emailAddress

Para obter mais detalhes sobre os elementos BPMN compatíveis com o Maestro, consulte Compatibilidade com BPMN.