Campos calculados: valores que se calculam sozinhos

Um campo calculado não é preenchido manualmente. O seu valor resulta de uma fórmula que lê outros campos. Serve para calcular totais, montantes com IVA, descontos, diferenças entre datas e etiquetas construídas a partir de vários valores.

O cálculo é sempre feito pelo servidor. O navegador mostra o resultado e a pré-visualização, mas não recalcula nada. O valor guardado é aquele que o servidor calculou.

Escrever a fórmula

A fórmula compõe-se com os tokens dos campos. No configurador, insere a referência a um campo (@{…}) em vez de escrever o identificador à mão. Nem todos os campos são referenciáveis: anexos, progressivos e outros campos calculados ficam de fora. Um campo calculado que depende de outro tornaria a cadeia difícil de ler e corrigir.

Operadores

Funções

Função O que faz
ROUND(valor, casas) Arredonda para um número de casas de 0 a 8
IF(condição, então, senão) Escolhe um ramo; avalia apenas o escolhido
SUM(a, b, …) Soma vários valores
DAYS_BETWEEN(data1, data2) Dias entre duas datas

Os textos escrevem-se entre aspas ("Alta"), os números como números, e null representa a ausência de valor.

O tipo do resultado

Não escolhes se o resultado é um número, um texto, um booleano ou uma data. O servidor deduz o tipo da fórmula e mostra-o no configurador. Um campo calculado que soma montantes é um número; um que concatena textos é um texto; uma comparação é um sim/não. Para os resultados numéricos, podes escolher a precisão.

Isto evita uma contradição comum: uma fórmula que produz texto ser declarada como número e, por isso, não ser guardada.

As regras de tipo na prática

Exemplos úteis

Total com IVA

ROUND(@{base} * (1 + @{taxa}), 2)

com @{taxa} um campo percentual (22 = 22 %).

Desconto

ROUND(@{preço} - (@{preço} * @{desconto}), 2)

Etiqueta

IF(@{quantidade} > 10, "Encomenda grande", "Encomenda pequena")

Dias até ao vencimento

DAYS_BETWEEN(@{data_vencimento}, @{data_referencia})

Pré-visualização, gravação e atualização

O editor valida a fórmula com o servidor e mostra o resultado da pré-visualização. Se a fórmula for inválida, se a pré-visualização estiver em curso ou falhar, a gravação fica bloqueada. Não se guarda uma fórmula cujo resultado não se conhece.

Depois de guardado, o campo recalcula-se quando muda um campo de que depende. As instâncias já iniciadas não são recalculadas enquanto uma dependência não mudar. Um cálculo não deve reescrever sozinho dados históricos.

Limites e segurança

A gramática é fechada: não há código arbitrário, nem acesso à base de dados ou ao navegador. Há limites para o comprimento da expressão, o número de referências e a profundidade da fórmula. Ultrapassá-los é um erro explícito, não um truncamento silencioso.

Erros comuns

Mensagem O que significa
Fórmula inválida Há um erro de sintaxe ou uma referência inexistente
Tipo incompatível Estás a somar texto e número, ou a usar uma data onde é preciso um número
Divisão por zero O divisor é zero: muitas vezes é um campo vazio usado como divisor
Dados em falta Uma dependência não está preenchida: o resultado fica vazio

Escreve a fórmula pensando nos tipos dos campos que tocas, não apenas no resultado que queres obter.

Pontos-chave

Calcula totais, montantes e datas diretamente nos teus processos, sem escrever código: flowenti.com