Marcadores

Markers annotate BPMN tasks and call activities to convey intent, such as repetition or compensation. In Maestro, markers are for modeling clarity, except multi‑instance, which Maestro interprets at runtime.

Marcadores de várias instâncias

Use a multi‑instance marker when an activity should run once per item in a collection (list or array).

Tipo	What it means	Runtime note
Sequencial	One item at a time, in order.	Preserves order; next item starts after the previous finishes
Paralelo	Many items at once.	Items run concurrently. Order is not guaranteed.

Important: The task or call activity annotated with a multi‑instance marker must reference a collection (a variable or an expression that evaluates to a list). If the activity returns a result per item and you need a single combined output, configure Aggregation to combine those results (for example, collect as a list or reduce with an expression).

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.

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.

Marcador de compensação

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

Orientação de modelagem

• Use markers to clarify design intent, especially for stakeholders who are not aware of execution constraints.
• Only the multi‑instance marker changes runtime behavior in Maestro; other markers are visualization aids.
• Document the loop logic and any compensation approach elsewhere in the process model.
• Prefer named collections and clear item schemas to improve readability.

Read Multi‑instance implementation for how to configure and run multi‑instance work.

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