Zurücksetzen einer Sequenz

​​Syntax

	resetSequence(sequence: $sequenceIdentifier, context: $additionalContext, newValue: $valueToResetTo)

Beschreibung

Setzt eine Sequenz auf einen bestimmten Wert zurück. Die Sequenz wird eindeutig identifiziert durch die Kombination aus:

  1. Sequenz-Identifier (Pflichtfeld): Definiert die Basis-Sequenz (z.B. "invoice" für Rechnungsnummern)
  2. Optionaler Kontext: Ein zusätzlicher Wert, der die Sequenz weiter unterteilt. Für jeden unterschiedlichen Kontext-Wert wird eine eigene, separate Sequenz verwendet.

Der nächste Aufruf von generateSequenceId für diese Sequenz wird den angegebenen Wert zurückgeben.

Paramter

Bezeichnung Typ Beschreibung Pflicht Standard
sequence String Der Sequenz-Identifier der zurückzusetzenden Sequenz. 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
newValue Number Der neue Wert, auf den die Sequenz gesetzt werden soll. Der nächste Aufruf von generateSequenceId wird diesen Wert zurückgeben. nein 1

Rückgabewert

Typ: Boolean

Gibt true zurück, wenn das Zurücksetzen der Sequenz erfolgreich war. Falls die Sequenz nicht gefunden wurde oder ein Fehler auftrat, wird false zurückgegeben.

Beispiele

	resetSequence($existingSequence)

Ausgabe: true - Sequenz $existingSequence wird auf 1 zurückgesetzt

	resetSequence("slot", $parking, 100)
generateSequenceId("slot", $parking)

Ausgabe: Eine Sequenz für die Stellplätze des Parkhauses wird auf 100 zurückgesetzt. Der folgende generateSequenceId-Aufruf gibt 100 zurück.