Tratamento de erros em orquestrações
A manipulação de erros gerencia problemas inesperados que ocorrem em estágios durante uma execução de orquestração. Configure caminhos de falha para estágios para definir ações de recuperação quando ocorrerem erros de estágio, garantindo a conclusão bem-sucedida das orquestrações em vez de falha.
Edições obrigatórias
| Exibir edições com suporte para Orquestração de fluxo. |
Geral
Quando uma execução de orquestração encontra um erro, o sistema define seu status como Erro. Muitos erros que ocorrem em estágios são recuperáveis. Para esses erros, você tem até 14 dias para corrigir o erro e retomar a execução da orquestração. Se ocorrerem erros fora dos estágios, a execução da orquestração falhará e você não poderá retomá-la. Consulte Continuar uma orquestração com falha na Execução de orquestração.
A retomada exige que um administrador corrija o fluxo ou erro subjacente e retome a execução da orquestração. Essa abordagem difere dos caminhos de falha, que um designer de orquestrações configura no momento do design. Os caminhos de falha lidam com erros com facilidade e fornecem mecanismos de recuperação ou etapas de intervenção manual para os usuários finais.
Quando uma execução de orquestração falha, o Salesforce envia um email de erro ao administrador que modificou a orquestração pela última vez ou a destinatários de emails de exceção do Apex. O email de erro fornece detalhes sobre a execução da orquestração, incluindo quais elementos foram executados e quais fluxos as etapas referenciadas. Para uma orquestração ativa, o email também inclui um link para visualizar os detalhes da execução da orquestração com falha no Flow Builder. Se um fluxo chamado pela orquestração causar a falha, os destinatários receberão dois emails de erro: uma para a orquestração e outra para o fluxo chamado.
Quando um caminho de falha lida com um erro e é concluído com sucesso, a orquestração não envia notificações de erro. No entanto, você pode adicionar uma etapa em segundo plano ao caminho de falha que notifica as partes interessadas quando ocorre uma falha.
Para gerenciar erros, configure caminhos de falha para estágios em sua orquestração. Se um estágio ou qualquer etapa dentro dele encontrar um erro, esses caminhos definirão ações alternativas para minimizar falhas de processo.
Projete e depure suas orquestrações em um ambiente de sandbox antes de implementá-las em produção, pois orquestrações com falha não reverterão necessariamente todas as alterações de registro anteriores.
Erros não tratados e alterações de status
Um erro não tratado ocorre quando uma execução de orquestração encontra um problema durante a execução e nenhum mecanismo de recuperação existe. Para orquestrações, um erro não tratado ocorre quando um estágio ou etapa encontra um erro e o estágio não tem um caminho de falha configurado.
| Item | Condição | Status |
|---|---|---|
| Execução de orquestração | Ocorreu algum erro | Erro |
| Execução de estágio | O estágio estava em andamento quando ocorreu um erro no nível de execução da orquestração | Descontinuado |
| Execução de estágio | O estágio ou uma etapa dentro do estágio causou o erro | Erro |
| Execução de etapa | A etapa dentro do estágio causou o erro | Erro |
| Execução de etapa | A etapa dentro do estágio não começou antes do erro ocorrer | Não iniciado |
| Execução de etapa | A etapa dentro do estágio estava em andamento quando o erro ocorreu | Descontinuado |
Estratégias de tratamento de erros para orquestrações
A manipulação de erros em orquestrações gerencia falhas para que os processos de negócios sejam concluídos com sucesso ou sejam recuperados facilmente. Use caminhos de falha para gerenciar erros de estágios e etapas. Você pode usar caminhos de falha individuais para recuperação direcionada ou um caminho de falha centralizado para gerenciamento de erros abrangente.
Os caminhos de falha são úteis em cenários em que os usuários finais podem fornecer intervenção manual quando a execução da orquestração encontra um erro. Por exemplo, uma integração externa ou chamada de API falha porque um ponto de extremidade está inativo. Um caminho de falha pode incluir uma etapa interativa em que o designado insere manualmente os dados necessários.
Um caminho de falha pode estar vazio ou conter elementos de decisão e elementos de estágio. Cada estágio em um caminho de falha requer pelo menos uma etapa e pode conter várias etapas. Essas etapas incluem etapas em segundo plano, etapas interativas ou uma combinação de ambas. Os caminhos de falha também oferecem suporte a conectores Ir para. Um conector Ir para vincula a outro elemento no mesmo caminho de falha, um caminho de falha diferente ou o caminho principal da orquestração.
Caminhos de falha individuais. Configure um caminho de falha separado para cada estágio em uma orquestração. Esses caminhos individuais contêm elementos e estágios com etapas que gerenciam erros específicos de cada estágio. Essa abordagem fornece resolução de erros altamente localizada. Por exemplo, em uma orquestração de processamento de pedido, o estágio de verificação de inventário encontra um erro devido a um tempo limite de conexão. O caminho de falha pode executar novamente a etapa de verificação, enviar uma notificação a operações ou rotear para um estágio de revisão manual.
Caminho de falha centralizado. Configure um caminho de falha central que serve como um mecanismo de tratamento de erros consolidado. Geralmente, essa abordagem começa com um elemento de decisão que avalia variáveis e saída automática relacionada à execução da orquestração. A decisão identifica o estágio específico em que o erro ocorreu. Os elementos no caminho do resultado associado lidam com a falha. Conecte o caminho de falha de cada estágio ao primeiro elemento de decisão no caminho de falha central. Essa abordagem fornece uma resolução de erros abrangente.
Por exemplo, em uma orquestração de integração do cliente, o caminho de falha centralizado começa com um elemento de decisão. Essa decisão avalia qual estágio encontrou um erro e determina a ação de recuperação adequada.
Se o status do estágio Criar conta do cliente não for Completed, o caminho do resultado da decisão incluirá um estágio com uma etapa em segundo plano. Esta etapa notifica o gerente de conta sobre o problema. Se a etapa Configurar acesso de serviço no estágio Provisionar sistemas falhar, o caminho do resultado da decisão incluirá um estágio com duas etapas. Uma etapa em segundo plano cria um pedido de suporte. Uma etapa interativa atribui a configuração do sistema à equipe de TI. Depois que a TI concluir a configuração, a orquestração continuará até o estágio de ativação do serviço.
Limitações de tratamento de erros
- Não é possível adicionar o tratamento de erros para erros de nível de execução de orquestração.
- Você pode visualizar os detalhes da depuração de uma execução de orquestração com falha apenas em 14 dias após a falha.
- Um caminho de falha contendo apenas um elemento de término lida com erros alterando o status de execução da orquestração para
Completed. Essa abordagem suprime o erro sem resolvê-lo. O Salesforce não envia emails de notificação de erro quando o status de execução da orquestração é Concluído. No entanto, a etapa e o estágio que encontraram o erro originalmente permanecem no status Erro, embora o status de execução da orquestração seja Concluído.
