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:
- Sequenz-Identifier (Pflichtfeld): Definiert die Basis-Sequenz (z.B. "invoice" für Rechnungsnummern)
- 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.