Combinar variáveis e elementos de dados

Objetivos de aprendizagem

Após concluir esta unidade, você estará apto a:

• Usar as variáveis geradas por alguns elementos.
  
• Recuperar dados de registros do Salesforce para usar nos seus fluxos.
  
• Usar variáveis de registro nos elementos Create Records (Criar registros) e Update Records (Atualizar registros).
  

Observação

Deseja aprender em português (Brasil)? Comece o desafio em um Trailhead Playground de português (Brasil) e use as traduções fornecidas entre parênteses para navegar. Copie e cole somente os valores em inglês porque as validações dos desafios dependem de dados em inglês. Se você não passar no desafio em sua organização de português (Brasil), recomendamos que (1) mude o local para os Estados Unidos, (2) mude o idioma para inglês, seguindo as instruções aqui, e (3) clique novamente no botão “Validar o desafio”.

Consulte o emblema Trailhead no seu idioma para saber mais sobre como aproveitar a experiência de Trailhead em outros idiomas.

Este emblema é uma das paradas no caminho para dominar o Flow Builder. Do início ao fim, a trilha Criar fluxos com o Flow Builder leva você numa jornada de aprendizado sobre tudo o que envolve o Flow Builder. Siga esta sequência recomendada de emblemas para desenvolver habilidades de automação de processos fortes e se tornar um especialista em Flow Builder.

Variáveis geradas pelos elementos

As variáveis são muito úteis nos fluxos, mas se você tivesse que criar uma variável para cada valor de dados diferente em um fluxo, se cansaria de fazer variáveis rapidinho. Ainda bem que alguns elementos de fluxo criam suas próprias variáveis. Essas variáveis têm rótulos que correspondem ao seu elemento de origem, ou seja, você sempre sabe de onde eles vieram: [Record type] from [API name] ([Tipo de registro] de [nome da API]).

Por exemplo, se você tem um elemento Get Records (Obter registros) que recupera um registro de contato e tem um nome de API Get_Latest_Contact, esse elemento cria uma variável de registro com Contact from Get_Latest_Contact (Contato de Get_Latest_Contact) como rótulo.

Você pode observar que a variável fica visível e pode ser acessada ao longo do fluxo, mesmo que o elemento que a cria esteja no final. Isso se dá pela necessidade técnica de como os fluxos funcionam: todas as variáveis precisam existir do início ao fim. A variável não contém nada até que seu elemento seja executado e recupere os dados.

Vamos ver o elemento Get Records (Obter registros), como ele funciona e como ele cria essa variável para você.

Recuperar valores de um único registro

Você precisa de dados para fazer quase tudo no Flow Builder. Os fluxos podem acessar os dados do seu registro do Salesforce, mas você precisa indicar ao fluxo que dados devem ser obtidos. O fluxo armazena temporariamente os valores de um registro para que eles possam ser usados mais adiante no fluxo.

Para recuperar os dados de um registro do Salesforce, use o elemento Get Records (Obter registros). Confira este vídeo sobre como o elemento Get Records funciona.

Ao recuperar valores do registro, você pode obter todos os valores de campo de um único registro ou de uma coleção de registros. O fluxo armazena os valores recuperados em uma única variável.

Vamos ver um exemplo. A Pyroclastic, Inc. rastreia contatos essenciais em uma oportunidade no objeto Função do contato da oportunidade relacionado. O departamento de vendas quer que os proprietários de oportunidades falem com o contato com a função Tomador de decisão quando uma oportunidade é perdida. Flo pede a você para criar um fluxo que gera uma tarefa quando uma oportunidade de alto valor é perdida. O Tomador de decisão é armazenado não na oportunidade, mas em um objeto diferente: Função do contato da oportunidade. Você precisa que o fluxo recupere o Tomador de decisão da função do contato da oportunidade antes de criar a tarefa.

Vamos esboçar o fluxo antes de você começar a criá-lo.

Primeiro, o fluxo é executado quando uma oportunidade é perdida com Valor acima de 100.000. (Isso é feito com um fluxo acionado por registro que é executado quando uma oportunidade é atualizada e com um requisito de condição: StageName = Fechada perdida.)

