Formelsyntaks

Hva formeleditoren er til for

Formeleditoren lar deg bygge en egendefinert beregning fra innskrevne tokens — operatorer, tall og referanser til rader, drivere, underposisjoner og KPI-er. Samme editor, samme syntaks, på hver Formel-metode overalt i appen: planleggingsrader, planleggingsdrivere, KPI-er og egendefinerte dashboard.

Kort fortalt

Skriv et tall eller en operator for å slippe en token. Skriv et navn for å autofullføre en referanse. Hver referanse bærer en valgfri tidsforskyvning (denne måneden / forrige måned / for 1 år siden / Egendefinert) og, med Avdelinger-tillegget, et kildeomfang for referanser på tvers av avdelinger.

Tokens

En formel er en flat sekvens av tokens. Rutenettet gjengir hver token som en chip; Backspace på et tomt felt fjerner den siste chippen.

Tall

Skriv et hvilket som helst tall (100, 0.05, -1.2) og trykk Enter for å slippe det som en talltoken.

Operatorer

De fem binære operatorene og parentesene:

+   -   *   /   ^   (   )

Skriv en med tomt felt, så setter editoren den inn umiddelbart. Skriv en sekvens som (price * volume) / 12 og trykk Enter på hver token.

Funksjoner

Tre funksjoner er tilgjengelige. Skriv navnet, så slipper editoren inn et funksjonsskjelett du kan fylle ut:

  • abs( ) — absoluttverdien av et enkelt uttrykk, f.eks. abs(Revenues - Plan).
  • min( , ) — den minste av to uttrykk, f.eks. min(Cash, 0).
  • max( , ) — den største av to uttrykk, f.eks. max(EBT, 0).

abs tar ett argument; min og max tar nøyaktig to og sammenligner verdier i samme periode (de er ikke vindusbaserte).

Referanser

Begynn å skrive et posisjons-, underposisjons-, konto-, driver- eller KPI-navn. Autofullførings-nedtrekksmenyen snevres inn ved hvert tastetrykk; trykk Enter for å sette inn det øverste treffet, eller klikk et hvilket som helst resultat for å sette det inn direkte. Inne i formelen gjengis referansen som en chip med radetiketten.

Referanser velges fra en bla-gjennom-velger gruppert etter kilde: P&L, BS, CF, KPI-er, pluss drivere og hjelper-underposisjoner. Med Avdelinger-tillegget vises en ekstra kildefane (se Referanser på tvers av avdelinger nedenfor).

Tidsforskyvninger

Hver referanse bærer en tidsforskyvning — perioden referansen leser fra, relativt til den gjeldende cellen.

Klikk forskyvningspillen på en hvilken som helst referansechip for å velge:

  • denne måneden — month(0) (standard)
  • forrige måned — month(-1)
  • for 1 år siden — month(-12)
  • Egendefinert — åpner en modal der du setter et antall måneder og en retning (neste / forrige), slik at f.eks. month(-3) eller month(+6) er tilgjengelige

Tidsforskyvninger løses ved evalueringstidspunktet: Revenues@month(-12) leser Inntekter-verdien tolv måneder før cellen som beregnes.

Aggregeringsvinduer

I tillegg til en tidsforskyvning kan hver referanse bære en aggregering over et etterslepende vindu — i stedet for å lese en enkelt periode leser referansen et rullerende vindu og reduserer det til én verdi. Klikk aggregeringskontrollen på en referansechip for å velge:

  • Sum — summerer referansen over vinduet (gjengis som f.eks. Σ 12M).
  • Gjennomsnitt — gjennomsnittet av referansen over vinduet (gjengis som f.eks. avg 3M).

Vinduslengden er L3M (siste 3 måneder), L6M, L12M eller Egendefinert (sett ditt eget antall måneder). En Sum over L12M gir en total for de siste tolv månedene; et Gjennomsnitt over L3M jevner ut en støyende månedsserie. Aggregeringen kombineres med tidsforskyvningen — vinduet måles bakover fra forskyvningsperioden.

Referanser på tvers av avdelinger

I kontekster som spenner over flere avdelinger (Avdelinger-tillegget), eksponerer velgeren en ekstra kildefane over referanselisten:

  • Avdelinger — velg en bestemt avdelings andel som kilde. Referanser på tvers av avdelinger gjengis med et kortkode-prefiks på chippen slik at du ser hvilken avdeling som leses.
  • Alle avdelinger — et aggregert alternativ som summerer referansen på tvers av hver avdeling.

Chippen viser bare kildens kortkode; kildefanen i velgeren er der du endrer den.

Editor-kontroller

Inne i editoren:

  • Enter — sett inn den skrevne tokenen (tall / operator / øverste autofullføringstreff), eller bekreft formelen når feltet er tomt
  • Escape — forkast den gjeldende redigeringen
  • Backspace på tomt felt — fjern den siste chippen

Validering

statycs validerer formler kontinuerlig. Feil vises som et rødt !-merke ved siden av formelen, med et verktøytips som beskriver årsaken:

  • Sirkulær referanse — formelen refererer til sin egen rad, direkte. Transitive sykluser (A → B → A på tvers av posisjoner) oppdages ikke i dag.
  • Ugyldig referanse — raden, underposisjonen eller driveren formelen peker på finnes ikke lenger. Åpne formelen og fjern eller erstatt chippen.
  • Divisjon på null — nevneren evalueres til null i en eller flere perioder. Pakk nevneren inn i en vakt eller velg en annen referanse.
  • Forskyvning utenfor datasettet — en tidsforskyvning (f.eks. month(-12)) peker på en periode før starten av tilgjengelige data. Vises som en advarsel; enten snevre inn forskyvningen eller godta de manglende periodene.

Feil blokkerer ikke lagring. Berørte celler evalueres til null til feilen er rettet, så en delvis ødelagt formel stopper deg ikke fra å fortsette — den bidrar bare ikke med en verdi.

Relatert