Formelsyntaks

Hvad formeleditoren er til

Formeleditoren lader dig bygge en brugerdefineret beregning ud fra indtastede tokens — operatorer, tal og referencer til rækker, drivere, subpositioner og KPI’er. Samme editor, samme syntaks, på hver Formel-metode overalt i appen: planlægningsrækker, planlægningsdrivere, KPI’er og brugerdefinerede dashboards.

Kort fortalt

Indtast et tal eller en operator for at slippe et token. Indtast et navn for at autofuldføre en reference. Hver reference bærer en valgfri tidsforskydning (denne måned / forrige måned / for 1 år siden / Brugerdefineret) og, med tilkøbet Afdelinger, et kildeomfang til referencer på tværs af afdelinger.

Tokens

En formel er en flad sekvens af tokens. Gitteret gengiver hvert token som en chip; Backspace i et tomt input fjerner den sidste chip.

Tal

Indtast et vilkårligt tal (100, 0.05, -1.2), og tryk på Enter for at slippe det som et taltoken.

Operatorer

De fem binære operatorer og parenteser:

+   -   *   /   ^   (   )

Indtast en med et tomt input, og editoren indsætter den med det samme. Indtast en sekvens som (price * volume) / 12, og tryk Enter på hvert token.

Funktioner

Tre funktioner er tilgængelige. Indtast navnet, og editoren slipper et funktionsskelet, du kan udfylde:

  • abs( ) — absolut værdi af et enkelt udtryk, f.eks. abs(Revenues - Plan).
  • min( , ) — den mindste af to udtryk, f.eks. min(Cash, 0).
  • max( , ) — den største af to udtryk, f.eks. max(EBT, 0).

abs tager ét argument; min og max tager præcis to og sammenligner værdier i den samme periode (de er ikke vinduesbaserede).

Referencer

Begynd at skrive navnet på en position, subposition, konto, driver eller KPI. Autofuldførelses-dropdownen indsnævres ved hvert tastetryk; tryk på Enter for at indsætte det øverste match, eller klik på et vilkårligt resultat for at indsætte det direkte. Inde i formlen gengives referencen som en chip med rækkeetiketten.

Referencer vælges fra en gennemse-vælger grupperet efter kilde: P&L, BS, CF, KPI’er, plus drivere og subpositioner som hjælp. Med tilkøbet Afdelinger vises en ekstra kildefane (se Referencer på tværs af afdelinger nedenfor).

Tidsforskydninger

Hver reference bærer en tidsforskydning — den periode, referencen læser fra, i forhold til den aktuelle celle.

Klik på forskydningspillen på en vilkårlig referencechip for at vælge:

  • denne måned — month(0) (standard)
  • forrige måned — month(-1)
  • for 1 år siden — month(-12)
  • Brugerdefineret — åbner en dialog, hvor du angiver et månedsantal og en retning (næste / forrige), så f.eks. month(-3) eller month(+6) er tilgængelige

Tidsforskydninger opløses på evalueringstidspunktet: Revenues@month(-12) læser Omsætnings-værdien tolv måneder før den celle, der beregnes.

Aggregeringsvinduer

Ud over en tidsforskydning kan hver reference bære en aggregering over et bagudrettet vindue — i stedet for at læse en enkelt periode læser referencen et rullende vindue og reducerer det til én værdi. Klik på aggregeringskontrollen på en referencechip for at vælge:

  • Sum — summerer referencen over vinduet (gengives som f.eks. Σ 12M).
  • Gennemsnit — gennemsnittet af referencen over vinduet (gengives som f.eks. avg 3M).

Vinduets længde er L3M (sidste 3 måneder), L6M, L12M eller Brugerdefineret (angiv dit eget månedsantal). En Sum over L12M giver en total for de seneste tolv måneder; et Gennemsnit over L3M udjævner en støjende månedlig serie. Aggregering kombineres med tidsforskydningen — vinduet måles bagud fra forskydningsperioden.

Referencer på tværs af afdelinger

I sammenhænge, der spænder over flere afdelinger (tilkøbet Afdelinger), viser vælgeren en ekstra kildefane over referencelisten:

  • Afdelinger — vælg en bestemt afdelings udsnit som kilde. Referencer på tværs af afdelinger gengives med et kortkode-præfiks på chippen, så du kan se, hvilken afdeling der læses.
  • Alle afdelinger — en aggregeret mulighed, der summerer referencen på tværs af hver afdeling.

Chippen viser kun kildens kortkode; kildefanen i vælgeren er, hvor du ændrer den.

Editorkontroller

Inde i editoren:

  • Enter — indsæt det indtastede token (tal / operator / øverste autofuldførelses-match), eller bekræft formlen, når inputtet er tomt
  • Escape — kassér den aktuelle redigering
  • Backspace i tomt input — fjern den sidste chip

Validering

statycs validerer formler løbende. Fejl vises som et rødt !-badge ved siden af formlen, med et værktøjstip, der beskriver årsagen:

  • Cirkulær reference — formlen refererer direkte til sin egen række. Transitive cyklusser (A → B → A på tværs af positioner) registreres ikke i dag.
  • Brudt reference — den række, subposition eller driver, formlen peger på, findes ikke længere. Åbn formlen, og fjern eller erstat chippen.
  • Division med nul — nævneren evalueres til nul i en eller flere perioder. Indpak nævneren i en beskyttelse, eller vælg en anden reference.
  • Forskydning uden for datasæt — en tidsforskydning (f.eks. month(-12)) peger på en periode før starten på de tilgængelige data. Vises som en advarsel; indsnævr enten forskydningen, eller accepter de manglende perioder.

Fejl blokerer ikke for at gemme. Berørte celler evalueres til nul, indtil fejlen er rettet, så en delvist brudt formel ikke stopper dig i at fortsætte — den bidrager bare ikke med en værdi.

Relateret