Manipulador de erros de fluxo
Habilite fluxos para detectar erros. Execute uma sequência de ações e subfluxos para identificar e corrigir problemas. Por exemplo, faça com que os fluxos registrem em log valores de saída, enviem notificações e executem subfluxos corretivos quando eles produzirem um erro.
Benefícios
Habilite um manipulador de erros de fluxo para obter esses benefícios.
- Automatize a identificação de erros de fluxo conforme eles acontecem. Capture e envie por push informações de erro de fluxo em vez de pesquisar manualmente problemas causados por erros de fluxo.
- Automatizar a resolução de erros de fluxo. Execute ações e subfluxos para atualizar registros em vez de atualizar manualmente os registros afetados por erros de fluxo.
- Crie sua própria lógica de tratamento de erros de ação. Especifique quando as ações retornam um erro em vez de sempre retornar um erro.
Componentes do manipulador de erros
O tratamento de erros de fluxo consiste nesses componentes.
- 1. Comutador Manipulador de erros
- Opção para habilitar ou desabilitar o tratamento de erros de fluxo. Quando habilitado, o fluxo exibe a seção Manipulador de erros.
- Seção Manipulador de erros 2
- Seção do fluxo que é executada quando o fluxo detecta um erro. Use esta seção para automatizar a identificação e a resolução de erros de fluxo. Você pode adicionar até 10 itens nesta seção.Nota:O limite de 10 itens inclui qualquer combinação de ações, lógica de fluxo ou subfluxos.
- 3. Status do erro
- Cápsula de dados do objeto que contém detalhes sobre o erro detectado pelo fluxo.
- 4. Status do erro > Código
- Cápsula de dados inteiros que indica se o fluxo produziu um erro. Por padrão, um valor de 1 indica que o fluxo produziu um erro. Um valor de 0 indica que o fluxo foi executado com sucesso. Você pode definir seus próprios códigos de erro ao criar uma ação personalizada.
- 5. Status do erro > Mensagem
- Cápsula de dados de cadeia de caracteres que contém a mensagem de erro produzida pela ação, etapa ou operação do sistema.
estados de erro disponíveis
Habilitar o Manipulador de erros muda os estados relatados nos detalhes de execução do fluxo. O Manipulador de erros pode produzir esses estados de fluxo.
- Concluído (erro detectado)
- Estado gerado quando o fluxo detectou um erro e executou com sucesso os itens na seção Manipulador de eventos. O fluxo gera esse estado mesmo quando a seção Manipulador de eventos está vazia. Este estado só está disponível quando você habilita um Manipulador de erros de fluxo. Este estado só está visível em uma página de detalhes de execução de fluxo. Em vez disso, os registros de contexto de fluxo exibem o estado como Concluído .
- Concluído (erro ignorado)
- Estado gerado quando uma ação personalizada continua em execução após uma falha de etapa. Quando uma ação gera este estado, ela o passa para o fluxo primário. Este estado só está disponível quando você habilita um Manipulador de erros de fluxo. Este estado só está visível em uma página de detalhes de execução de fluxo. Em vez disso, os registros de contexto de fluxo exibem o estado como Concluído .
- Erro
- Estado gerado quando um erro permanece não detectado.
- Ocorre um erro no fluxo enquanto o Manipulador de erros está desabilitado
- Ocorre um erro na seção Manipulador de erros
Quando ocorre um erro
Quando ocorre um erro em um fluxo com um manipulador de erros ativo, o fluxo interrompe a execução de outras ações e lógica de fluxo e, em vez disso, executa os itens na seção do manipulador de erros. Se os itens na seção do manipulador de erros forem executados, o fluxo será interrompido com o estado Concluído (erro detectado). Se o próprio manipulador de erros gerar um erro, o fluxo será interrompido com o estado Erro.
Um fluxo não pode executar novamente itens que geram um erro ou retomar a partir da etapa que gerou um erro. Você pode usar Tente a lógica de fluxo para continuar executando um fluxo que encontra erros no bloco testar.
Recursos de manipulação de erros de fluxo e ação
Para obter mais informações sobre como usar o tratamento de erros em ações e fluxos, consulte ServiceNow® Publicação da comunidade Visão geral do tratamento de erros de fluxo e ação: Por que e como testar erros - CoE de automação do Worfklow .
- Tratamento de erros de fluxo e ação Nível 1: Nova tentativa e avaliação de erro de ação - CoE de automação de fluxo de trabalho
- Tratamento de erros de fluxo e ação Nível 2: Lógica de fluxo - CoE de automação de fluxo de trabalho
- Tratamento de erros de fluxo e ação Nível 3: Tratamento de erros de fluxo - CoE de automação de fluxo de trabalho
- Tratamento de erros de fluxo e ação Nível 4: Boas práticas e resumo - CoE de automação de fluxo de trabalho
Diretrizes gerais
Siga estas diretrizes gerais para obter os benefícios oferecidos pelo tratamento de erros de fluxo.
- Evite adicionar itens de manipulação de erros à seção principal do fluxo
- Um fluxo normalmente para de ser executado quando uma ação ou subfluxo retorna um erro na seção principal. Um fluxo interrompido não pode executar nenhuma ação ou subfluxos além do ponto em que retornou um erro. Adicionar ações de tratamento de erros e subfluxos à seção Manipulador de erros garante que eles os executem quando há um erro.
- Capture informações de status de erro
- O objeto Status do erro contém informações sobre a ação que produziu um erro. Você pode usar essas informações para identificar a causa do erro, bem como dados de registro que podem precisar de correção.
- Suprimir mensagens de erro de subfluxo
- Você pode habilitar o Manipulador de erros para um subfluxo para evitar que os erros sejam colocados em cascata para um fluxo primário. Deixar a seção Manipulador de erros do subfluxo vazia garante que ele sempre gere o. Concluído (erro detectado) estado.
- Use subfluxos para evitar o limite de 10 itens
- Em vez de forçar o processo de manipulação de erros a se ajustar a um limite de 10 itens, chame os subfluxos, que podem conter muito mais itens. Você também pode usar as saídas de subfluxo para acionar a automação em outros fluxos.
- Use subfluxos para executar ações corretivas
- Em vez de recriar a mesma sequência de ações em vários fluxos, crie subfluxos reutilizáveis para corrigir erros nos dados do registro. Quando um erro de fluxo deixa os dados do registro em um estado indesejado, use subfluxos para corrigir esses registros. Você pode usar o manipulador de erros para identificar esses dados de registro como uma saída de subfluxo.