Configuração do tratamento de erros

Cada nó em seu processo do BPMN pode ter um ou mais mapeamentos de erros que definem como o Maestro gerencia erros gerados no runtime. Use a propriedade Mapeamento de erros no painel de propriedades para especificar quais erros um nó detecta, sob quais condições e como encaminhá-los.

Erros e mapeamentos de erros

O Maestro distingue entre dois conceitos relacionados:

• Erros são definidos no nível do processo. Eles representam tipos de erro nomeados aos quais qualquer nó no processo pode fazer referência.
• Mapeamentos de erros são definidos no nível do elemento. Cada nó tem sua própria lista de mapeamentos que se vinculam a erros no nível do processo e definem as condições de detecção para esse nó específico.

Quando um nó gera um erro no runtime, o Maestro avalia seus mapeamentos de erros em ordem de prioridade e aplica o primeiro mapeamento cuja condição é avaliada em true.

Adição de um mapeamento de erros

1. Selecione o nó na tela.
2. No painel de propriedades, acesse Mapeamento de erros.
3. Selecione Adicionar mapeamento.
4. Configure os campos de mapeamento (consulte Propriedades de mapeamento de erros abaixo).

Propriedades de mapeamento de erros

Campo	Description
Erro	O erro no nível do processo que este mapeamento detecta. Selecione no menu suspenso ou clique no botão do menu para abrir a caixa de diálogo de criação de erro e defina um novo erro em linha. Ao selecionar um erro, o errorRef do mapeamento é definido como o ID do erro no nível do processo escolhido.
Condição	Define quando este mapeamento é aplicado. Use o seletor de variáveis para criar a expressão ou alterne para o editor JavaScript ou C# para condições complexas. Deixe vazio para detectar o erro incondicionalmente.
Detalhes	Uma descrição em texto livre para o mapeamento. Use isso para documentar a intenção do mapeamento para sua equipe.

Reordenação de mapeamentos por prioridade

O Maestro avalia mapeamentos de erros na ordem em que aparecem. Para alterar a ordem de avaliação, arraste um mapeamento para uma nova posição na lista. O mapeamento na parte superior é avaliado primeiro.

Propagação de erro

Quando um mapeamento de erro encontra uma correspondência, o Maestro encaminha o erro para o manipulador apropriado anexado ao nó:

• Eventos de limite: o erro se propaga para o evento de limite de erro anexado ao nó, e o processo segue o caminho de saída desse evento de limite.
• Subprocessos de eventos: os erros gerados no processo pai se propagam para subprocessos de eventos que usam um evento de início de erro, acionando o tratamento de erros centralizado definido no subprocesso.

Para modelar padrões que usam eventos de limite e subprocessos de eventos, consulte Erros e recuperação.

Criação de erros no nível do processo

Os erros no nível do processo são compartilhados entre todos os nós no processo. Para criar um novo erro:

1. No campo Erro de qualquer mapeamento, clique no botão do menu.
2. Na caixa de diálogo que se abre, insira um nome e, opcionalmente, um código de erro.
3. Selecione Criar. O erro é adicionado ao processo e selecionado no mapeamento atual.

O mesmo erro pode ser referenciado por mapeamentos em vários nós.