Usar campos de fórmula

Objetivos de aprendizagem

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

• Criar um campo de fórmula personalizado e usar o editor de fórmulas.
  
• Explicar por que os campos de fórmula são úteis.
  
• Descrever pelo menos um caso de uso dos campos de fórmula.
  
• Criar fórmulas simples.
  

Nota

Deseja aprender em português (Brasil)? Comece o desafio em um Trailhead Playground de português (Brasil) e copie e cole os valores de português (Brasil). 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.

Acessibilidade

Esta unidade requer algumas instruções adicionais para usuários de leitores de tela. Para acessar uma versão detalhada do leitor de tela desta unidade, clique no link abaixo:

Abrir as instruções do leitor de tela do Trailhead.

Introdução aos campos de fórmula

Há muitos dados em sua organização. Os usuários precisam acessar e entender esses dados de forma rápida, sem terem de fazer um monte de cálculos de cabeça. Apresentamos os campos de fórmula, a ferramenta poderosa que lhe permite ter controle sob a forma como seus dados são exibidos.

Digamos que você queira pegar dois campos numéricos de um registro e dividi-los para criar uma porcentagem. Ou talvez queira transformar um campo em um hiperlink clicável para facilitar o acesso a informações importantes no layout de página de um registro. Talvez você queira pegar duas datas e calcular o número de dias entre elas. Usando campos de fórmula, você pode fazer tudo isso e muito mais.

Vejamos um exemplo específico. E se você quisesse calcular quantos dias faltam até a data de fechamento de uma oportunidade? É possível criar um campo de fórmula simples que calcule esse valor automaticamente. Ao adicionar o valor ao layout de página Oportunidade, seus usuários podem acessar rapidamente essas informações importantes. Você também pode adicionar esse campo a relatórios e modos de exibição de lista para ter acesso imediato.

Quando você está começando a aprender fórmulas, é melhor começar com cálculos simples e ir aumentando a dificuldade até cenários mais complexos. Mas mesmo fórmulas simples podem fornecer informações valiosas.

Esta unidade apresenta os conceitos básicos relativos ao uso do editor de fórmula, e você conhecerá a sintaxe de fórmulas por meio de vários exemplos básicos. Também falamos sobre a solução de problemas com campos de fórmula. Agora vamos nos divertir um pouco!

Preparado para começar a trabalhar com fórmulas?

Crie um novo Trailhead Playground agora para acompanhar e experimentar as etapas deste módulo. Role até o final desta página, clique no nome do playground e selecione Criar Playground. Normalmente, demora de dois a três minutos para o Salesforce criar seu Trailhead Playground. Você também poderá utilizar o Trailhead Playground quando for necessário concluir os desafios práticos.

Sim, estamos falando de um Trailhead Playground totalmente novo! Se você estiver usando uma organização ou um Trailhead Playground existente, poderá ter problemas na hora de concluir os desafios.

Encontre o editor de fórmula

Antes de mergulhar na redação de fórmulas, vamos localizar o editor de fórmula e conhecer seus recursos.

É possível criar campos de fórmula personalizados em qualquer objeto padrão ou personalizado. Para começar, criaremos uma fórmula no objeto Opportunity (Oportunidade). Siga estas etapas para navegar até o editor de fórmula.

1. Em Setup (Configuração), abra o Object Manager (Gerenciador de objetos) e clique em Opportunity (Oportunidade).
   
2. Na barra lateral à esquerda, clique em Fields & Relationships (Campos e relacionamentos).
   
3. Clique em New (Criar).
   
4. Selecione Formula (Fórmula) e clique em Next (Avançar).
   
5. Em Field Label (Rótulo do campo), digite My Formula Field (Meu campo de fórmula). Observe que o Field Name (Nome do campo) é preenchido automaticamente.
   
6. Selecione o tipo de dado que você espera que a fórmula retorne. Por exemplo, se quiser escrever uma fórmula que calcule a comissão que o vendedor recebe de uma venda, selecione Currency (Moeda). Por enquanto, selecione Text (Texto).
   
7. Clique em Next (Avançar). Você chegou ao editor de fórmula! É hora do tour.
   

