Corrigir problemas causados por um valor nulo em um fluxo
Objetivos de aprendizagem
Após concluir esta unidade, você estará apto a:
- Listar recursos para soluções de pesquisa.
- Usar recursos fora da organização para corrigir o fluxo inválido.
- Explicar a importância de considerar um valor nulo.
Aqui vamos nós no fluxo novamente
Às vezes, a questão não é tão simples como um problema de permissão do usuário. O problema pode ser qualquer coisa, desde uma lógica defeituosa a dados de entrada incorretos ou não reconhecer um valor deixado em branco. Como já foi mencionado, mesmo o menor dos problemas pode invalidar o fluxo. Todas as partes, grandes e pequenas, precisam de desempenhar suas funções ou o fluxo não funcionará como esperado.
O problema
Como administrador, você configurou um fluxo para enviar um email ao proprietário da conta sempre que um novo contato é adicionado a uma conta que ele possui. No entanto, os usuários agora precisam inserir contatos que não estão associados a uma conta. O fluxo parece estar configurado corretamente, mas os usuários continuam recebendo um erro ao adicionar um contato sem uma conta associada. Como você fez anteriormente, analise o fluxo e execute a funcionalidade de depuração para ver o que se passa.
Investigar o fluxo inválido
Siga essas etapas para conhecer esse fluxo inválido.
- Dependendo do navegador, feche a janela ou aba de depuração e retorne à tela do Flow Builder.
- Clique em Back (Voltar) no Flow Builder.
- Clique no fluxo Alert Acct Owner of New Contact Added (Alertar o proprietário da conta sobre novos contato adicionado).
- Analise o que esse fluxo está tentando realizar.
Vamos nos aprofundar um pouco mais nas ações desse fluxo.
- Clique na guia Manager (Gerenciador) na seção da caixa de ferramentas.
- Clique na ação Email_Acct_Owner.
- Analise o que a ação está tentando fazer. Ela enviará um email com o corpo e o assunto previamente preenchidos. No entanto, queremos que o email seja enviado para o proprietário da conta associada.
- Exclua o conteúdo da caixa de texto Recipient Address List (Lista de endereços de destinatários).
- Insira
record
(registro) na caixa de texto Email Addresses (Endereços de email) (separados por vírgulas) e selecione Triggering Contact (Contato de acionamento). Em seguida, selecione Account ID (ID da conta), Owner ID (ID do proprietário) e, por fim, Email.
- Clique em Save As (Salvar como) New Version (Nova versão) e, em seguida, Save (Salvar).
- Clique em Debug (Depurar).
- Clique em Run (Executar).
- Clique em Expand All (Expandir tudo) nos Debug Details (Detalhes da depuração).
E… nada? O que você quer dizer com “Nenhum registro de acionamento foi especificado, portanto, o fluxo não foi executado”? O fluxo não pode ser acionado na depuração porque a depuração não pode criar um novo contato. Sem um novo contato, o fluxo nunca será acionado. O que você pode fazer? Hora de solucionar problemas da forma tradicional. Em primeiro lugar, recrie o problema que seus usuários estão enfrentando.
Ative o fluxo, adicione um contato sem uma conta associada e veja o que acontece.
- Dependendo do navegador, feche a janela ou aba de depuração e retorne à tela do Flow Builder.
- Clique em Activate (Ativar).
- Em Setup (Configuração), clique no App Launcher (Iniciador de aplicativos).
- Selecione Sales (Vendas) e clique na guia Contacts (Contatos).
- Clique em New (Novo).
- Insira o seguinte:
- Primeiro nome:
Steve
- Sobrenome:
Rogers
- Conta: [deixe em branco]
- Clique em Save (Salvar).
- Analise a mensagem de erro.
- Copie a parte da mensagem de erro que diz “0 destinatários” (você vai precisar dela mais tarde). Deixe a janela New Contact (Novo Contato) aberta.
Agora que você viu a mensagem de erro, continue e adicione uma conta a esse novo contato para ver como o fluxo funciona em condições ideais.
- Insira
GenePoint
em Account Name (Nome da conta).
- Selecione GenePoint na lista de opções.
- Clique em Save (Salvar).
Agora você deve ter dois emails novos na caixa de entrada. O primeiro é um email de erro de quando você tentou salvar o contato sem associar uma conta. Quando um fluxo falha, o Salesforce envia um email para o administrador (a menos que seja designado de outra forma) que inclui a mensagem de erro da falha e detalhes sobre cada elemento do fluxo que a entrevista de fluxo executou.
Como você pode ver no email de erro do fluxo, há um problema quando o fluxo procura o email do proprietário da conta. Isso faz todo o sentido. O fluxo não consegue encontrar o email do proprietário da conta porque uma conta não foi associada ao novo contato. Se não há conta, não há email do proprietário da conta. Além disso, observe o erro do fluxo: clique aqui para depurar no link do Flow Builder para visualizar o caminho que o fluxo seguiu. Isso é especialmente útil quando você tem um fluxo com muitas ramificações.
O segundo email é o resultado do fluxo que foi acionado corretamente. Você adicionou o novo contato com uma conta associada. Além disso, você é o proprietário da conta GenePoint, por isso recebe o alerta por email. Nota: Essa organização foi ajustada para garantir a entrega eficaz do email do proprietário da conta. Se implementar essa ideia em uma organização de produção (teste em uma organização de sandbox primeiro!), isso poderá exigir que você desmarque a opção “Activate bounce management” (Ativar gerenciamento de devoluções) (Setup > Email > Deliverability [Configuração | Email | Capacidade de entrega] > desmarque Activate bounce management [Ativar gerenciamento de devoluções]) e desmarque a opção “Enable compliance with standard email security mechanisms” (Ativar conformidade com mecanismos de segurança de email padrão) (Setup > Email > Deliverability [Configuração | Email | Capacidade de entrega] > desmarque Enable compliance with standard email security mechanisms [Ativar conformidade com mecanismos de segurança de email padrão]) para garantir a entrega do email.
O fluxo funcionou conforme o esperado e notificou o proprietário da conta (você) de que um novo contato foi associado a uma conta da qual você é proprietário. Como administrador, você provavelmente também não seria o proprietário da conta, mas, para efeitos de treinamento, o exemplo permite que você veja o fluxo de todas as perspectivas.
A ajuda está aqui
Ainda que a situação possa parecer complicada, nem tudo está perdido. A ajuda está aqui. Existem vários recursos que vão além da funcionalidade de depuração para ajudar você a corrigir o fluxo inválido. Arregace as mangas e explore alguns recursos.
-
Email de erro do fluxo: esse importante recurso fornece detalhes específicos relacionados ao problema do fluxo e é extremamente útil na solução de problemas. O email inclui a mensagem de erro da falha e detalhes sobre cada elemento do fluxo que a entrevista de fluxo executou e um link para a visualização do fluxo que falhou.
-
Ajuda do Salesforce: pesquise artigos de conhecimento, melhore práticas e outros. Esse recurso permite a você pesquisar artigos e postagens da comunidade. Depois de analisar o email de erro do fluxo, a próxima etapa é a resolução de problemas de um fluxo inválido.
-
Grupos da Trailblazer Community: embora eles não sejam necessariamente um recurso imediato para resolver problemas, esses grupos de usuários são um manancial de informações e conhecimento. Os membros dos grupos da Community fazem networking, aprendem juntos, trocam ideias e solucionam problemas.
-
Documentação de desenvolvedores do Salesforce: a fonte da verdade para desenvolvedores do Salesforce. Ainda assim, vale a pena pesquisar a documentação do desenvolvedor, pois há informações que um administrador, como você, pode usar.
Como você já analisou o email de erro do fluxo, a próxima etapa é a Ajuda do Salesforce. Use o recurso de pesquisa para encontrar artigos de ajuda, publicações relevantes ou tópicos do Trailhead.
- Navegue até help.salesforce.com.
- Insira a mensagem de erro copiada anteriormente na barra de pesquisa:
0 recipients
(0 destinatários).
- Pressione Enter.
- Marque a caixa de verificação Knowledge Articles (Artigos do Knowledge) para filtrar apenas os resultados de Artigos do Knowledge.
- Clique no Artigo do Knowledge intitulado: Erro 'Provavelmente o limite foi excedido ou 0 destinatários' em um fluxo com uma Ação de alerta por email ou Enviar email
- Leia o Artigo do Knowledge.
Valor nulo, sem problema
O artigo lista três formas de ativar sua automação quando esse erro ocorrer.
- Crie uma regra de validação para exigir que o campo tenha um valor.
- Torne o campo obrigatório.
- Atualize seu fluxo para que o alerta por email só seja acionado quando o campo de email tiver um valor.
As duas primeiras opções não são soluções viáveis para seu caso uma vez que não permitem que os usuários realmente tenham que inserir um novo contato que não tenha uma conta associada. A melhor opção é a terceira: enviar um alerta por email apenas quando o campo de email tiver um valor. Isso significa que seu fluxo deve tentar enviar um email para o proprietário da conta somente quando for possível encontrar a conta.
- Em sua organização, clique no ícone de engrenagem de configuração e selecione Setup (Configuração).
- Insira
flows
(fluxos) na Busca rápida e selecione Flows (Fluxos).
- Clique em Alert Acct Owner of New Contact Added (Alertar o proprietário da conta sobre novos contatos adicionados).
- Clique em Edit (Editar) ao lado de Object: Contact (Objeto: Contato).
- Na lista de opções Condition Requirements (Requisitos da condição), selecione All Conditions Are Met (AND) (Todas as condições são atendidas [AND]).
- Clique na caixa de texto Field (Campo) e selecione AccountId.
- Altere o Operator (Operador) para Is Null (É nulo).
- Clique na caixa de texto Value (Valor) e selecione $GlobalConstant.False.
- Clique em Save As New Version (Salvar como nova versão).
- Garanta que opção A New Version (Uma nova versão) esteja selecionada.
- Deixe todas as outras opções como estão.
- Clique em Save (Salvar).
- Clique em Activate (Ativar).
Você adicionou uma condição ao objeto contact (contato) dizendo ao fluxo para não avançar para a próxima etapa se o AccountID for nulo (em branco) e, portanto, não tentar enviar um email para o proprietário da conta. Em seguida, teste para ver se a correção funciona inserindo um contato sem uma conta associada.
- Feche a guia ou janela Flow Builder.
- Em Setup (Configuração), clique no App Launcher (Iniciador de aplicativos).
- Selecione Sales (Vendas) e clique na guia Contacts (Contatos).
- Clique em New (Novo).
- Insira o seguinte:
- Primeiro nome:
Lily
- Sobrenome:
Mason
- Conta: [deixe em branco]
- Clique em Save (Salvar).
Nenhuma mensagem de erro! Mais confete. Você corrigiu o fluxo falho. O fluxo não produzirá um erro se o campo de conta de um novo contato estiver em branco. No entanto, se um usuário adicionar um novo contato com uma conta associada, o proprietário da conta receberá uma notificação por email, como planejado. Nota: Se quiser garantir que o fluxo apenas enviará emails aos proprietários de contas que sejam usuários ativos, adicione um elemento de decisão (ativo vs. inativo) antes do elemento de email. Saiba mais sobre o Elemento do fluxo - Decisão na Ajuda do Salesforce.
Você corrigiu todos os fluxos propositalmente inválidos. Você depurou como um usuário diferente, usou a Ajuda do Salesforce para encontrar uma resposta e adicionou um filtro a um objeto dentro de um fluxo para considerar um valor nulo. Ah, se montar móveis fosse assim tão fácil.
Recursos
- Site da Web: Ajuda do Salesforce
- Site da Web: Grupos da Trailblazer Community
- Site da Web: Documentação de desenvolvedores do Salesforce
- Trailhead: Criar fluxos com o Flow Builder
- Ajuda do Salesforce: Elemento do fluxo - Decisão