Sequenz ID erstellen

Syntax

	generateSequenceId(sequence: $sequenceIdentifier, context:$additionalContext)

Beschreibung

Generiert die nächste fortlaufende Nummer aus einer Sequenz. Die Sequenz wird eindeutig identifiziert durch die Kombination aus:

Sequenz-Identifier (Pflichtfeld): Definiert die Basis-Sequenz (z.B. "invoice" für Rechnungsnummern)
Optionaler Kontext: Ermöglicht die Erzeugung separater Zählreihen. Jede eindeutige Kontext-Kombination führt zu einer eigenen, unabhängigen Sequenz.

Für jede neue Kombination aus Sequenz-Identifier und Kontext wird automatisch eine eigene Sequenz angelegt, die bei 1 beginnt. Bestehende Sequenzen werden bei jedem Aufruf um 1 erhöht.

Die Sequenzen bleiben auch über Sitzungen hinweg erhalten. Die fortlaufenden Nummern werden zentral in der Datenbank verwaltet.

Paramter

Bezeichnung	Typ	Beschreibung	Pflicht	Standard
sequence	String	Der Sequenz-Identifier, der die Basis für die Sequenz bildet.	ja
context	Any	Ein optionaler Kontext-Parameter, durch den separate Sequenzen entstehen. Kann sein: String/primitive Werte - Fachobjekte (verwendet deren ID) - Collections (alle Elemente werden kombiniert)	nein

Rückgabewert

Typ: Double

Gibt die nächste Nummer in der Sequenz zurück. Bei der ersten Verwendung einer neuen Sequenz wird 1 zurückgegeben.

Beispiele

	generateSequenceId("invoice", null)

Ausgabe: Eine Sequenznummer für alle Rechnungen, beginnt bei 1 und inkrementiert bei jedem Aufruf um 1 (1, 2, 3, 4, ...)

	generateSequenceId("invoice", $productA)