Use o editor de fórmula

Esta imagem destaca as partes mais importantes do editor de fórmula.

1. Existem dois tipos de editor de fórmula: Simple (Simples) e Advanced (Avançado). É tentador usar o editor Simple (Simples), mas sempre recomendamos usar o editor Advanced (Avançado). Avançado não significa mais complicado. Significa mais ferramentas para que você crie fórmulas potentes.
   
2. O botão Insert Field (Inserir campo) abre um menu que permite selecionar os campos a serem usados na fórmula. A inserção feita por esse menu gera automaticamente a sintaxe certa para acessar os campos.
    
   
3. O botão Insert Operator (Inserir operador) abre uma lista suspensa dos operadores matemáticos e lógicos disponíveis.
   
   
4. O menu Functions (Funções) é onde você vê e insere as funções de fórmula. As funções são operações mais complicadas previamente implementadas pelo Salesforce. Algumas funções podem ser usadas do jeito que estão (por exemplo, a função TODAY() retorna a data de hoje), enquanto outras exigem mais informações, que são chamadas de parâmetros. A função LEN(text), por exemplo, descobre a quantidade de texto inserida como parâmetro. A fórmula LEN("Hello") retorna o valor 5.
   
   
5. A área de texto é o local onde você digita sua fórmula. Ao escrever fórmulas, lembre-se de que:
   

• Os espaços em branco não são considerados. Você pode inserir quantos espaços e quebras de linha quiser sem afetar a execução da fórmula.
  
• Certos aspectos das fórmulas diferenciam maiúsculas de minúsculas. Preste atenção no uso de maiúsculas e minúsculas nos nomes de campos e objetos.
  
• Ao trabalhar com números, a ordem padrão das operações é aplicada.
  

6. Depois de escrever a fórmula, é possível usar o botão Check Syntax (Verificar sintaxe) para ter certeza de que tudo está funcionando antes de salvar. Caso haja algum problema na fórmula, o verificador de sintaxe alerta quanto aos problemas específicos.
   

Não precisamos continuar a criar esse campo de fórmula; clique em Cancel (Cancelar). Agora que você já aprendeu algumas coisas, vamos usar o editor com alguns exemplos simples.

Exemplo 1: Exiba um campo de conta na página de detalhes de contato

As páginas de detalhes de registro contêm um monte de informações, mas às vezes isso não é suficiente. Às vezes, você precisa de mais! Para sua primeira fórmula, vamos fazer algo simples. Vamos pegar um único campo de uma Conta e mostrá-lo em um Contato usando a chamada fórmula de objetos cruzados. Vamos dar uma olhada.

Primeiramente, crie um Contato. Se você nunca criou um Contato antes, clique no App Launcher (Iniciador de aplicativos) (), encontre e selecione Contacts (Contatos). Clique em Novo. Insira qualquer valor para o sobrenome. Em Account Name (Nome da conta), insira uma conta existente, como United Oil & Gas Corp. Clique em Save (Salvar). Em seguida, criamos uma fórmula para exibir o número da conta na página Contact (Contato).

1. Em Setup (Configuração), abra o Object Manager (Gerenciador de objetos) e clique em Contact (Contato).
   
2. Na barra lateral à esquerda, clique em Fields & Relationships (Campos e relacionamentos).
   
3. Clique em New (Criar).
   
4. Para o tipo de campo, selecione Formula (Fórmula) e, em seguida, clique em Next (Avançar).
   
5. Nomeie seu campo Account Number (Número da conta) e selecione Text (Texto) para o tipo de retorno da fórmula. Clique em Next (Avançar).
   
6. No Advanced Formula Editor (Editor de fórmula avançado), clique em Insert Field (Inserir campo). Selecione Contact (Contato) | Account (Conta) | Account Number (Número da conta) e clique em Insert (Inserir). Clique em Check Syntax (Verificar sintaxe). Se não houver erros de sintaxe, clique em Next (Avançar). É improvável que você encontrará um erro de sintaxe em uma fórmula simples como esta, mas é uma boa ideia ter o hábito de verificar a sintaxe de cada fórmula.
   
   
7. Clique em Next (Avançar) para aceitar as configurações de segurança em nível de campo e clique em Save (Salvar).
   

