Subprocesses and modularity

Subprocesses support model clarity by grouping related activities into a single reusable structure. They help reduce diagram complexity, isolate business logic, and encourage reuse.

In BPMN, a subprocess can be modeled either inline or via a reusable call activity. In Maestro:

• Apenas atividades de chamada são compatíveis.
• The subprocess must be modeled as a separate diagram.
• O processo de chamada passa a entrada e recebe a saída por meio de parâmetros definidos.

Por que usar atividades de chamada?

A call activity references a subprocess defined elsewhere in the project or environment. It behaves like a reusable function. call activities improve process modeling by:

• 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.

How to model subprocesses

To create a subprocess in Maestro:

• Model the subprocess as its own standalone diagram.
• No diagrama pai, insira uma atividade de chamada.
• Link the call activity to the subprocess.
• Configure variáveis de entrada e saída para trocar dados.

Exemplos de modelagem

Use case: An onboarding workflow uses the same Collect Documents subprocess in both employee and vendor onboarding processes. Instead of duplicating steps, a call activity is added in each parent process referencing the same subprocess.

Use case: This subprocess example shows a conditional file download and upload workflow in Maestro. The process begins with a message start event and branches using an exclusive gateway. Depending on the condition, it either downloads an email attachment or a file from a record field. Both paths converge into an Upload File task, followed by a SubProcess element named Sub-Process1. This subprocess encapsulates additional steps related to post-upload actions before completing the workflow at the end event.

Diretrizes de modelagem

• Give subprocesses meaningful business names (e.g., Verify Contract Terms).
• Documente os parâmetros de entrada/saída e seu uso esperado.
• Keep subprocesses focused on a single responsibility or outcome.
• Avoid designing subprocesses with assumptions about the parent context.

Convenções de Nomes

Subprocess and call activity names should:

• Use linguagem de negócios, não termos técnicos
• Descreva o resultado (por exemplo, Coletar dados do cliente, não Etapa 2 do formulário)
• Reflect what the subprocess accomplishes, not how.

Não Compatível

• Expanded subprocesses (i.e., inline subprocesses) are not supported. All subprocesses must be modeled as separate diagrams and invoked using Call Activities.
• Ad-hoc subprocesses are not supported.
• O compartilhamento de variáveis implícito não é compatível. Os dados devem ser mapeados explicitamente por meio de mapeamentos de entrada/saída.

Marcadores de várias instâncias

Os subprocessos são compatíveis com marcadores de várias instâncias, onde cada Elemento é executado várias vezes. Os elementos que podem ser marcados como várias instâncias são todos os tipos de tarefas, exceto para subprocessos.

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 suportados no Maestro, consulte Suporte BPMN.