Você está aqui:
Solução de problemas de erros de tempo de execução de fluxo
Saiba como solucionar e solucionar erros de fluxo e comportamento inesperado em seus fluxos que ocorrem após a ativação. Interprete emails de erro e use as melhores práticas para identificar e resolver problemas rapidamente.
Entendendo os emails de erro de fluxo
Se uma execução de fluxo falhar, o Salesforce enviará um email ao administrador que modificou o fluxo associado pela última vez ou aos destinatários do email de exceção do Apex. O email inclui a mensagem de erro, detalhes sobre cada elemento de fluxo que o fluxo executou e um link para visualizar o fluxo com falha no Flow Builder.
Nota Se a execução de fluxo falhar em vários elementos ou se ocorrerem falhas em um lote de entrevistas de fluxo, os destinatários receberão vários emails ou um email com uma mensagem de erro para cada falha.
- Mensagem de erro: Descreve o que deu errado. Procure palavras-chave como "exceção não tratada", "falha do elemento" ou erros de validação específicos.
- Nome e versão do fluxo: Identifica qual fluxo e versão falharam.
- Detalhes do elemento: Mostra qual elemento no fluxo causou o erro. O rótulo ou o nome da API do elemento normalmente é incluído.
- Rastreio de pilha: Para solução avançada de problemas, o rastreamento de pilha pode ajudar a identificar a origem do erro, especialmente para fluxos complexos ou ações do Apex.
Exemplo
Erro: Ocorreu um erro no elemento Send_Email_to_Contact. Parâmetro de entrada obrigatório ausente: RecipientId.
O que significa: O fluxo não conseguiu enviar o email configurado no elemento Send_Email_to_Contact porque não havia um valor no campo ID do destinatário.
Dicas para solucionar erros de fluxo
- Comece lendo o email de erro com cuidado. Identifique o elemento do problema e a mensagem de erro.
- Abra o fluxo no Flow Builder e localize o elemento mencionado no email.
- Use o recurso de depuração no Flow Builder para executar o fluxo com dados de amostra e observar se há falhas em tempo real. No email de erro de fluxo, clique em Erro de fluxo: Clique aqui para depurar o erro no Flow Builder. Saiba mais sobre o depurador em Teste ou solução de problemas de fluxos com o Depurador do Flow Builder.
- Verifique se há valores de entrada ausentes ou incorretos, especialmente para campos ou variáveis obrigatórios.
- Revise os conectores de falha e os caminhos de tratamento de erros para garantir que estejam configurados corretamente.
- Teste o fluxo como diferentes usuários para verificar se há problemas de permissão ou acesso.
- Para fluxos acionados por registro, verifique se o registro acionador atende a todos os critérios de entrada.
Práticas recomendadas para solução de problemas mais fácil
- Adicione rótulos descritivos e nomes de API a elementos e recursos de fluxo para facilitar a interpretação de emails de erro. Por exemplo, Obter registros 1 não é tão útil em um email de erro quanto Obter contatos relacionados.
- Use conectores de falha em elementos críticos para fornecer mensagens de erro fáceis de usar e caminhos alternativos. Se uma execução de fluxo encontrar um erro e seguir um caminho de falha, o fluxo executará os elementos no caminho de falha em vez de enviar um email de erro.
- Envie notificações para facilitar o rastreamento e a resolução.
- Documente erros e soluções comuns para sua equipe.
- Depois de corrigir um erro, teste novamente o fluxo usando o Depurador do Flow Builder.
- Avançado: Registre erros em um objeto personalizado para mais detalhes do erro.
Nota Para armazenar mais informações sobre uma entrevista quando ela é salva como um registro do Salesforce, crie um objeto personalizado que faça referência ao GUID da entrevista. Uma entrevista recebe um ID de 18 caracteres do Salesforce somente quando está pausada e salva como um registro do Salesforce. Cada entrevista, em andamento ou em pausa, possui um GUID.
- Solucionar erros REQUIRED_FIELD_MISSING em fluxos
Quando um fluxo tenta criar ou atualizar um registro sem preencher todos os campos obrigatórios, você recebe um erro REQUIRED_FIELD_MISSING. - Solucionar erros do Apex_CPU_TIME_LIMIT_EXCEEDED em fluxos
Quando uma transação consome muito tempo de CPU, o Salesforce gera um erro do Apex_CPU_TIME_LIMIT_EXCEEDED. Os fluxos compartilham esse limite com todas as outras automações na mesma transação, incluindo acionadores do Apex. - URLs do fluxo de solução de problemas
Se você estiver distribuindo um fluxo e o botão personalizado, o link personalizado ou um URL de fluxo direto não estiver funcionando conforme esperado, verifique o fluxo referenciado. Além disso, verifique suas variáveis, caso você esteja passando os valores para um fluxo a partir do URL. - Solução de problemas de novas tentativas de fluxo
Aprenda como um fluxo é executado novamente depois que ele não foi concluído com sucesso. Uma nova tentativa de fluxo é quando um fluxo é executado novamente para processar registros que não foram salvos com sucesso.
Consulte também:
Este artigo resolveu seu problema?
Diga-nos para podermos melhorar!
