Formulesyntaxis

Waar de formule-editor voor is

Met de formule-editor bouw je een aangepaste berekening op uit ingetypte tokens — operators, getallen en verwijzingen naar rijen, drivers, subposities en KPI’s. Dezelfde editor, dezelfde syntaxis, op elke Formule-methode overal in de app: planningsrijen, drivers, KPI’s en aangepaste dashboards.

Tokens

Een formule is een platte reeks tokens. Het raster geeft elke token weer als een chip; Backspace op een leeg invoerveld verwijdert de laatste chip.

Getallen

Typ een willekeurig getal (100, 0.05, -1.2) en druk op Enter om het als getaltoken toe te voegen.

Operators

De vijf binaire operators en haakjes:

+   -   *   /   ^   (   )

Typ er één terwijl het invoerveld leeg is en de editor voegt hem direct in. Typ een reeks als (price * volume) / 12 en druk op Enter bij elke token.

Functies

Er zijn drie functies beschikbaar. Typ de naam en de editor voegt een functieskelet toe dat je invult:

• abs( ) — absolute waarde van één expressie, bijv. abs(Revenues - Plan).
• min( , ) — de kleinste van twee expressies, bijv. min(Cash, 0).
• max( , ) — de grootste van twee expressies, bijv. max(EBT, 0).

abs neemt één argument; min en max nemen precies twee en vergelijken waarden in dezelfde periode (ze werken niet met een venster).

Verwijzingen

Begin met het typen van de naam van een positie, subpositie, rekening, driver of KPI. De autocomplete-lijst versmalt bij elke toetsaanslag; druk op Enter om de bovenste match in te voegen, of klik op een resultaat om het direct in te voegen. Binnen de formule wordt de verwijzing weergegeven als een chip met het rijlabel.

Verwijzingen kies je uit een bladerkiezer, gegroepeerd per bron: P&L, BS, CF, KPI’s, plus drivers en onderliggende hulpposities. Met de Afdelingen-uitbreiding verschijnt er een extra brontabblad (zie Afdelingsoverschrijdende verwijzingen hieronder).

Tijdverschuivingen

Elke verwijzing heeft een tijdverschuiving — de periode waaruit de verwijzing leest, ten opzichte van de huidige cel.

Klik op de verschuivingspil op een verwijzingschip om te kiezen:

• deze maand — month(0) (standaard)
• vorige maand — month(-1)
• 1 jaar geleden — month(-12)
• Aangepast — opent een venster waarin je een aantal maanden en een richting (volgende / vorige) instelt, zodat bijv. month(-3) of month(+6) bereikbaar zijn

Tijdverschuivingen worden opgelost op het moment van evaluatie: Revenues@month(-12) leest de waarde van Revenues twaalf maanden vóór de cel die wordt berekend.

Aggregatievensters

Naast een tijdverschuiving kan elke verwijzing ook een aggregatie over een voortschrijdend venster dragen — in plaats van één periode te lezen, leest de verwijzing een voortschrijdend venster en reduceert dit tot één waarde. Klik op de aggregatiebediening op een verwijzingschip om te kiezen:

• Som — telt de verwijzing op over het venster (weergegeven als bijv. Σ 12M).
• Gemiddelde — het gemiddelde van de verwijzing over het venster (weergegeven als bijv. avg 3M).

De vensterlengte is L3M (laatste 3 maanden), L6M, L12M of Aangepast (stel je eigen aantal maanden in). Een Som over L12M geeft een voortschrijdend twaalfmaandstotaal; een Gemiddelde over L3M vlakt een grillige maandreeks af. Aggregatie combineert met de tijdverschuiving — het venster wordt teruggemeten vanaf de verschuivingsperiode.

Afdelingsoverschrijdende verwijzingen

In contexten die meerdere afdelingen omvatten (Afdelingen-uitbreiding) toont de kiezer een extra brontabblad boven de verwijzingslijst:

• Afdelingen — kies het aandeel van een specifieke afdeling als bron. Afdelingsoverschrijdende verwijzingen worden weergegeven met een korte code als voorvoegsel op de chip, zodat je ziet welke afdeling wordt gelezen.
• Alle afdelingen — een geaggregeerde optie die de verwijzing over alle afdelingen optelt.

De chip toont alleen de korte code van de bron; het brontabblad in de kiezer is waar je die wijzigt.

Editorbediening

In de editor:

• Enter — de ingetypte token invoegen (getal / operator / bovenste autocomplete-match), of de formule vastleggen wanneer het invoerveld leeg is
• Escape — de huidige bewerking verwerpen
• Backspace op een leeg invoerveld — de laatste chip verwijderen

Validatie

statycs valideert formules doorlopend. Fouten verschijnen als een rode !-badge naast de formule, met een tooltip die de oorzaak beschrijft:

• Kringverwijzing — de formule verwijst rechtstreeks naar zijn eigen rij. Transitieve cycli (A → B → A over posities heen) worden momenteel niet gedetecteerd.
• Verbroken verwijzing — de rij, subpositie of driver waar de formule naar wijst bestaat niet meer. Open de formule en verwijder of vervang de chip.
• Deling door nul — de noemer evalueert tot nul in een of meer periodes. Zet de noemer in een beveiliging of kies een andere verwijzing.
• Verschuiving buiten de dataset — een tijdverschuiving (bijv. month(-12)) wijst naar een periode vóór het begin van de beschikbare gegevens. Verschijnt als waarschuwing; verklein de verschuiving of accepteer de ontbrekende periodes.

Fouten blokkeren het opslaan niet. Getroffen cellen evalueren tot nul totdat de fout is verholpen, dus een gedeeltelijk defecte formule houdt je niet tegen — hij levert alleen geen waarde op.

Gerelateerd

• Planningsmethoden — de Formule-methode op planningsrijen
• Drivers — drivers worden vanuit formules aangeroepen
• Afdelingen — afdelingsoverschrijdende verwijzingen met de uitbreiding