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.

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.

Um campo de fórmula em um layout de página, um modo de exibição de lista e um relatório.

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?

Inicie seu Trailhead Playground agora para acompanhar e experimentar as etapas deste módulo. Para abrir seu Trailhead Playground, role até o desafio prático e clique em Iniciar. Você também poderá utilizar o Trailhead Playground quando for necessário concluir os desafios práticos.

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 Oportunidade. Siga estas etapas para navegar até o editor de fórmula.

  1. Em Configuração, abra o Gerenciador de objetos e clique em Oportunidade.
  2. Na barra lateral à esquerda, clique em Campos e relacionamentos.
  3. Clique em Novo.
  4. Selecione Fórmula e clique em Avançar.
  5. Em Rótulo do campo, digite Meu campo de fórmula. Observe que o 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 Moeda. Por enquanto, selecione Texto.
  7. Clique em 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.
Exibição do editor de fórmula com identificações.
  1. Existem dois tipos de editor de fórmula: Simples e Avançado. É tentador usar o editor Simples, mas sempre recomendamos usar o editor Avançado. Avançado não significa mais complicado. Significa mais ferramentas para que você crie fórmulas potentes.
  2. O botão 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. O menu Inserir campo.
  3. O botão Inserir operador abre uma lista suspensa com os operadores matemáticos e lógicos disponíveis. O menu Inserir operador.
  4. O menu 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. O menu Funções.
  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.
    • As 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 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 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 Iniciador de aplicativos Iniciador de aplicativose selecione Contatos. Em seguida, vá para a guia Contatos e clique em Novo. Insira qualquer valor para o sobrenome. Em Nome da conta, insira uma conta existente, como United Oil & Gas Corp. Clique em Salvar. Em seguida, criamos uma fórmula para exibir o número da conta na página Contato.

  1. Em Configuração, abra o Gerenciador de objetos e clique em Contato.
  2. Na barra lateral à esquerda, clique em Campos e relacionamentos.
  3. Clique em Novo.
  4. Para o tipo de campo, selecione Fórmula e, em seguida, clique em Avançar.
  5. Nomeie seu campo Número da conta e selecione Texto para o tipo de retorno da fórmula. Clique em Avançar.
  6. No Editor de fórmula avançado, clique em Inserir campo. Selecione Contato | Conta | Número da conta e clique em Inserir. Clique em Verificar sintaxe. Se não houver erros de sintaxe, clique em 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.
    A fórmula de Contato de objetos cruzados. Número da conta (texto) = Account.AccountNumber

  7. Clique em Avançar para aceitar as configurações de segurança em nível de campo e clique em 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 Contato que você acaba de criar e encontre seu novo campo de fórmula 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, clique em Iniciador de aplicativos e selecione Oportunidades. Vá para a guia Oportunidades e clique em Nova. Preencha um valor para o Nome da oportunidade, selecione uma Fase e defina uma data de fechamento a partir de daqui a 3 dias. Clique em Salvar.

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

  1. Em Configuração, abra o Gerenciador de objetos e clique em Oportunidade.
  2. Na barra lateral à esquerda, clique em Campos e relacionamentos.
  3. Clique em Novo.
  4. Selecione Fórmula e, em seguida, clique em Avançar.
  5. Na área de texto Rótulo do campo, digite Dias até o fechamento.
  6. Selecione o botão de opção Número.
  7. Clique em 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 Inserir campo e selecione Oportunidade | Data de fechamento e clique em Inserir
    • No menu Inserir operador, selecione - 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 Funções, ao lado direito do editor, selecione TODAY.
    • Clique em Inserir função selecionada
  10. Clique em Verificar sintaxe. Se não houver erros de sintaxe, clique em Avançar.
    A fórmula dos dias até o fechamento. Dias até o fechamento (número) = CloseDate -Today()
  11. Clique em Avançar para aceitar as configurações de segurança em nível de campo e clique em Salvar.

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

  1. Em Iniciador de aplicativos, abra a guia Relatórios e clique em Novo relatório.
  2. Insira Oportunidades no campo Tipos de relatório de pesquisa... Selecione Oportunidades e clique em Continuar. Sua oportunidade aparece no painel de Visualização do relatório.
  3. Verifique se a opção Atualizar visualização automaticamente está ativada.
  4. No campo Adicionar coluna..., no lado esquerdo da página, insira 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.

Exemplo 3: Encontre objetos distintos usando a fórmula Power of One

As organizações com frequência querem contar o número de objetos distintos em um relatório com centenas de registros. Digamos, por exemplo, que você tenha cem oportunidades listadas em um relatório, mas elas pertençam a uns poucos usuários. Como você encontra o número de usuários distintos? Essa tarefa soa difícil, mas é uma das fórmulas mais fáceis que você pode escrever. Ela se chama Power of One.

