Capturando erros utilizando manipuladores de eventos de erros

Use manipuladores de eventos de erros para capturar erros em qualquer ponto em um serviço manual do lado do cliente e para implementar lógica de manipulação de erros para esses erros. Para capturar um erro específico, é possível configurar as propriedades de erro de implementação no manipulador de eventos de erro, especificando o código de erro e mapeando os dados do erro para uma variável especificada.

Sobre esta tarefa

Manipuladores de eventos de erros que são definidos em uma hierarquia de serviços manuais do lado do cliente aninhados não são visíveis para todos os serviços na hierarquia. Um manipulador de eventos de erro, que é definido em um serviço manual do lado do cliente aninhado, captura erros do serviço no qual ele está definido e a partir de todos os serviços aninhados abaixo dele. Para obter mais informações sobre serviços manuais do lado do cliente integrados, consulte Reutilizando serviços manuais do lado do cliente.
Dependendo da lógica que você implementar no manipulador de eventos de erros, a execução do serviço manual do lado do cliente aninhado pode terminar de forma diferente.
Evento Fique-na-página Evento Fique-na-página
Ao usar um evento stay-on-page após um coach no manipulador de eventos de erros, o evento stay-on-page levará o fluxo de volta para o último coach exibido no serviço que contém o manipulador de eventos de erro ou em um serviço manual do lado do cliente antecessor. O evento stay-on-page não retorna o fluxo para um coach no manipulador de eventos de erro. O coach para o qual o fluxo será retornado é determinado a partir do serviço manual do lado do cliente em que o erro é capturado, não onde ele será lançado.
Terminar evento Terminar evento
Ao usar um evento de término no manipulador de eventos de erros, tal evento finaliza o fluxo do serviço aninhado e a execução continua no serviço pai, seguindo o fluxo de saída da atividade de serviço aninhado.
Erro de Fim de Erro Erro de Fim de Erro
Ao usar um evento de término de erro no manipulador de eventos de erros, o evento de término do erro finaliza o fluxo do serviço aninhado, mas a execução pode continuar no serviço pai se ele capturar o erro que é lançado.

Procedimento

Para incluir um manipulador de eventos de erro no serviço manual do lado do cliente:

  1. Abra o serviço manual do lado do cliente com o qual você deseja trabalhar.
  2. Na visualização Diagrama , inclua um manipulador de eventos Ferramenta do manipulador de eventos.
    Um acionador de evento de erro é designado e o manipulador muda para um manipulador de eventos de Erro.
  3. Por padrão, o evento de erro é configurado para capturar todos os erros. Para capturar um erro específico:
    1. Nas propriedades Implementação > Comportamento , selecione Capturar Erros Específicos.
    2. Clique no selecionador Código de Erro para selecionar o código de erro para o erro a ser capturado.
      Por exemplo, para capturar um erro específico de propriedade de tarefa, selecione o código de erro BPMTaskOwnerError.
    3. Clique no selecionador Mapeamento de Erro para mapear os dados de erro para uma variável de mapeamento de erro que foi definida anteriormente na visualização Variáveis ...
  4. Dê um clique duplo no manipulador de eventos de erro e implemente sua lógica de manipulação de erros.
    • Você pode declarar variáveis privadas adicionais no manipulador de eventos de erros que são visíveis apenas para o manipulador de eventos.
    • Você pode utilizar um coach para exibir o erro para o usuário.
  5. Opcional: Para definir vários manipuladores de eventos de erros que podem ter uma lógica de manipulação de erros diferente para erros diferentes, itere as etapas 3 a 5. Para cada manipulador de eventos de erros, use códigos de erros diferentes ou dados de erros para diferenciar entre os diferentes tipos de erros.
  6. Clique em Salvar ou em Concluir Edição.
    Para obter detalhes sobre a declaração de variáveis para os serviços humanos no lado do cliente, consulte Declaração de variáveis