Segundo, o fluxo recupera os registros da função de contato da oportunidade que tem Tomador de decisão como Função. (Isso é feito com um elemento Get Records [Obter registros] do objeto Função do contato da oportunidade. No elemento Get Records (Obter registros), você define dois filtros: (1) a Oportunidade da função do contato da oportunidade = a ID da oportunidade acionadora; e (2) a Função na função do contato da oportunidade = Tomador de decisão.)

Terceiro, é melhor você armazenar somente o tomador de decisão mais recente. (Isso é feito com três configurações no elemento Get Records: (1) Quantos registros criar: Somente o primeiro registro; (2) Ordenar por: CreatedDate; e (3) Tipo de ordenação: decrescente.)

Por fim, o fluxo cria uma tarefa que lembra o proprietário da oportunidade de fazer um acompanhamento com o tomador de decisão. (Isso é feito com um elemento Create Records [Criar registros] do objeto Tarefa. Você define valores de campo para a tarefa usando a ID de proprietário da oportunidade, a ID da oportunidade e a ID de contato da função de contato da oportunidade.)

Agora você já pode começar a criar o fluxo.

1. Criar um fluxo acionado por um registro:
   
   • Objeto: Oportunidade
     
   • Acionar o fluxo quando: Um registro é atualizado
     
   • Requisitos de condição: Todas as condições são atendidas (AND)
     
   • Condição:
     
     • Campo: StageName
       
     • Operador: Igual a
       
     • Valor: Fechada e perdida
       
   • Clique em +Add Condition (Adicionar condição):
     
     • Campo: Valor
       
     • Operador: Maior ou igual a 
       
     • Valor: 100000
   • Quando executar o fluxo em registros atualizados: somente quando um registro é atualizado para atender aos requisitos da condição
     
   • Otimize o fluxo para: Ações e registros relacionados
     
2. Na tela do fluxo, no caminho a seguir ao elemento Start (Iniciar), clique em . Selecione Get Records (Obter registros).
   
3. Em Label (Rótulo), insira Get Decision Maker (Obter tomador de decisão).
   Lembre-se, esse nome é usado para rotular a variável gerada, ou seja, é uma boa ideia usar um nome descritivo.
   
4. Em Object (Objeto), selecione Opportunity Contact Role (Função do contato da oportunidade).
   
5. Em Condition Requirements (Requisitos de condição), selecione All Conditions Are Met (AND) (Todas as condições são atendidas (AND)).
   
   
6. Na seção Filter Records (Filtrar registros), defina as condições que indicam ao elemento quais registros devem ser recuperados.
   
   • Primeira condição:
     
     • Campo: OpportunityId
       
     • Operador: Igual a
       
     • Valor: $Record> Id
       
   • Segunda condição:
     
     • Campo: Função
       
     • Operador: Igual a
       
     • Valor: Decision Maker
       

A filtragem de registros em um elemento de fluxo permite a você confirmar que está obtendo somente os registros pretendidos. É semelhante à criação de várias condições e à definição de lógica personalizada em exibições de lista e relatórios.

se o objeto que você está consultando tem vários registros, evite recuperar todos eles, se possível. Você pode acabar editando registros fechados que não deveriam ser alterados e corre o risco de atingir limites de execução que farão o fluxo falhar.

7. Em Sort Order (Tipo de ordenação), selecione Descending (Decrescente).
   
8. Em Sort By (Ordenar por), selecione CreatedDate.
   
9. Em How Many Records to Store (Quantos registros armazenar), selecione Only the first record (Somente o primeiro registro).
   Ao selecionar Only the first record (Somente o primeiro registro), o elemento registrará apenas um registro na variável de saída.
   Quando você seleciona All records (Todos os registros), ele produz todos os registros que atendem às suas condições de filtro.
   
10. Em How to Store Record Data (Como armazenar dados de registro), selecione Automatically store all fields (Armazenar automaticamente todos os campos).
    Essa opção é o padrão e por um bom motivo. Quando essa opção está ativada, o elemento cria automaticamente uma variável de registro para você e armazena os dados nela. Não se preocupe: mesmo que todo o registro esteja armazenado em uma única variável, você ainda poderá recuperar valores de campo individuais conforme a necessidade.
    

