Avaliação de erro de ação
Permita que ações capturem falhas de etapa e continuem em execução. Identifique quando ocorrerem condições de erro específicas e retorne seu próprio código de status da ação, mensagem de status e estado de erro.
Benefícios
Ative a avaliação de erro de ação para obter esses benefícios.
- Detecte falhas de etapa e permita que uma ação continue em execução. Especifique o comportamento de falha de cada etapa adicionada a uma ação.
- Crie suas próprias condições de erro. Especifique quando uma ação retorna um estado de erro, bem como os códigos de status e as mensagens retornadas.
- Forneça mais informações de tratamento de erros e opções para designers de fluxo. Use seus próprios códigos de status de ação e mensagens para identificar problemas e fornecer detalhes para ações corretivas.
Componentes da etapa de avaliação de erro de ação
Cada etapa oferece esses componentes de avaliação de erros.
- Opção Se esta etapa falhar 1
- Opção para continuar executando a próxima etapa ou ir para a avaliação de erro. Esta opção não tem efeito no status da etapa.
- 2. Status da etapa
- Cápsula de dados do objeto que contém detalhes de tempo de execução sobre a etapa. Cada etapa em uma ação retorna um status de etapa.
- 3. Status da etapa > Código
- Cápsula de dados inteiros que indica se a etapa produziu um erro. Uma etapa retorna um valor de 1 quando produz um erro por qualquer motivo. Por exemplo, uma etapa pode produzir um erro se não houver dados de entrada obrigatórios ou retornar uma saída no tipo de dados incorreto. Uma etapa retorna um valor de 0 quando é executada com sucesso. Não é possível personalizar esses códigos.
- 4. Status da etapa > Mensagem
- Cápsula de dados de cadeia de caracteres que contém a mensagem de erro produzida pela etapa ou operação do sistema. Não é possível personalizar a mensagem de status da etapa.
Componentes de configuração de avaliação de erro de ação
A avaliação de erro de ação consiste nesses componentes de configuração.
- 5. Seção Avaliação de erros
- Seção que contém possíveis condições de erro. Quando uma ação é executada, ela avalia as condições de erro disponíveis de cima para baixo, procurando uma possível correspondência. Uma ação retorna o Status da ação especificado pela primeira condição de erro correspondente. Se não houver nenhuma condição de erro correspondente, o status da ação será definido como o status de execução da última etapa. Nota:As ações de fluxo de dados têm uma seção de avaliação de erro para etapas REST, SOAP e JDBC. Para obter mais informações, consulte Data Stream actions and pagination.
- 6. Opção de adicionar condição de erro
- Opção para adicionar uma condição de erro. Cada condição de erro é equivalente a um bloco de lógica de fluxo Else IF. Apenas uma condição de erro pode ser verdadeira de cada vez.
- 7. Configuração da condição de erro
- Opções disponíveis para configurar uma condição de erro.
- Rótulo que você deseja usar para identificar esta condição de erro
- Condições que devem ser atendidas para corresponder a esta condição de erro
- Estado de erro em que você deseja que a ação retorne ao fluxo
- Código de status da ação que você deseja que a ação retorne ao fluxo
- Mensagem de status da ação que você deseja que a ação retorne ao fluxo
- 8. Status da ação
- Cápsula de dados do objeto que contém detalhes de tempo de execução sobre a ação. Uma ação sempre retorna um status de ação.
- 9. Status da ação > Código
- Cápsula de dados inteiros que contém o código retornado pela primeira condição de erro correspondente ou pela última execução da etapa. Você pode retornar seu próprio código ao criar uma condição de erro personalizada.
- 10. Status da ação > Mensagem
- Cápsula de dados de cadeia de caracteres que contém a mensagem produzida por uma condição de erro correspondente ou pela última execução da etapa. Você pode retornar sua própria mensagem ao criar uma condição de erro personalizada.
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 de fluxo de trabalho .
- Nível 1 de tratamento de erros de fluxo e ação: Nova tentativa e avaliação de erro de ação - CoE de automação de fluxo de trabalho
- Nível 2 de tratamento de erros de fluxo e ação: Lógica de fluxo - CoE de automação de fluxo
- Tratamento de erros de fluxo e ação Nível 3: Tratamento de erros de fluxo - CoE de automação de fluxo
- Nível 4 de tratamento de erros de fluxo e ação: 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 pela avaliação de erro de ação.
- Permita que somente etapas independentes continuem em execução
- Permita que uma etapa continue em execução se ela não retornar os dados exigidos por uma etapa posterior. Se uma etapa fornecer os dados necessários para etapas posteriores, você saberá que as etapas posteriores não poderão ser executadas com sucesso.
- Evite mais de 10 condições de erro
- Embora não haja limite para o número de condições de erro que você pode criar, cada condição de erro requer avaliação. Quanto mais condições de erro sua ação tiver que avaliar, mais lenta sua ação poderá ser executada.
- Identificar falhas de etapa específicas
- Você pode usar o Status da etapa para identificar quando uma etapa específica falha. Identificar uma etapa específica pode ser útil quando sua ação contém várias instâncias do mesmo tipo de etapa. Você também pode querer identificar uma etapa específica para que um manipulador de erros de fluxo possa executar ações corretivas específicas para a falha.
- Coloque condições de erro específicas antes das condições de erro gerais
- A avaliação de erro é interrompida quando a ação encontra uma condição de erro correspondente. Colocar as condições gerais de erro em primeiro lugar pode impedir que a ação corresponda a condições de erro específicas.
- Use rótulos descritivos de condição de erro
- Identifique uma condição de erro sem precisar editá-la. Por padrão, você só pode ver as condições de erro quando editá-las.