Formel-Syntax

Wofür der Formel-Editor da ist

Der Formel-Editor lässt dich eine eigene Berechnung aus typisierten Bausteinen aufbauen — Operatoren, Zahlen und Referenzen auf Zeilen, Treiber, Unterpositionen und KPIs. Derselbe Editor, dieselbe Syntax, auf jeder Formel-Methode überall in der App: Planungszeilen, Planungstreiber, KPIs und eigene Dashboards.

Kurzfassung

Tippe eine Zahl oder einen Operator, um einen Baustein abzulegen. Tippe einen Namen, um eine Referenz automatisch zu vervollständigen. Jede Referenz trägt einen optionalen Zeitversatz (dieser Monat / Vormonat / vor 1 Jahr / Benutzerdefiniert) und, mit dem Abteilungen-Add-on, einen Quell-Geltungsbereich für abteilungsübergreifende Referenzen.

Bausteine

Eine Formel ist eine flache Folge von Bausteinen. Das Raster rendert jeden Baustein als Chip; Rücktaste bei leerer Eingabe entfernt den letzten Chip.

Zahlen

Tippe eine beliebige Zahl (100, 0.05, -1.2) und drücke Enter, um sie als Zahlen-Baustein abzulegen.

Operatoren

Die fünf binären Operatoren und Klammern:

+   -   *   /   ^   (   )

Tippe einen davon bei leerer Eingabe, und der Editor fügt ihn sofort ein. Tippe eine Folge wie (price * volume) / 12 und drücke Enter bei jedem Baustein.

Funktionen

Drei Funktionen stehen zur Verfügung. Tippe den Namen, und der Editor legt ein Funktionsgerüst zum Ausfüllen ab:

abs( ) — Absolutwert eines einzelnen Ausdrucks, z. B. abs(Revenues - Plan).
min( , ) — der kleinere von zwei Ausdrücken, z. B. min(Cash, 0).
max( , ) — der größere von zwei Ausdrücken, z. B. max(EBT, 0).

abs nimmt ein Argument; min und max nehmen genau zwei und vergleichen Werte in derselben Periode (sie sind nicht fensterbasiert).

Referenzen

Beginne, den Namen einer Position, Unterposition, eines Kontos, Treibers oder KPI zu tippen. Das Autovervollständigen-Dropdown grenzt bei jedem Tastendruck ein; drücke Enter, um den obersten Treffer einzufügen, oder klicke ein beliebiges Ergebnis, um es direkt einzufügen. Innerhalb der Formel wird die Referenz als Chip mit der Zeilenbeschriftung gerendert.

Referenzen werden aus einem Browse-Picker gewählt, gruppiert nach Quelle: GuV, Bilanz, CF, KPIs sowie Treiber und Hilfs-Unterpositionen. Mit dem Abteilungen-Add-on erscheint ein zusätzlicher Quell-Tab (siehe Abteilungsübergreifende Referenzen unten).

Zeitversätze

Jede Referenz trägt einen Zeitversatz — die Periode, aus der die Referenz liest, relativ zur aktuellen Zelle.

Klicke die Versatz-Pille an einem beliebigen Referenz-Chip, um zu wählen:

dieser Monat — month(0) (Standard)
Vormonat — month(-1)
vor 1 Jahr — month(-12)
Benutzerdefiniert — öffnet ein Modal, in dem du eine Monatszahl und eine Richtung setzt (nächste / vorherige), sodass z. B. month(-3) oder month(+6) erreichbar sind

Zeitversätze werden zum Auswertungszeitpunkt aufgelöst: Revenues@month(-12) liest den Umsatzwert zwölf Monate vor der berechneten Zelle.

Aggregationsfenster

Neben einem Zeitversatz kann jede Referenz eine Aggregation über ein gleitendes Fenster tragen — statt eine einzelne Periode zu lesen, liest die Referenz mehrere Perioden und reduziert sie auf einen Wert. Klicke die Aggregations-Steuerung an einem Referenz-Chip, um zu wählen:

Summe — summiert die Referenz über das Fenster (rendert z. B. als Σ 12M).
Durchschnitt — der Mittelwert der Referenz über das Fenster (rendert z. B. als avg 3M).

Die Fensterlänge ist L3M (letzte 3 Monate), L6M, L12M oder Benutzerdefiniert (setze deine eigene Monatszahl). Eine Summe über L12M ergibt eine Summe der letzten zwölf Monate; ein Durchschnitt über L3M glättet eine verrauschte Monatsreihe. Die Aggregation kombiniert sich mit dem Zeitversatz — das Fenster wird ab der Versatzperiode zurückgemessen.

Abteilungsübergreifende Referenzen

In Kontexten, die mehrere Abteilungen umspannen (Abteilungen-Add-on), legt der Picker einen zusätzlichen Quell-Tab über der Referenzliste offen:

Abteilungen — wähle den Ausschnitt einer bestimmten Abteilung als Quelle. Abteilungsübergreifende Referenzen werden mit einem Kürzel-Präfix auf dem Chip gerendert, sodass du siehst, welche Abteilung gelesen wird.
Alle Abteilungen — eine Aggregat-Option, die die Referenz über jede Abteilung summiert.

Der Chip zeigt nur das Quell-Kürzel; der Quell-Tab im Picker ist der Ort, an dem du es änderst.

Editor-Steuerungen

Innerhalb des Editors:

Enter — den getippten Baustein einfügen (Zahl / Operator / obersten Autovervollständigen-Treffer) oder die Formel übernehmen, wenn die Eingabe leer ist
Escape — die aktuelle Bearbeitung verwerfen
Rücktaste bei leerer Eingabe — den letzten Chip entfernen

Validierung

statycs validiert Formeln kontinuierlich. Fehler erscheinen als rotes !-Abzeichen neben der Formel, mit einem Tooltip, der die Ursache beschreibt:

Zirkelbezug — die Formel referenziert direkt ihre eigene Zeile. Transitive Zyklen (A → B → A über Positionen hinweg) werden heute nicht erkannt.
Ungültige Referenz — die Zeile, Unterposition oder der Treiber, auf die die Formel zeigt, existiert nicht mehr. Öffne die Formel und entferne oder ersetze den Chip.
Division durch null — der Nenner wird in einer oder mehreren Perioden zu null. Umschließe den Nenner mit einer Absicherung oder wähle eine andere Referenz.
Versatz außerhalb des Datensatzes — ein Zeitversatz (z. B. month(-12)) zeigt auf eine Periode vor dem Beginn der verfügbaren Daten. Erscheint als Warnung; grenze entweder den Versatz ein oder akzeptiere die fehlenden Perioden.

Fehler blockieren das Speichern nicht. Betroffene Zellen werten zu null aus, bis der Fehler behoben ist, sodass eine teilweise defekte Formel dich nicht am Weiterarbeiten hindert — sie trägt nur keinen Wert bei.