Marcadores

BPMN markers in Maestro Orchestrate for annotating task and call activity intent, including runtime multi-instance execution for collection-based processing.

Markers annotate BPMN tasks and call activities to convey intent, such as repetition or compensation. In Maestro Orchestrate, markers are for modeling clarity, except multi‑instance, which Maestro Orchestrate interprets at 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.

Resultado

A tarefa é configurada para execução de várias instâncias e exibe o marcador correspondente na tela — três linhas horizontais para instâncias sequenciais ou linhas verticais para instâncias paralelas.

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

Marks an activity as eligible for compensation (undo logic) in the diagram. Maestro Orchestrate does not execute compensation automatically at runtime. Implement any undo logic explicitly in your model.

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.
• Only the multi‑instance marker changes runtime behavior in Maestro Orchestrate; other markers are visualization aids.
• 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.

For more details about the BPMN elements supported in Maestro Orchestrate, read BPMN support.