Para escrever essa fórmula, crie um campo de fórmula personalizado no objeto Usuário. Nomeie-o Usuários exclusivos, dê a ele um tipo de retorno de Número e selecione 0 na lista suspensa de Casas decimais. Clique em Avançar para abrir o editor de fórmula. Para essa fórmula, você não precisa inserir nenhum campo, operador ou função. Em vez disso, insira o número 1.

Essa é a fórmula Power of One. Usuários únicos (número) = 1

É, é isso mesmo! Salve sua fórmula, como de costume; depois, clique na guia Relatórios para vê-la em ação. Crie um relatório de oportunidades e verifique se Atualizar visualização automaticamente está ativada. No campo Adicionar coluna..., no lado esquerdo da página, insira Usuários exclusivos para adicionar uma coluna com o novo campo no relatório. Você deve visualizar algo semelhante ao seguinte (seu relatório pode parecer diferente, dependendo das colunas exibidas).

Coluna Relatório com usuários exclusivos

Temos aqui cinco oportunidades entre dois usuários distintos. Onde entra nossa fórmula? Na coluna Usuários exclusivos, clique no menu suspenso, selecione Resumir e, em seguida, Soma.

Menu suspenso com Resumo e Soma selecionados

O número de usuários distintos aparece na parte de baixo da coluna. Como você pode ver, mesmo fórmulas simples oferecem percepções importantes à sua organização.

Relatório mostrando o número total de usuários exclusivos
Nota

Nota

Você pode usar a fórmula Power of One em qualquer objeto. Por exemplo, se você tivesse um relatório com 10 contas, cada uma delas com três oportunidades, seu relatório de Oportunidades retornaria 30 registros. Adicionar o campo de fórmula Power of One a Conta permite que você veja o número de contas distintas representadas nos registros. Alguns profissionais afirmam adicionar um campo Power of One a cada objeto em suas organizações!

Depurar fórmulas

Erros de sintaxe são uma parte inevitável de trabalhar com fórmulas. O botão 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 decompor a função em várias linhas para que seja mais fácil descobrir quais conjuntos de parênteses estão ligados uns aos outros.  Uma fórmula com parênteses faltando. Fórmula Minha conta (número) = LEN (Name Você também verá esse erro caso se esqueça da vírgula entre dois parâmetros de 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.Uma fórmula que está sem uma vírgula, mas o erro de sintaxe diz que está faltando um parêntese. Fórmula Minha conta (número) = RIGHT (“Eu amo fórmulas!” 3)
  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. Uma fórmula com um tipo de parâmetro incorreto: Texto esperado, Número recebido. Fórmula Minha conta (número) = LEN(123456)
  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. Uma fórmula com parâmetros a mais. Esperava 1, recebeu 2. Fórmula Minha conta (número) = ABS(-18, 2)
  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. Uma fórmula que retorna um resultado cujo tipo de dado é incorreto. Esperava um número, mas o resultado da fórmula é uma data. Fórmula Minha conta (número) - TODAY()
  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 Inserir campo para ter certeza de que você está fazendo a referência correta. Uma fórmula com nome de campo escrito incorretamente. Fórmula Minha conta (número) = LEN ( AcountNumber ) Outro motivo para encontrar esse erro é quando você se esquece de colocar as aspas em torno de um texto literal ou hiperlink. Uma fórmula sem as aspas apropriadas. O erro de sintaxe diz que o campo Hello não existe e sugere que você verifique a ortografia. Fórmula Minha conta (número) = LEN(Hello)
  6. Função desconhecida: Nesse caso, confira se o Salesforce é compatível com as funções usadas. Esse erro também é mostrado no caso de funções escritas incorretamente. Uma fórmula com função incompatível. Fórmula Minha conta (número) = FAKEFUNCTION()

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. Uma fórmula de hiperlink. Site da conta (texto)= HYPERLINK("http://www.VeryImportantWebsite.com", "Site muito importante")
  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 com a função ROUND(). Uma fórmula que inclui a função ROUND(). Valor descontado (número)= Round( Amount - (Valor * 0.12), 2 )
  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. Uma fórmula que use a função lógica AND(). Grande oportunidade? (Caixa de seleção)= AND( Account.NumberOfEmployees > 1000, Amount > 1000)

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

Continue a aprender de graça!
Inscreva-se em uma conta para continuar.
O que você ganha com isso?
  • Receba recomendações personalizadas para suas metas de carreira
  • Pratique suas habilidades com desafios práticos e testes
  • Monitore e compartilhe seu progresso com os empregadores
  • Conecte-se a orientação e oportunidades de carreira