Sintaxe de fórmulas

Para que serve o editor de fórmulas

O editor de fórmulas permite-lhe construir um cálculo personalizado a partir de tokens escritos — operadores, números e referências a linhas, fatores, subposições e KPIs. O mesmo editor, a mesma sintaxe, em todos os métodos de Fórmula em qualquer parte da aplicação: linhas de Planeamento, fatores de Planeamento, KPIs e dashboards personalizados.

Tokens

Uma fórmula é uma sequência plana de tokens. A grelha apresenta cada token como um chip; Backspace num campo vazio remove o último chip.

Números

Escreva qualquer número (100, 0.05, -1.2) e prima Enter para o inserir como token numérico.

Operadores

Os cinco operadores binários e os parênteses:

+   -   *   /   ^   (   )

Escreva um com o campo vazio e o editor insere-o imediatamente. Escreva uma sequência como (price * volume) / 12 e prima Enter em cada token.

Funções

Estão disponíveis três funções. Escreva o nome e o editor insere um esqueleto de função para preencher:

• abs( ) — valor absoluto de uma única expressão, por exemplo, abs(Revenues - Plan).
• min( , ) — o menor de duas expressões, por exemplo, min(Cash, 0).
• max( , ) — o maior de duas expressões, por exemplo, max(EBT, 0).

abs recebe um argumento; min e max recebem exatamente dois e comparam valores no mesmo período (não têm janela).

Referências

Comece a escrever o nome de uma posição, subposição, conta, fator ou KPI. A lista pendente de autocompletar restringe-se a cada tecla premida; prima Enter para inserir a melhor correspondência, ou clique em qualquer resultado para o inserir diretamente. Dentro da fórmula, a referência é apresentada como um chip com a etiqueta da linha.

As referências são escolhidas a partir de um seletor de navegação agrupado por origem: P&L, BS, CF, KPIs, mais fatores e subposições auxiliares. Com o módulo Departamentos, aparece um separador de origem adicional (ver Referências entre departamentos abaixo).

Deslocamentos temporais

Cada referência tem um deslocamento temporal — o período de onde a referência lê, relativamente à célula atual.

Clique na pílula de deslocamento em qualquer chip de referência para escolher:

• este mês — month(0) (predefinição)
• mês anterior — month(-1)
• há 1 ano — month(-12)
• Personalizado — abre uma janela onde define um número de meses e uma direção (seguinte / anterior), por isso, por exemplo, month(-3) ou month(+6) são alcançáveis

Os deslocamentos temporais são resolvidos no momento da avaliação: Revenues@month(-12) lê o valor de Receitas doze meses antes da célula que está a ser calculada.

Janelas de agregação

Além de um deslocamento temporal, cada referência pode ter uma agregação de janela móvel — em vez de ler um único período, a referência lê uma janela móvel e reduz-a a um único valor. Clique no controlo de agregação num chip de referência para escolher:

• Soma — totaliza a referência ao longo da janela (apresentada como, por exemplo, Σ 12M).
• Média — a média da referência ao longo da janela (apresentada como, por exemplo, avg 3M).

O comprimento da janela é L3M (últimos 3 meses), L6M, L12M ou Personalizado (define o seu próprio número de meses). Uma Soma sobre L12M dá um total dos últimos doze meses; uma Média sobre L3M suaviza uma série mensal ruidosa. A agregação combina-se com o deslocamento temporal — a janela é medida a partir do período do deslocamento.

Referências entre departamentos

Em contextos que abrangem vários departamentos (módulo Departamentos), o seletor expõe um separador de origem adicional acima da lista de referências:

• Departamentos — escolha o segmento de um departamento específico como origem. As referências entre departamentos são apresentadas com um prefixo de código curto no chip, para que veja qual o departamento que está a ser lido.
• Todos os departamentos — uma opção agregada que soma a referência em todos os departamentos.

O chip mostra apenas o código curto da origem; o separador de origem no seletor é onde o altera.

Controlos do editor

Dentro do editor:

• Enter — insere o token escrito (número / operador / melhor correspondência do autocompletar) ou confirma a fórmula quando o campo está vazio
• Escape — descarta a edição atual
• Backspace num campo vazio — remove o último chip

Validação

O statycs valida as fórmulas continuamente. Os erros aparecem como um distintivo ! vermelho junto à fórmula, com uma dica de contexto a descrever a causa:

• Referência circular — a fórmula referencia a sua própria linha, diretamente. Os ciclos transitivos (A → B → A entre posições) não são detetados atualmente.
• Referência quebrada — a linha, subposição ou fator para o qual a fórmula aponta já não existe. Abra a fórmula e remova ou substitua o chip.
• Divisão por zero — o denominador é avaliado como zero num ou mais períodos. Envolva o denominador numa proteção ou escolha uma referência diferente.
• Deslocamento fora do conjunto de dados — um deslocamento temporal (por exemplo, month(-12)) aponta para um período anterior ao início dos dados disponíveis. Aparece como aviso; ou reduza o deslocamento ou aceite os períodos em falta.

Os erros não bloqueiam a gravação. As células afetadas são avaliadas como zero até o erro ser corrigido, pelo que uma fórmula parcialmente quebrada não o impede de continuar — apenas não contribui com um valor.

Relacionado

• Métodos de planeamento — o método de Fórmula nas linhas de planeamento
• Fatores — os fatores são referenciados a partir de fórmulas
• Departamentos — referências entre departamentos com o módulo