Sintassi delle formule

A cosa serve l’editor di formula

L’editor di formula ti permette di costruire un calcolo personalizzato a partire da token tipizzati — operatori, numeri e riferimenti a righe, driver, sotto-posizioni e KPI. Stesso editor, stessa sintassi, su ogni metodo Formula ovunque nell’app: righe di Pianificazione, driver di Pianificazione, KPI e dashboard personalizzate.

In sintesi

Digita un numero o un operatore per inserire un token. Digita un nome per autocompletare un riferimento. Ogni riferimento porta un offset temporale opzionale (questo mese / mese precedente / 1 anno fa / Personalizzato) e, con l’add-on Reparti, un ambito di origine per i riferimenti tra reparti.

Token

Una formula è una sequenza piatta di token. La griglia renderizza ciascun token come chip; Backspace su un input vuoto rimuove l’ultimo chip.

Numeri

Digita un numero qualsiasi (100, 0.05, -1.2) e premi Invio per inserirlo come token numerico.

Operatori

I cinque operatori binari e le parentesi:

+   -   *   /   ^   (   )

Digitane uno con l’input vuoto e l’editor lo inserisce immediatamente. Digita una sequenza come (price * volume) / 12 e premi Invio su ogni token.

Funzioni

Sono disponibili tre funzioni. Digita il nome e l’editor inserisce uno scheletro di funzione da completare:

  • abs( ) — valore assoluto di una singola espressione, es. abs(Revenues - Plan).
  • min( , ) — il minore tra due espressioni, es. min(Cash, 0).
  • max( , ) — il maggiore tra due espressioni, es. max(EBT, 0).

abs prende un argomento; min e max ne prendono esattamente due e confrontano i valori nello stesso periodo (non usano una finestra).

Riferimenti

Inizia a digitare il nome di una posizione, sotto-posizione, conto, driver o KPI. La tendina di autocompletamento si restringe a ogni tasto; premi Invio per inserire il primo risultato, oppure clicca un risultato qualsiasi per inserirlo direttamente. Dentro la formula, il riferimento viene renderizzato come chip con l’etichetta della riga.

I riferimenti si scelgono da un picker di esplorazione raggruppato per origine: CE, SP, CF, KPI, più driver e sotto-posizioni di supporto. Con l’add-on Reparti compare un’ulteriore scheda di origine (vedi Riferimenti tra reparti più sotto).

Offset temporali

Ogni riferimento porta un offset temporale — il periodo da cui legge il riferimento, relativamente alla cella corrente.

Clicca la pillola di offset su un qualsiasi chip di riferimento per scegliere:

  • questo mese — month(0) (default)
  • mese precedente — month(-1)
  • 1 anno fa — month(-12)
  • Personalizzato — apre una modale dove imposti un numero di mesi e una direzione (successivi / precedenti), così ad esempio month(-3) o month(+6) sono raggiungibili

Gli offset temporali vengono risolti al momento della valutazione: Revenues@month(-12) legge il valore di Revenues dodici mesi prima della cella in calcolo.

Finestre di aggregazione

Oltre a un offset temporale, ogni riferimento può portare un’aggregazione su finestra mobile — invece di leggere un singolo periodo, il riferimento legge una finestra mobile e la riduce a un unico valore. Clicca il controllo di aggregazione su un chip di riferimento per scegliere:

  • Somma — somma il riferimento sulla finestra (renderizzato ad es. come Σ 12M).
  • Media — la media del riferimento sulla finestra (renderizzata ad es. come avg 3M).

La lunghezza della finestra è L3M (ultimi 3 mesi), L6M, L12M o Personalizzato (imposti tu il numero di mesi). Una Somma su L12M dà un totale a dodici mesi mobili; una Media su L3M leviga una serie mensile rumorosa. L’aggregazione si combina con l’offset temporale — la finestra è misurata all’indietro dal periodo dell’offset.

Riferimenti tra reparti

Nei contesti che spaziano su più reparti (add-on Reparti), il picker espone un’ulteriore scheda di origine sopra la lista dei riferimenti:

  • Reparti — scegli la porzione di un reparto specifico come origine. I riferimenti tra reparti vengono renderizzati con un prefisso di short-code sul chip, così vedi quale reparto viene letto.
  • Tutti i reparti — un’opzione aggregata che somma il riferimento su tutti i reparti.

Il chip mostra solo lo short-code dell’origine; la scheda di origine nel picker è il punto in cui la modifichi.

Controlli dell’editor

Dentro l’editor:

  • Invio — inserisce il token digitato (numero / operatore / primo risultato dell’autocompletamento), oppure conferma la formula quando l’input è vuoto
  • Escape — scarta la modifica corrente
  • Backspace su input vuoto — rimuove l’ultimo chip

Validazione

statycs valida le formule continuamente. Gli errori emergono come badge ! rosso accanto alla formula, con un tooltip che descrive la causa:

  • Riferimento circolare — la formula referenzia la propria riga, direttamente. I cicli transitivi (A → B → A tra più posizioni) non vengono rilevati oggi.
  • Riferimento rotto — la riga, sotto-posizione o driver a cui punta la formula non esiste più. Apri la formula e rimuovi o sostituisci il chip.
  • Divisione per zero — il denominatore vale zero in uno o più periodi. Avvolgi il denominatore in una guardia oppure scegli un altro riferimento.
  • Offset fuori dataset — un offset temporale (es. month(-12)) punta a un periodo precedente all’inizio dei dati disponibili. Emerge come avviso; restringi l’offset oppure accetta i periodi mancanti.

Gli errori non bloccano il salvataggio. Le celle interessate valutano a zero finché l’errore non viene corretto, così una formula parzialmente rotta non ti impedisce di proseguire — semplicemente non contribuisce con un valore.

Correlati