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 de processo.
2. Escolha Alterar elemento e selecione instâncias múltiplas paralelas ou sequenciais.
3. No painel Propriedades, abra a seção Múltiplas instâncias.
4. Habilitar múltiplas instâncias.
5. Defina a variável de coleção que contém a lista de itens para iterar.
6. Opcionalmente, defina uma variável de elemento para representar o item atual.

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

AVISO:

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.