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
Habilite a avaliação de erro de ação para obter esses benefícios.
- Capture 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 e opções de tratamento de erros para os designers de fluxo. Use seus próprios códigos de status da ação e de 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 componentes de avaliação de erro.
- 1. Opção se esta etapa falhar
- 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 da 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 tiver dados de entrada obrigatórios ou retornar a saída no tipo de dados incorreto. Uma etapa retorna um valor de 0 quando é executada com sucesso. Você não pode personalizar esses códigos.
- 4. Status da etapa > Mensagem
- Cápsula de dados da cadeia de caracteres que contém a mensagem de erro produzida pela etapa ou operação do sistema. Você não pode personalizar a mensagem de status da etapa.
Componentes de configuração da avaliação de erro de ação
A avaliação de erro de ação consiste em componentes de configuração.
- 5. Seção de avaliação de erro
- 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 transmissão de dados não têm uma seção de avaliação de erro.
- 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 do tipo "if else". Somente uma condição de erro pode ser verdadeira por vez.
- 7. Configuração de condição de erro
- Opções disponíveis para configurar uma condição de erro.
- Rótulo que você deseja usar para identificar a condição de erro
- Condições que devem ser atendidas para corresponder a esta condição de erro
- Estado de erro para o qual você deseja que a ação retorne ao fluxo
- Código de status da ação para o qual você deseja que a ação retorne ao fluxo
- Mensagem de status da ação para a qual 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 da 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 a última etapa executada. 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 cadeia de caracteres que contém o código retornado por uma condição de erro correspondente ou a última etapa executada. Você pode retornar sua própria mensagem ao criar uma condição de erro personalizada.
Diretrizes gerais
Siga estas diretrizes para obter os benefícios oferecidos pela avaliação de erro de ação.
- Permita que somente etapas independentes continuem a execução
- Permita que uma etapa continue em execução se ela não retornar os dados necessários para uma etapa posterior. Se uma etapa fornecer dados necessários para etapas posteriores, você saberá que as etapas posteriores não podem 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 para avaliar, mais lenta será a execução da ação.
- 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 identificar uma etapa específica para que um manipulador de erros de fluxo possa executar ações corretivas específicas para a falha.
- Colocar condições de erro específicas antes de condições de erro gerais
- A avaliação de erros é interrompida quando a ação encontra uma condição de erro correspondente. Colocar condições gerais de erro primeiro pode impedir que a ação corresponda a condições de erro específicas.
- Usar rótulos de condição de erro descritivos
- Identifique uma condição de erro sem precisar editá-la. Por padrão, você só pode ver as condições de erro ao editá-las.