Marcadores

Os marcadores anotam tarefas da BPMN e atividades de chamada para transmitir a intenção, como repetição ou compensação. No Maestro, os marcadores são para clareza de modelagem, exceto várias instâncias, que o Maestro interpreta no runtime.

Marcadores de várias instâncias

Use um marcador de várias instâncias quando uma atividade deve ser executada uma vez por item em uma coleção (lista ou array).

Tipo	O que isso significa	Observação sobre runtime
Sequencial	Um item de cada vez, em ordem.	Preserva a ordem; o próximo item começa após o término do anterior.
Paralelo	Muitos itens de uma só vez.	Os itens são executados simultaneamente. A ordem não é garantida.

Você pode configurar uma tarefa para executar várias instâncias da mesma atividade, em sequência ou em paralelo.

1. Selecione a tarefa no diagrama do processo.
2. Escolha Alterar elemento e selecione várias instâncias paralelas ou sequenciais .
3. No painel Propriedades , abra a seção Várias instâncias .
4. Habilite Instâncias múltiplas.
5. Defina a variável de coleção que contém a lista de itens a serem utilizados na iteração.
6. Opcionalmente, defina uma variável de elemento para representar o item atual.

A caixa de tarefas no diagrama agora exibe o marcador de várias instâncias— três linhas horizontais para sequenciais ou linhas verticais para paralelas.

Importante: a atividade de tarefa ou chamada anotada com um marcador de várias instâncias deve fazer referência a uma coleção (uma variável ou uma expressão que é avaliada em uma lista). Se a atividade retornar um resultado por item e você precisar de uma única saída combinada, configure a agregação para combinar esses resultados (por exemplo, coletar como uma lista ou reduzir com uma expressão).

Várias instâncias sequenciais

A tarefa executa cada item da lista um por um, esperando que cada um seja concluído com sucesso antes de iniciar o próximo. Depois que todas as tarefas forem concluídas, o restante do processo continua a ser executado.

Várias instâncias paralelas

A tarefa é executada em paralelo e aguarda todas as execuções serem concluídas com sucesso antes de continuar a executar o restante do processo.

Marcador de compensação

Marca uma atividade como elegível para compensação (lógica de desfazer) no diagrama. O Maestro não executa a compensação automaticamente no runtime. Implemente qualquer lógica de desfazer explicitamente em seu modelo.

Orientação de modelagem

• Use marcadores para esclarecer a intenção do projeto, especialmente para partes interessadas que não estão cientes das restrições de execução.
• Apenas o marcador de várias instâncias altera o comportamento de runtime no Maestro; outros marcadores são auxílios de visualização.
• Documente a lógica de loop e qualquer abordagem de compensação em outro lugar do modelo de processo.
• Prefira coleções nomeadas e esquemas de itens limpos para melhorar a legibilidade.

Leia Implementação de várias instâncias para saber como configurar e executar trabalhos em várias instâncias.

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