Automatically store all fields (Armazenar automaticamente todos os campos) costuma ser sua melhor opção, pois ela reduz seu trabalho e simplifica os dados em uma única variável. Mesmo que você precise somente recuperar um único valor de um registro, provavelmente ultrapassará os limites do fluxo ao armazenar todo o registro. Por outro lado, se o objeto tem algumas centenas de campos personalizados, o aumento da carga pode afetar o desempenho. Nesse caso, selecione Choose fields and let Salesforce do the rest (Escolher campos e deixar o Salesforce fazer o resto) para obter somente os campos necessários.

11. Salve o fluxo. Em Flow Label (Rótulo do fluxo), insira Create Follow-Up with Decision Maker (Criar acompanhamento com tomador de decisão).
    

Como combinar as configurações de quantos registros armazenar e ordenação

No elemento Get Decision Maker (Obter tomador de decisão), você queria encontrar um tomador de decisão e optou por armazenar somente o primeiro registro. Se vários registros corresponderem às condições de filtro, como você pode saber qual será armazenado? Você pode usar as configurações Sort Order (Tipo de ordenação) e Sort By (Ordenar por) para definir qual registro vem primeiro. Você ordenou de forma decrescente conforme a data de criação para que o fluxo retorne a função Tomador de decisão criada mais recentemente.

Agora seu fluxo pode obter as informações de que precisa para criar a tarefa de lembrete. A seguir, você adicionará o elemento Create Records (Criar registros) para criar essa tarefa.

Usar os valores recuperados

Depois que o elemento Get Records (Obter registros) é executado, sua variável contém aqueles dados tão desejados! Agora, os elementos do seu fluxo podem beber esses dados e se nutrir com tudo o que precisa, como um copo de laranjada gelada.

Vamos voltar ao nosso exemplo. O fluxo recupera os dados da função de contato Tomador de decisão, mas ainda precisa criar uma tarefa. Vamos fazer um elemento Create Records (Criar registros). Use a variável criada pelo elemento Get Records (Obter registros) (Opportunity Contact Role [Função do contato da oportunidade] de Get Decision Maker [Obter tomador de decisão]) para definir o contato da tarefa (ID de nome).

1. No fluxo Criar acompanhamento com tomador de decisão, adicione um elemento Create Records (Criar registros) depois do elemento Get Decision Maker (Obter tomador de decisão):
   
   • Rótulo: Create Task (Criar tarefa)
   • Como definir valores de campo de registro: Manualmente.
     
   • Objeto: Tarefa
     
2. Definir os valores de campo para o novo registro de tarefa.
   
   • Campo: Assigned To ID (Atribuído à ID), Valor: Triggering Opportunity (Oportunidade de acionamento)> Owner ID (ID do proprietário) (Role para baixo e selecione o campo Owner ID [ID do proprietário] que não tenha um > no fim da linha.)
     
   • Campo: Priority (Prioridade), Valor: Normal
     
   • Campo: Status, Valor: Não iniciado
     
   • Campo: Subject (Assunto), Valor: Closed Lost Follow-Up (Acompanhamento de Fechada Perdida)
     
   • Campo: Related To ID (Relacionado à ID), Valor: ID da oportunidade
     
   • Campo: Name ID (ID do nome), Valor: (Opportunity Contact Role [Função do contato da oportunidade] de Get Decision Maker [Obter tomador de decisão]) > Contact ID (ID do contato) (Role para baixo e selecione o campo Contact ID (ID de contato) que não tenha um > no fim da linha.)
     
3. Salve o fluxo.
   

Depois da ativação do fluxo, quando uma oportunidade é definida como Fechada perdida, o fluxo cria uma tarefa de acompanhamento na oportunidade e no contato mais recente com a função Tomador de decisão.

Na próxima unidade, você conhecerá os outros elementos que se comunicam com seus usuários.

Recursos

• Recurso - Vídeo do Flow: Obter registros
• Trailhead: Personalização do Lightning Experience
• Trailhead: Relatórios e painéis para o Lightning Experience