Nummernkreiswert
Wertauflöser - Kurzfassung
Zweck: Versucht einen Nummernkreiswert für den angegebenen Nummernkreistyp abzurufen.
Der Nummernkreiswert-Wertauflöser versucht einen Nummernkreiswert für den angegebenen Nummernkreistyp abzurufen.
Ob der Wertauflöser einen Nummernkreiswert zurückgibt, hängt davon ab, ob ein Nummernkreis ...
für den Nummernkreistyp konfiguriert,
aktiv gesetzt,
im gegebenen Kontext anwendbar (s. Hinweis unten) und
noch nicht "ausgeschöpft"
.... ist.
Weitere Details s. Nummernkreise.
Ist eines dieser Kriterien nicht erfüllt, wird "kein Wert" ($null) zurückgegeben.
►HINWEIS◄ Die dynamische Zuordnung von Nummernkreisen für den ausgewählten Nummerntyp berücksichtigt den Eingabewert für den Nummernkreiswert-Wertauflöser als Datenkontext, der im Kontext einer Verkettung vom im Kontext geltenden Bezugsobjekt abweichen kann.
Der Eingabewert wird zusammen mit den im Kontext des Nummernkreiswert-Wertauflösers geltenden Variablen an den ggf. zugeordneten Nummernkreis übergeben. Die entsprechenden Daten können in dessen Konfiguration zur Definition von Nummernteilen genutzt werden (s. Wert über Resolver (Nummernteil)).
Konfiguration
Der einzige Parameter Nummernkreistyp ist formal kein Pflichtfeld. Allerdings wird ohne eine Auswahl für den Nummernkreistyp immer "kein Wert" ($null) zurückgegeben.
Das Auswahlfeld für den Parameter Nummernkreistyp bezieht sich auf die Dynamische Aufzählung Nummernkreistyp und unterstützt wie rechts gezeigt eine Suchfunktion. Im Kontext der Konfiguration anwendbare Aufzählungsfilter für den Nummernkreistyp können die Auswahloptionen einschränken. Auf das Laufzeitverhalten haben solche Einschränkungen keinen Einfluss. |
|
Beispiel
Immer wenn das Konto eines Benutzers (s. Benutzer) oder Gastbenutzers (s. Gastbenutzer) erstellt, geändert oder gelöscht wird, soll eine E-Mail an einen Administrator gesendet werden, in deren Betreffzeile ein Nummernkreiswert als eindeutige Kennung für die "Konto-Transaktion" erscheint.
Konkret soll der Nummernkreis eine sechsstellige inkrementelle Laufnummer mit einem Kennbuchstaben für die Transaktion ("C"=CREATE, "U"=UPDATE, "D"=DELETE") und dem Typ des betreffenden Kontos verbinden.
Laufzeitbeispiel:
Im Beispiel rechts erscheint die Laufnummer (#58) gefolgt vom Kennbuchstaben "D" (DELETE) und dem internen Klassennamen für das gelöschte Objekt vom Typ Gastbenutzer (GuestUser). |
|
Konfiguration:
Eine Ereignisbehandlung wird wie rechts abgebildet konfiguriert:
Der Betreff für die E-Mail wird hier komplett durch die Konfiguration eines Nummernkreises mit dem Nummernkreistyp "Account Transaction" definiert. Diese enthält wie im Screenshot unten zu sehen ist 5 Nummernteile:
|
|
|