Adicionar tratamento de erros
Podem ocorrer erros durante a execução de um cenário.
Por exemplo, um erro pode ocorrer porque:
- Um serviço está indisponível devido a uma falha
- Um serviço responde com dados inesperados
- Falha na validação dos dados de entrada
- Outros motivos
Se um módulo encontrar um erro durante a execução do cenário e não houver nenhuma rota de tratamento de erros anexada ao módulo ou sua rota, a lógica de tratamento de erros padrão será executada.
Ao adicionar um manipulador de erros a um módulo ou uma rota, você pode substituir a lógica de manipulação de erros padrão pela sua própria lógica. O Adobe Workfront Fusion oferece cinco diretivas diferentes que podem ser inseridas ao final das rotas do manipulador de erros.
Para obter mais informações sobre tratamento de erros padrão, consulte Tipos de erros.
Para obter mais informações sobre diretivas de tratamento de erros, consulte Diretivas para tratamento de erros.
Como o tratamento de erros no nível da rota é uma maneira mais escalável, consistente e arquitetonicamente limpa de gerenciar erros, especialmente em automações avançadas de várias ramificações, recomendamos usar o tratamento de erros no nível da rota como prática recomendada.
Requisitos de acesso
| table 0-row-2 1-row-2 2-row-2 layout-auto html-authored no-header | |
|---|---|
| Pacote do Adobe Workfront |
Qualquer pacote de fluxo de trabalho do Adobe Workfront e qualquer pacote do Adobe Workfront Automation and Integration Workfront Ultimate Os pacotes Workfront Prime e Select, com uma compra adicional do Workfront Fusion. |
| Licenças do Adobe Workfront |
Padrão Trabalho ou maior |
| Produto | Se sua organização tiver um pacote Workfront Select ou Prime, ele não inclui o Workfront Automation and Integration. É necessário comprar o Adobe Workfront Fusion. |
Para obter mais detalhes sobre as informações contidas nesta tabela, consulte Requisitos de acesso na documentação.
Localização e hierarquia do manipulador de erros
Você pode adicionar manipuladores de erro a módulos individuais ou roteadores.
Um manipulador de erros anexado a um módulo do aciona apenas os erros encontrados durante o processamento desse módulo específico.
Um manipulador de erros anexado a um roteador dispara erros encontrados por qualquer módulo na rota desse roteador. Isso inclui erros encontrados em qualquer rota filha que não tenha um manipulador de erros em seu próprio roteador.
Os erros são tratados pela seguinte hierarquia:
- Módulo
- Roteador
- Roteador pai
- Tratamento de erros padrão
Exemplo
Considere o exemplo de cenário a seguir:
- Este módulo tem um manipulador de erros. Qualquer erro neste módulo é tratado pela diretiva Commit.
- Este módulo não tem um manipulador de erros. Se este módulo encontrar um erro, o erro será tratado pelo manipulador no roteador que criou a rota do módulo. Qualquer erro nesse módulo é tratado pela diretiva de reversão.
- Esse módulo não possui um manipulador de erros, nem o roteador que criou a rota do módulo, mas há um manipulador de erros no próximo roteador ativo. Qualquer erro nesse módulo é tratado pela diretiva Break.
- Se um módulo não tiver um manipulador de erros no módulo, no seu roteador ou em qualquer roteador pai, todos os erros nesse módulo serão tratados por tratamento de erros padrão.
- Para criar um manipulador de erro global, crie um roteador próximo ao início do cenário e anexe o tratamento de erros a esse roteador.
Adicionar um manipulador de erros
Você pode adicionar um manipulador de erros a um módulo ou roteador.
Adicionar um manipulador de erros a um módulo
Para adicionar um manipulador de erros a um módulo:
-
Clique na guia Cenários no painel esquerdo.
-
Selecione o cenário em que deseja adicionar uma rota de tratamento de erros.
-
Clique em qualquer lugar no cenário para entrar no editor de cenários.
-
Clique com o botão direito do mouse no módulo após o qual deseja adicionar uma rota de manipulador de erros e selecione Adicionar manipulador de erros:
Uma rota de manipulador de erros foi adicionada ao módulo. Se o módulo for o último em uma rota, o manipulador de erros seguirá diretamente o módulo. Se o módulo tiver mais módulos depois dele, uma rota de manipulador de erros separada será adicionada.
O módulo de manipulação de erros mostra uma lista de Diretivas, bem como os aplicativos que estão sendo usados em seu cenário.
-
Selecione uma das diretivas.
Ou
Adicione um ou mais módulos à rota do manipulador de erros.
Se você adicionar mais módulos à rota, a diretiva Ignore será aplicada por padrão. Se houver um erro, os módulos subsequentes nessa rota serão processados.
Para obter mais informações sobre diretivas, consulte Diretivas de tratamento de erros neste artigo.
-
(Opcional) Adicione um filtro à rota de tratamento de erros. Para obter instruções, consulte Adicionar filtragem e aninhamento a rotas de tratamento de erros.
Adicionar um manipulador de erros a um roteador
-
Clique na guia Cenários no painel esquerdo.
-
Selecione o cenário em que deseja adicionar uma rota de tratamento de erros.
-
Clique em qualquer lugar no cenário para entrar no editor de cenários.
-
Clique com o botão direito do mouse no roteador onde deseja adicionar uma rota de manipulador de erros e selecione Adicionar manipulador de erros:
Uma rota de manipulador de erro é adicionada ao roteador.
O módulo de manipulação de erros mostra uma lista de Diretivas, bem como os aplicativos que estão sendo usados em seu cenário.
-
Selecione uma das diretivas.
Ou
Adicione um ou mais módulos à rota do manipulador de erros.
Se você adicionar mais módulos à rota, a diretiva Ignore será aplicada por padrão. Se houver um erro, os módulos subsequentes nessa rota serão processados.
Para obter mais informações sobre diretivas, consulte Diretivas de tratamento de erros neste artigo.
-
(Opcional) Adicione um filtro à rota de tratamento de erros. Para obter instruções, consulte Adicionar filtragem e aninhamento a rotas de tratamento de erros.
Erro ao manipular diretivas
As diretivas são resumidamente explicadas a seguir. Para obter mais informações, consulte Diretivas para tratamento de erros.
Há cinco diretivas, que podem ser agrupadas nas seguintes categorias com base no fato de uma execução de cenário continuar após o erro.
As diretivas a seguir garantem que uma execução de cenário continue:
-
Retomar: permite especificar uma saída substituta para o módulo com o erro. O status de execução do cenário é marcado como sucesso.
-
Ignorar: ignora o erro. O status de execução do cenário é marcado como sucesso.
-
Intervalo: armazena a entrada na fila de execuções incompletas. O status de execução do cenário está marcado como aviso.
Para obter mais informações, consulte Exibir e resolver execuções incompletas.
Se uma execução de cenário precisar parar quando ocorrer um erro, use uma das seguintes diretivas:
- Reversão: interrompe a execução do cenário imediatamente e marca seu status como erro.
- Confirmar: interrompe a execução do cenário imediatamente e marca seu status como êxito.
Recursos
Para obter mais informações sobre o tratamento de erros, consulte: