Alle Werte einer dynamischen Aufzählung

Siehe auch: Dynamische Aufzählungen, Jede dynamische Aufzählung

Wertauflöser - Kurzfassung

Zweck: Liefert alle Werte einer in der Konfiguration statisch definierten Dynamischen Aufzählung als Liste zurück.

images/download/attachments/150865898/image-2024-6-7_18-59-28-version-1-modificationdate-1717779567495-api-v2.png

Der Alle Werte einer dynamischen Aufzählung-Wertauflöser liefert eine Liste von allen Werten einer durch statische Auswahl in der Konfiguration definierte Dynamische Aufzählung (s. Dynamische Aufzählungen).

HINWEIS◄ Im Ausführungskontext anwendbare Dynamische Aufzählungsfilter schränken die zurückgegebene Liste nicht ein. Der Wertauflöser liefert immer alle Werte (values), die in der Definition der Dynamischen Aufzählung konfiguriert sind.

Konfiguration

Ein ggf. vorliegender Eingabewert wird ignoriert.

Der Pflichtfeld-Parameter Typ erfordert die statische Einfachauswahl einer Dynamischen Aufzählung über ein Auswahlfeld/Combobox-Element.

Diese verfügt über eine Suchfunktion, die sowohl die Lokalisierungen als auch die internen (Klassen-)Namen für vordefinierte und benutzerdefinierte Dynamische Aufzählungen berücksichtigt.

images/download/attachments/150865898/image-2024-6-7_19-13-34-version-1-modificationdate-1717780414055-api-v2.png

Sobald eine Auswahl für den Typ getroffen ist, wird als Typ für den Rückgabewert im Kontext der Konfiguration eine
Liste von Werten des betreffenden Typs (hier: Volumeneinheit[]) angenommen, für den ggf. spezifische Feld angeboten werden.

images/download/attachments/150865898/image-2024-6-7_19-19-9-version-1-modificationdate-1717780748525-api-v2.png

Beispiele

Einfacher Anwendungsfall: Werte einer Aufzählung "auflisten"

Im Kontext einer Ereignisbehandlung soll vom Benutzer unter bestimmten Voraussetzungen eine Angabe zur "Wirtschaftsregion" per Benutzereingabe (als Textwert) abgefragt werden.

Es wurde eine benutzerdefinierte Dynamische Aufzählung "Wirtschaftsregion" (REGIONS) angelegt, die zulässige Werte für diese Angabe vorgibt. Ausschlaggebend soll dabei der "Name" (name) des jeweiligen Werts sein.

Die "Eingabeaufforderung" in der Benutzereingabe (Wertauflöser) soll alle zulässigen Textschlüssel ("Name"-Werte) aus der zugrundeliegenden Aufzählung angeben.

Laufzeitbeispiel:

images/download/attachments/150865898/image-2024-6-7_19-58-1-version-1-modificationdate-1717783081366-api-v2.png

Konfiguration:

Der Screenshot rechts zeigt, wie der Benutzereingabe-Wertauflöser innerhalb einer Ausführen mit-Ereignisaktion eingesetzt werden kann, um die per Texteingabe identifizierte "Wirtschaftsregion" als Bezugsobjekt für den Aktionsblock unterhalb (im Bild rechts noch leer) bereitzustellen:

  • Die Nachricht im Benutzereingabe (Wertauflöser)-Wertauflöser wird komplett durch den Alle Werte einer dynamischen Aufzählung-Wertauflöser bestimmt:

    • Als Typ ist die benutzerdefinierte Dynamische Aufzählung "Wirtschaftsregion" (REGIONS) ausgewählt.

    • Im Server-Kontext (z. B. in einer Ereignisbehandlung) erscheinen im String-Abbild der so erzeugten Liste ausschließlich die "Namen" aus dem name-Feld der enthaltenen Werte. Für den gegebenen Zweck sind das Abkürzungen für Regionen, die unabhängig von einer ggf. anwendbaren Lokalisierung für den Benutzer verständlich sind.

  • Der verkette Eingabeobjekt (Typsicher)-Wertauflöser unterhalb unterzieht den vom Benutzer eingegebenen Text einer Typumwandlung in den durch die Dynamische Aufzählung "Wirtschaftsregion" (REGIONS) begründeten Typ. Dies stellt sicher, dass im Aktionsblock geprüft werden kann, ob eine zulässige Eingabe erfolgt ist, denn falls keiner der "Namen" für Aufzählungswerte mit der Eingabe übereinstimmt, gilt im Aktionsblock "Kein Wert" ($null) als Bezugsobjekt.

