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

Para adicionar um mapeamento de erro a um nó, use a seção Mapeamento de erros no painel de propriedades para definir quais erros o nó captura e como roteá-los no runtime.

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).

Resultado

O mapeamento de erros é adicionado ao nó. O Maestro o avalia no runtime quando o nó gera um erro, aplicando o primeiro mapeamento cuja condição é avaliada como verdadeira.

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 de menu para abrir o diálogo de criação de erro e definir 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, selecione o botão de menu.
2. Na caixa de diálogo que se abre, insira um nome e, opcionalmente, um código de erro.
3. Selecione Criar.

Resultado

O erro é adicionado ao processo e selecionado no mapeamento atual. Ele agora está disponível para referência pelos mapeamentos de erros de qualquer nó.

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