Parabéns, você escreveu sua primeira fórmula! Agora é hora de ver o que você fez. Abra a página de detalhes para o objeto Contact (Contato) que você acabou de criar e encontre seu novo campo de fórmula Account Number (Número da conta). Legal!

Exemplo 2: Exiba o número de dias até o fechamento de uma oportunidade em um relatório

Você também pode usar campos de fórmula em relatórios para aumentar a visibilidade de informações importantes. Digamos, por exemplo, que você queira uma coluna de relatório que exiba o número de dias até o fechamento de uma oportunidade. Em primeiro lugar, crie uma Oportunidade para testar nossa fórmula.

Se você nunca criou uma Oportunidade antes, no App Launcher (Iniciador de aplicativos) (), encontre e abra Opportunities (Oportunidades). Clique em Novo. Preencha um valor para Opportunity Name (Nome da oportunidade), selecione uma Stage (Fase) e defina uma data de fechamento a partir de daqui a 3 dias. Clique em Save (Salvar).

Em seguida, execute essas etapas para criar um campo de fórmula personalizado chamado Days to Close (Dias até o fechamento) no objeto Opportunities (Oportunidades), com um tipo de retorno Number (Número).

1. Em Setup (Configuração), abra o Object Manager (Gerenciador de objetos) e clique em Opportunity (Oportunidade).
   
2. Na barra lateral à esquerda, clique em Fields & Relationships (Campos e relacionamentos).
   
3. Clique em New (Criar).
   
4. Selecione Formula (Fórmula) e, em seguida, clique em Next (Avançar).
   
5. Na área de texto Field Label (Rótulo do campo), digite Days to Close (Dias até o fechamento).
   
6. Selecione o botão de opção Number (Número).
   
7. Clique em Next (Avançar) para abrir o editor de fórmula.
   
8. Para encontrar a diferença entre a data de fechamento da oportunidade e a data de hoje, subtraia uma da outra.
   

• Clique em Insert Field (Inserir campo) e selecione Opportunity (Oportunidade) | Close Date (Data de fechamento) e clique em Insert (Inserir).
  
• No menu Insert Operator (Inserir operador), selecione - Subtract (Subtrair).
  

9. Mas como dizemos à nossa fórmula que precisamos da data de hoje? Felizmente, há uma função chamada TODAY() que atualiza para a data atual.
   

• No menu Functions (Funções), ao lado direito do editor, selecione TODAY.
  
• Clique em Insert Selected Function (Inserir função selecionada). 
  

10. Clique em Check Syntax (Verificar sintaxe). Se não houver erros de sintaxe, clique em Next (Avançar).
    
    
11. Clique em Next (Avançar) para aceitar as configurações de segurança em nível de campo e clique em Save (Salvar).
    

Agora é hora de colocar seu novo campo de fórmula em um relatório. 

1. No App Launcher (Iniciador de aplicativos) (), encontre e abra Reports (Relatórios), e clique em New Report (Novo relatório).
   
2. Insira Opportunities (Oportunidades) no campo Search Report Types... (Tipos de relatório de pesquisa) Selecione Opportunities (Oportunidades) e clique em Start Report (Iniciar relatório). Sua oportunidade aparece no painel Report Preview (Visualização do relatório).
   
3. Verifique se a opção Update Preview Automatically (Atualizar visualização automaticamente) está ativada.
   
4. No campo Add column... (Adicionar coluna...), no lado esquerdo da página, insira Days to Close (Dias até o fechamento).  Esse campo é o campo de fórmula que você acaba de criar. Uma coluna com o campo que contém o valor calculado é adicionada automaticamente ao relatório.
   

Você não precisará do relatório novamente para esta unidade. Você pode descartá-lo e passar para o próximo exemplo.

Depurar fórmulas