HINWEISDieses Konfigurationsbeispiel löst die Aufgabe einer Auswahlentscheidung einfacher und "unbürokratischer" als ein Portal mit einem Auswahlfeld/Combobox-Element. Bei der Verwendung des Benutzereingabe (Wertauflöser)-Wertauflösers in einem produktiven Workflow ist allerdings immer zu bedenken, dass zur Laufzeit der Server-Thread für den Workflow unterbrochen wird und belegt bleibt bis der "befragte" Benutzer seine Eingabe bestätigt, den Dialog abbricht oder die Maximale Wartezeit (s) abläuft. Der Benutzereingabe (Wertauflöser)-Wertauflöser sollte eher nicht eingesetzt werden, wenn die Eingabe eher häufig und ggf. von vielen Benutzern gleichzeitig abgefragt werden muss.

images/download/attachments/150865898/image-2024-6-7_19-58-18-version-1-modificationdate-1717783098284-api-v2.png

Komplexerer Anwendungsfall: "Rückwärtssuche" in einer Dynamischen Aufzählung

Ein gegebener Textwert (String) soll wahlweise den zwei- oder dreistelligen Textschlüssel für einen bestimmtes Land (ISO 3166 ALPHA-2 bzw. ALPHA-3) angeben.

Passend zum gegebenen Textschlüssel soll der zugehörige Wert aus der zugehörigen Dynamischen Aufzählung (Land) als Nutzdaten an ein Portal übergeben werden, das Details für das Land anzeigt.

Textschlüssel
(wahlweise) →

(ALPHA-3)"BIH "

(ALPHA-2)
"BA"

images/download/attachments/150865898/image-2024-6-10_8-37-35-version-1-modificationdate-1718001454311-api-v2.png

Konfiguration:

Der Screenshot rechts zeigt die Konfiguration für einen Abschnitt aus einer Ereignisbehandlung, in der der Textschlüssel als äußeres Bezugsobjekt einer Ausführen mit-Ereignisaktion vorliegt:

  • Der Textschlüssel wird initial in die Variable countryCode gespeichert, um den Zugriff im Standardwert-Wertauflöser (s. unten) zu ermöglichen.

  • Dei Konfiguration für den Parameter Objekt-Wertauflöser zielt darauf ab, als temporäres Bezugsobjekt für den Aufruf des Portals (im Aktionsblock) den über den gegebenen Textschlüssel adressierten Wert aus der Dynamischen Aufzählung Land zu gewinnen:

    • Der Eingabeobjekt (Typsicher)-Wertauflöser mit dem Typ Land versucht eine Typumwandlung für den gegebenen Textschlüssel, die gelingt, wenn dieser mit dem "Namen" (name) für ein Land übereinstimmt. Dieser "Name" entspricht per Standard dem ALPHA-2 Code für das Land. Anderenfalls wird "Kein Wert" ($null) zurückgegeben.

    • Der verkettete Standardwert-Wertauflöser wird zur Laufzeit nur ausgewertet, wenn kein Land-Wert mit dem Textschlüssel als "Name" (name) existiert. Dann soll nach einem Land gesucht werden, dessen Konfigurationsmerkmal alpha3Code mit dem Textschlüssel übereinstimmt. Die Wert-Konfiguration für den Standardwert-Parameter definiert die erforderliche "Rückwärtssuche":

Das "gefundene" Land gilt als Bezugsobjekt für die Öffne Portal (Aktion)-Ereignisaktion im Aktionsblock.

images/download/attachments/150865898/image-2024-6-10_8-36-12-version-1-modificationdate-1718001371385-api-v2.png

ANMERKUNG◄ Auf eine "Fehlerbehandlung", für den Fall, dass auch die ALPHA-3-Rückwärtssuche kein Ergebnis liefert, wurde hier verzichtet.