Marcadores

Os marcadores são pequenas notações gráficas adicionadas às tarefas BPMN e atividades de chamada. Eles ajudam a documentar a intenção do designer, como repetição ou compensação. No Maestro, os marcadores são compatíveis apenas para clareza de modelagem, exceto para marcadores de várias instâncias, que são interpretados em runtime.

Marcadores de várias instâncias

Os marcadores de várias instâncias indicam que uma atividade deve repetir para cada item em uma coleção.

Tipo	Description	Comportamento dos runtimes
Sequencial	Executa cada instância uma após a outra
Paralelo	Executa todas as instâncias simultaneamente

Importante: deve ser configurado com uma entrada de coleção. As opções de agregação podem ser configuradas se a saída for esperada.

Compatibilidade com loop

Para lidar com tarefas semelhantes à iteração no Maestro (por exemplo, validar uma lista de itens) você pode usar marcadores Paralelos ou Sequenciais. Os marcadores comportam-se como loops tradicionais, mas são mais potentes, porque têm escalonamento melhor.

Esses marcadores permitem que o Maestro distribua dinamicamente uma tarefa por item da lista — semelhante a uma abordagem tradicional forloop — enquanto preserva a escalabilidade e a capacidade de observação.

Exemplo:

Você recebe uma lista de IDs de faturas de uma API externa. Você precisa validar cada fatura chamando outra API. Em vez de escrever um loop, você define um plano que contém:

• uma lista dinâmica de identificadores de faturas (de uma etapa anterior ou interrogação externa)
• um marcador paralelo para distribuir uma ação por fatura.

Marcador de compensação

Marca uma atividade como elegível para compensação (desfazer lógica).

• Modelagem: não suportado
• Execução: não suportado

Importante: use esse marcador ao modelar cenários de compensação transacional. A lógica de execução deve ser implementada separadamente.

Orientação de modelagem

• Use marcadores para clarificar a intenção de modelagem, especialmente para leitores não familiarizados com restrições de execução.
• Apenas marcadores de múltiplas instâncias resultam em execução repetida real.
• Sempre documente a lógica de loop ou comportamento de compensação em outro lugar do processo.

Para obter mais detalhes sobre os elementos BPMN suportados no Maestro, consulte Suporte BPMN.