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 informações de erro de fluxo em vez de pesquisar manualmente problemas causados por erros de fluxo.
- Automatize 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 manipulação 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
A manipulação de erros de fluxo consiste nesses componentes.
- 1. Comutador do 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.
- 2. Seção do manipulador de erros
- 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 de erro
- Cápsula de dados do objeto que contém detalhes sobre o erro detectado pelo fluxo.
- 4. Status de 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 de 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 este 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 na 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.
- Ocorreu um erro no fluxo enquanto o manipulador de erros está desabilitado
- Ocorreu 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 para de executar 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 Testar lógica de fluxo para continuar executando um fluxo que encontra erros no bloco de tentativa.
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 subfluxo após o ponto em que retornou um erro. Adicionar ações de manipulação de erros e subfluxos à seção Manipulador de erros garante que eles sejam executados quando houver um erro.
- Capturar informações de status de erro
- O objeto Status de 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 registrar os dados que podem precisar de correção.
- Suprimir mensagens de erro de subfluxo
- Você pode habilitar o Manipulador de erros para um subfluxo para impedir que seus erros sejam propagados em cascata para um fluxo primário. Deixar a seção Manipulador de erros de subfluxo vazia garante que ela sempre gere o estado Concluído (erro detectado).
- Use subfluxos para evitar o limite de 10 itens
- Em vez de forçar o processo de tratamento de erros para caber dentro de um limite de 10 itens, chame 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.
- Usar 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 de registro. Quando um erro de fluxo deixar os dados de 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.