Descubra como a nova funcionalidade piloto do Summer ’26 permite expressar regras de negócio diretamente na cláusula WHERE, reduzindo a necessidade de campos de fórmula e código Apex
Introdução
Em 2026, o ecossistema Salesforce continua evoluindo para tornar o desenvolvimento mais eficiente e menos dependente de alterações de esquema. Uma das novidades mais aguardadas da release Summer ’26 é a funcionalidade piloto SOQL FORMULA(), que permite inserir expressões de fórmula diretamente na cláusula WHERE de uma consulta SOQL. Isso significa que você pode filtrar linhas com base em cálculos personalizados sem precisar criar campos de fórmula adicionais ou processar os resultados em Apex.
Para desenvolvedores, administradores e equipes de integração, essa funcionalidade representa uma mudança significativa: regras de negócio que antes exigiam campos temporários ou loops em Apex agora podem ser expressas de forma declarativa e reutilizável. Neste artigo, exploramos como o SOQL FORMULA() funciona, seus casos de uso práticos e como você pode começar a usá-lo em seu ambiente Salesforce.
O Que é SOQL FORMULA()?
SOQL FORMULA() é uma nova sintaxe piloto introduzida na Summer ’26 que permite adicionar expressões de fórmula diretamente na cláusula WHERE de uma consulta SOQL. Essas expressões são avaliadas em tempo de execução para cada linha, permitindo filtrar dados com base em cálculos complexos sem alterar o esquema do objeto.
Por que isso é importante?
Tradicionalmente, para filtrar registros com base em cálculos, os desenvolvedores tinham três opções:
- Criar campos de fórmula: Adicionar campos de fórmula ao objeto, o que pode poluir o esquema e aumentar a complexidade de manutenção.
- Processamento em Apex: Recuperar todos os registros e filtrar em loops Apex, o que pode ser ineficiente e consumir recursos.
- Consultas amplas: Recuperar grandes conjuntos de dados e descartar os que não atendem aos critérios, desperdiçando tempo e recursos.
Com SOQL FORMULA(), a regra de negócio fica acoplada à consulta, tornando-a mais legível, reutilizável e eficiente.
Sintaxe Básica
A sintaxe geral é:
WHERE FORMULA('expressão') //operador valor
Por exemplo:
SELECT Id, Name FROM Order__c WHERE FORMULA('Revenue__c - Cost__c') > 250
Neste exemplo, a expressão Revenue__c - Cost__c é avaliada para cada registro, e apenas os registros onde o resultado é maior que 250 são retornados.
Casos de Uso Práticos
Vamos explorar três casos de uso comuns em um cenário de e-commerce.
Cenário: E-commerce Order Management
Imagine que você está construindo um dashboard de análise de pedidos para uma plataforma de e-commerce. O objeto Order__c contém os seguintes campos:
Revenue__c(Currency): Valor total do pedidoCost__c(Currency): Custo de cumprimentoOrderDate__c(Date): Data do pedidoShipDate__c(Date): Data de envioStatus__c(Text): Status do pedido
1. Encontrar pedidos de alta rentabilidade (aritmética de moeda)
Requisito de negócio: Identificar pedidos com lucro superior a $250 para revisão de cumprimento prioritário.
Sem SOQL FORMULA():
List allOrders = [
SELECT Id, Name, Revenue__c, Cost__c
FROM Order__c
WHERE Status__c = 'Shipped'
];
List highProfitOrders = new List();
for (Order__c order : allOrders) {
if (order.Revenue__c != null &&
order.Cost__c != null && (order.Revenue__c - order.Cost__c) > 250) {
highProfitOrders.add(order);
}
}
Com SOQL FORMULA():
SELECT Id, Name, Revenue__c, Cost__c
FROM Order__c
WHERE Status__c = 'Shipped'
AND FORMULA('Revenue__c - Cost__c') > 250
O resultado é mais limpo, mais eficiente e não requer processamento adicional em Apex.
2. Detectar envios atrasados (aritmética de data e hora)
Requisito de negócio: Encontrar pedidos que foram enviados mais de três dias após a data do pedido para análise de SLA.
SELECT Id, Name, OrderDate__c, ShipDate__c
FROM Order__c
WHERE FORMULA('ShipDate__c - OrderDate__c') > 3
A expressão calcula a diferença em dias entre a data de envio e a data do pedido, retornando apenas os pedidos que excedem o limite de três dias.
3. Filtrar por critérios de pedido premium (condições combinadas)
Requisito de negócio: Encontrar pedidos “premium”: alta receita (>$600) E envio rápido (≤ 2 dias).
SELECT Id, Name, Revenue__c, OrderDate__c, ShipDate__c
FROM Order__c
WHERE Revenue__c > 600
AND FORMULA('ShipDate__c - OrderDate__c') <= 2
Essa consulta combina um filtro de campo padrão com uma expressão de fórmula, resultando em um conjunto de dados preciso sem a necessidade de campos adicionais.
Implementação Prática
Pré-requisitos – A funcionalidade SOQL FORMULA() está em fase piloto na Summer ’26. – Para habilitar, entre em contato com seu Account Executive ou Customer Success Manager da Salesforce. – Teste em um ambiente de sandbox antes de usar em produção.
Limitações Atuais – Apenas suportado na cláusula WHERE (não em HAVING). – Expressões suportadas: adição, subtração, comparação. – Tipos de dados compatíveis: DOUBLE, INTEGER, DATETIME, DATE, CURRENCY. – INTEGER se comporta como DOUBLE; DATE se comporta como DATETIME.
Exemplo de Código Completo – Aqui está um exemplo completo de consulta SOQL usando FORMULA() para filtrar pedidos com lucro maior que $250:
SELECT Id, Name, Revenue__c, Cost__c FROM Order__c WHERE Status__c = 'Shipped' AND FORMULA('Revenue__c - Cost__c') > 250
Execute essa consulta no Developer Console, Workbench ou via API.
Impacto para Empresas e Desenvolvedores
Para Empresas
- Redução de custos de manutenção: Menos campos de fórmula redundantes.
- Melhoria na performance: Filtragem no nível da consulta, reduzindo o volume de dados transferidos.
- Agilidade na adaptação: Regras de negócio podem ser atualizadas diretamente nas consultas.
Para Desenvolvedores
- Código mais limpo: Elimina loops Apex para filtragem.
- Reutilização: Expressões de fórmula podem ser compartilhadas entre consultas.
- Legibilidade: A lógica de negócio fica visível no código SOQL, facilitando revisões.
Considerações e Boas Práticas
- Teste em sandbox: Sempre valide a sintaxe e o desempenho em um ambiente não production.
- Monitore o desempenho: Embora a filtragem no banco de dados seja eficiente, consultas complexas podem impactar o tempo de execução.
- Documente as expressões: Mantenha a documentação das expressões de fórmula usadas para facilitar a manutenção.
- Considere a governança: Para ISVs, lembre-se de que SOQL FORMULA() permite filtrar sem alterar o esquema do cliente, o que é uma grande vantagem.
Tendências Futuras
A piloto de SOQL FORMULA() é um primeiro passo para uma maior expressividade nas consultas SOQL. Futuras versões podem expandir o suporte para:
- Operadores adicionais (multiplicação, divisão, funções matemáticas).
- Uso em outras cláusulas (HAVING, ORDER BY).
- Suporte a funções de data/hora mais complexas.
Mantenha-se atento às atualizações da Salesforce nas release notes.
Conclusão
SOQL FORMULA() representa uma evolução significativa na forma como escrevemos consultas no Salesforce. Ao permitir expressões de fórmula diretamente na cláusula WHERE, essa funcionalidade reduz a necessidade de campos temporários e código Apex, tornando as consultas mais eficientes e fáceis de manter.
Para desenvolvedores e administradores, a adoção dessa funcionalidade pode resultar em ganhos de produtividade imediatos. Comece testando em um sandbox e experimente expressões de fórmula para resolver problemas reais de filtragem.
Call to Action: Entre em contato com seu Account Executive da Salesforce para solicitar acesso ao piloto de SOQL FORMULA() e comece a simplificar suas consultas hoje mesmo.