Erros de sintaxe são uma parte inevitável de trabalhar com fórmulas. O botão Check Syntax (Verificar sintaxe) do editor é uma ferramenta importante para depurar suas fórmulas. O verificador de sintaxe conta quais erros foram encontrados e em qual ponto da fórmula eles estão localizados. Aqui estão alguns problemas comuns de sintaxe.

1. Falta de parênteses: Esse erro costuma acontecer quando o número de parênteses abertos não corresponde ao número de parênteses fechados. Pode ser especialmente difícil evitar esse problema se você usa várias funções de uma vez só. Tente dividir sua função em várias linhas para que seja mais fácil ver quais pares de parênteses são correspondentes.
   
   Você também verá esse erro se esquecer de colocar uma vírgula entre dois parâmetros de uma função. Esse erro é complicado porque o problema real não corresponde ao verificador de sintaxe. Caso tenha certeza de que os parênteses estão certos, confira se as vírgulas da função também estão corretas.
   
   
2. Tipo de parâmetro incorreto: Se você informar à função um parâmetro numérico quando ela esperar texto (ou outra combinação de tipos de dados), esse erro aparece. Sempre verifique o texto ou a documentação de ajuda para saber que tipos de parâmetro a função aceita.
   
   
3. Número incorreto de parâmetros para a função: Se você inserir parâmetros a mais ou poucos parâmetros em uma função, o verificador de sintaxe emitirá um alerta. Mais uma vez, confira o texto ou a documentação de ajuda para ver orientações de como inserir parâmetros em funções específicas.
   
   
4. Resultado da fórmula incompatível com o tipo de retorno da fórmula: Você visualiza esse erro se selecionar um tipo de dados quando cria o campo de fórmula, mas escrever uma fórmula que retorne outro tipo de dados. No exemplo abaixo, é possível ver que a Fórmula Minha conta espera retornar um número (mostrado nos parênteses próximos ao nome da fórmula), mas a função TODAY() retorna uma data. O erro informa qual é o tipo de dado esperado, mas você pode consultar a documentação com antecedência para evitar esse erro.
   
   
5. Campo não existe: Esse erro indica que você incluiu na sua fórmula um campo incompatível com o seu objeto. Nesse caso, confira a grafia e o uso de maiúsculas e minúsculas. Caso não consiga encontrar nenhum erro, tente inserir novamente o campo do menu Insert Field (Inserir campo) para ter certeza de que você está fazendo a referência correta.
   
    
   Outro motivo para encontrar esse erro é quando você se esquece de colocar as aspas em torno de um texto literal ou hiperlink.
   
   
6. Função desconhecida: Nesse caso, confira se o Salesforce é compatível com as funções usadas. Esse erro também ocorre para funções escritas incorretamente.
   
   

Outros exemplos

Vamos ver mais alguns exemplos. Você pode criar essas fórmulas sozinho ou simplesmente fazer uma leitura.

1. Esta fórmula cria um hiperlink para um site externo usando a função HYPERLINK(). Adicionar hiperlinks a layouts de página ajuda seus usuários a acessar rapidamente informações importantes das páginas de detalhes.
   
   
2. Se quiser aplicar um desconto ao valor de uma oportunidade, você pode usar a fórmula a seguir. Neste caso, estamos aplicando um desconto de 12% e depois arredondando o resultado para duas casas decimais usando a função ROUND().
   
   
3. Essa fórmula é uma caixa de seleção que define se determinada oportunidade é uma “grande” oportunidade. Ela verifica se o número de funcionários na empresa associada à conta de oportunidade é maior que 1.000 E se o valor da oportunidade é superior a US$ 10.000. Se ambas as afirmações forem verdadeiras, o campo aparece como uma caixa marcada no layout de página Oportunidade. Caso contrário, ele aparece como uma caixa em branco.
   
   

A documentação de fórmulas contém inúmeros exemplos para os mais variados casos de uso. Enquanto navega pelos exemplos, tenha em mente que muitos deles contêm conceitos avançados que não foram abordados nesta unidade. Você precisa estar confortável com a informação aqui apresentada antes de lidar com essas fórmulas.

Recursos

• Ajuda do Salesforce: Calcular valores de campo com fórmulas
• PDF: Referência rápida de fórmulas