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
- Aritmética:
+,-,*,/ - Comparações:
=,!=,<,<=,>,>=(no máximo uma por fórmula) - Parênteses e sinal unário (
-)
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
+é numérico só se o forem todas as parcelas. Caso contrário, concatena:@{nome} + " " + @{apelido}produz o nome completo;"007" + 1produz"0071"porque"007"é texto. Um campo de texto fica como foi escrito.-,*e/exigem números. As cadeias que representam inteiros são lidas como números; um texto não numérico é um erro, não um zero.- As datas comportam-se como datas: uma data mais um número desloca-a esses dias; uma data menos uma data dá os dias de diferença. Duas datas somadas concatenam as suas formas ISO.
- As percentagens valem a fração: um campo percentual com
22(22 %) numa fórmula vale0,22. Por isso,@{preço} * (1 + @{iva})aplica o IVA corretamente, sem dividir à mão. - O vazio continua vazio. Se um campo referenciado não está preenchido, o resultado é «Dados em falta», não zero. Zero é um valor que alguém escolheu; a ausência não.
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
- Um campo calculado não se preenche: o seu valor é o resultado de uma fórmula que lê outros campos.
- O cálculo é feito sempre pelo servidor; o navegador mostra apenas o resultado e a pré-visualização.
- O tipo do resultado (número, texto, booleano, data) é deduzido da fórmula, não escolhido manualmente.
- O vazio continua vazio: uma dependência não preenchida dá «Dados em falta», não zero.
- A gramática é fechada: não há código arbitrário, nem acesso à base de dados ou ao navegador.
Calcula totais, montantes e datas diretamente nos teus processos, sem escrever código: flowenti.com