Das Variablenkonzept beschreibt, welche Daten zwischen Akte und Workflow ausgetauscht werden und nach welchen Regeln dies geschieht.

Die wichtigste Regel vorweg: Der Name einer Variable entscheidet, wo sie landet.

FORDERUNG_OFFEN Platzhalter der Akte
persistiert

GROSSBUCHSTABEN_MIT_UNTERSTRICH werden als Fall-Platzhalter sichtbar und stehen im Schriftverkehr zur Verfügung.

_hilfswert · wf_zähler nur im Workflow
nicht persistiert

_- und wf_-Variablen bleiben intern – ideal für Zwischenergebnisse, die den Anwender nicht interessieren.

FORDERUNG_* · GEBÜHR…
gesperrt

Systemreservierte Präfixe (z. B. FORDERUNG_*) werden berechnet – nicht als eigene Platzhalter verwenden.

Datenfluss zwischen Akte und Workflow

Grundsätzlich werden alle Variablen aus den Platzhaltern der Akte in den Workflow geladen, und Änderungen werden während der Laufzeit in den Workflow propagiert. Umgekehrt wird jede im Workflow erzeugte Variable unmittelbar nach ihrer Erstellung in den Platzhaltern der Akte gespeichert. Die vollständige Auflistung der geladenen Variablen finden Sie in der Variablenreferenz.

Technische Variablen (nicht persistiert)

In bestimmten Fällen sollen Variablen ausschließlich innerhalb des Workflows existieren und nicht in den Platzhaltern der Akte landen. Dafür gelten zwei Konventionen:

Präfix Bedeutung
wf_ / WF_ Rein technische Workflow-Variable. Nur innerhalb des Workflows und seiner Subworkflows verfügbar, wird nicht in den Platzhaltern gespeichert.
_ (Unterstrich) Jede Variable, die mit einem Unterstrich beginnt, wird nicht persistiert. Entsteht typischerweise als Input in Header-Feldern von ServiceTasks sowie als Ausgabewert von ServiceTasks und Catch-Events.

Datentyp: alles ist eine Zeichenkette

Alle Variablen werden als Zeichenkette (String) gespeichert und genutzt. Für Berechnungen oder numerische Bedingungen ist daher eine Konvertierung erforderlich, etwa über bigDecimal(...).

FORDERUNG_OFFEN = "1.234,50 €"       ← String, kein Zahlenwert
bigDecimal(FORDERUNG_OFFEN) > 0      ← erst konvertieren, dann vergleichen

Gesperrte Variablen (systemreserviert)

Folgende Variablen sind für Systemzwecke reserviert und werden nicht in den Platzhaltern gespeichert:

  • alle Systemvariablen aus der Variablenreferenz,
  • alle Variablen der Beteiligten,
  • alle Variablen mit einem der folgenden Präfixe:
Präfix Bereich
FORDERUNG_* Forderungsbeträge je Gruppe und gesamt
FORDERUNGSTABELLE* Forderungstabellen (HTML/JSON)
GEBÜHRENTABELLE* Gebührentabellen je Stufe
ABZINSUNGSTABELLE* Abzinsungstabellen
FORDERUNGSSALDO* Salden aus Forderung, Gebühren, gesamt
FORDERUNGSUEBERSICHT* Forderungsübersicht (HTML)