Sintaxa formulelor

La ce folosește editorul de formule

Editorul de formule îți permite să construiești un calcul personalizat din token-uri tastate — operatori, numere și referințe la rânduri, factori, sub-poziții și KPI. Același editor, aceeași sintaxă, la fiecare metodă Formulă oriunde în aplicație: rânduri de Planificare, factori de Planificare, KPI și dashboard-uri personalizate.

Pe scurt

Tastează un număr sau un operator pentru a insera un token. Tastează un nume pentru a autocompleta o referință. Fiecare referință poartă un decalaj temporal opțional (luna curentă / luna precedentă / acum 1 an / Personalizat) și, cu add-on-ul Departamente, un domeniu-sursă pentru referințele între departamente.

Token-uri

O formulă este o secvență plată de token-uri. Grila afișează fiecare token ca un chip; Backspace pe un câmp gol elimină ultimul chip.

Numere

Tastează orice număr (100, 0.05, -1.2) și apasă Enter pentru a-l insera ca token numeric.

Operatori

Cei cinci operatori binari și parantezele:

+   -   *   /   ^   (   )

Tastează unul cu câmpul gol, iar editorul îl inserează imediat. Tastează o secvență precum (price * volume) / 12 și apasă Enter pe fiecare token.

Funcții

Sunt disponibile trei funcții. Tastează numele, iar editorul îți inserează un schelet de funcție de completat:

  • abs( ) — valoarea absolută a unei singure expresii, de exemplu abs(Revenues - Plan).
  • min( , ) — cea mai mică dintre două expresii, de exemplu min(Cash, 0).
  • max( , ) — cea mai mare dintre două expresii, de exemplu max(EBT, 0).

abs ia un singur argument; min și max iau exact două și compară valori din aceeași perioadă (nu sunt calculate pe o fereastră).

Referințe

Începe să tastezi numele unei poziții, sub-poziții, cont, factor sau KPI. Lista de autocompletare se restrânge la fiecare apăsare de tastă; apasă Enter pentru a insera cea mai bună potrivire sau dă clic pe orice rezultat pentru a-l insera direct. În interiorul formulei, referința se afișează ca un chip cu eticheta rândului.

Referințele se aleg dintr-un selector de răsfoire grupat pe sursă: P&L, BS, CF, KPI, plus factori și sub-poziții ajutătoare. Cu add-on-ul Departamente, apare o filă-sursă suplimentară (vezi Referințe între departamente mai jos).

Decalaje temporale

Fiecare referință poartă un decalaj temporal — perioada din care citește referința, raportat la celula curentă.

Dă clic pe pastila de decalaj de pe orice chip de referință pentru a alege:

  • luna curentă — month(0) (implicit)
  • luna precedentă — month(-1)
  • acum 1 an — month(-12)
  • Personalizat — deschide o fereastră în care setezi un număr de luni și o direcție (înainte / înapoi), astfel încât să fie accesibile, de exemplu, month(-3) sau month(+6)

Decalajele temporale se rezolvă în momentul evaluării: Revenues@month(-12) citește valoarea Venituri cu douăsprezece luni înainte de celula care se calculează.

Ferestre de agregare

Pe lângă un decalaj temporal, fiecare referință poate purta o agregare pe fereastră glisantă — în loc să citească o singură perioadă, referința citește o fereastră glisantă și o reduce la o singură valoare. Dă clic pe controlul de agregare de pe un chip de referință pentru a alege:

  • Sumă — însumează referința pe toată fereastra (se afișează ca, de exemplu, Σ 12M).
  • Medie — media referinței pe toată fereastra (se afișează ca, de exemplu, avg 3M).

Lungimea ferestrei este L3M (ultimele 3 luni), L6M, L12M sau Personalizat (setezi propriul număr de luni). O Sumă pe L12M dă un total pe ultimele douăsprezece luni; o Medie pe L3M netezește o serie lunară zgomotoasă. Agregarea se combină cu decalajul temporal — fereastra se măsoară în urmă pornind de la perioada decalajului.

Referințe între departamente

În contexte care se întind pe mai multe departamente (add-on-ul Departamente), selectorul expune o filă-sursă suplimentară deasupra listei de referințe:

  • Departamente — alege felia unui anumit departament ca sursă. Referințele între departamente se afișează cu un prefix de cod scurt pe chip, ca să vezi din ce departament se citește.
  • Toate departamentele — o opțiune agregată care însumează referința pe fiecare departament.

Chipul afișează doar codul scurt al sursei; fila-sursă din selector este locul unde o schimbi.

Comenzile editorului

În interiorul editorului:

  • Enter — inserează token-ul tastat (număr / operator / cea mai bună potrivire de autocompletare) sau confirmă formula când câmpul este gol
  • Escape — renunță la editarea curentă
  • Backspace pe câmp gol — elimină ultimul chip

Validare

statycs validează formulele continuu. Erorile apar ca o insignă roșie ! lângă formulă, cu un tooltip care descrie cauza:

  • Referință circulară — formula se referă direct la propriul rând. Ciclurile tranzitive (A → B → A între poziții) nu sunt detectate în prezent.
  • Referință ruptă — rândul, sub-poziția sau factorul la care indică formula nu mai există. Deschide formula și elimină sau înlocuiește chipul.
  • Împărțire la zero — numitorul se evaluează la zero în una sau mai multe perioade. Protejează numitorul sau alege o altă referință.
  • Decalaj în afara setului de date — un decalaj temporal (de exemplu, month(-12)) indică o perioadă dinaintea începutului datelor disponibile. Apare ca avertisment; fie restrângi decalajul, fie accepți perioadele lipsă.

Erorile nu blochează salvarea. Celulele afectate se evaluează la zero până când eroarea este corectată, așa că o formulă parțial ruptă nu te împiedică să continui — pur și simplu nu contribuie cu o valoare.

Legate