Eingabeobjekt (Typsicher)

Der Parameter Typ definiert die Klasse (oder den Datentyp bzw. Entitätstyp), die abhängig vom Einsatzzweck das Ziel einer Typumwandlung, Typprüfung oder eines Datenabrufs ist.

Im Auswahlfeld für den Typ erleichtert eine Suchfunktion (s. Bild rechts) das Auffinden der passenden Klasse für den jeweiligen Zweck. Diese durchsucht die Lokalisierungstexte der Klassen ebenso wie die intern verwendeten eindeutigen Klassennamen.

►WICHTIG◄ Wie das [+]-Symbol andeutet, lässt das Auswahlfeld auch Freitexteingaben zu, die dann als interner Klassenname interpretiert werden. Wenn man sehr schnell einen Suchbegriff eingibt und dann sofort die Eingabetaste drückt, um den vermeintlichen Treffer auszuwählen, kann es passieren, dass der Suchbegriff als Eingabe für einen internen Klassennamen interpretiert wird, wie im folgenden Beispiel.

Sofort nach dem Eingeben des Suchtexts long für den Typ wird unmittelbar die Eingabetaste gedrückt. Wenn die Suchfunktion die gewünschte Klasse "Long" (java.lang.Long) zu diesem Zeitpunkt noch nicht "gefunden" hatte, verweist der Parameter (s. Bild rechts) unsinnigerweise auf eine unbekannte Klasse (long).

Liegt das gewünschte Ergebnis der Suchfunktion beim Drücken der Eingabetaste bereits vor, erscheint im Auswahlfeld die gewünschte Klasse "Long" (java.lang.Long). Für die meisten Klassen erscheint das Label nicht vollständig im Auswahlfeld. Im Zweifel sollte man daher den Tooltip beachten, der erscheint, wenn der Mauszeiger über das Label bewegt wird.

FALSCH:

RICHTIG:

Die Option Ist Liste von (per Standard "abgewählt") kann ausgewählt werden, um in Verbindung mit dem Typ festzulegen, dass der "Ziel-Typ" eine Liste von Elementen sein soll, die der Klasse Typ entsprechen.

• Ist mindesten ein Listeneintrag im Eingabewert nicht mit der als Typ ausgewählten Klasse kompatibel, dann lautet der Rückgabewert $null.
  
  

• Enthält der Eingangswert keine Liste, lautet der Rückgabewert $null.

►WICHTIG◄ Die Option Ist Liste von veranlasst nicht etwa, dass für alle Elemente einer Liste im Eingabewert "Typumwandlungen" oder "Abrufe von Aufzählungen" ausgeführt werden (s. "FALSCH" unten). In Verbindung mit dem Sammle Werte-Wertauflöser kann der Eingabeobjekt (Typsicher)-Wertauflöser allerdings auch für diesen Zweck genutzt werden.

Das Bild rechts zeigt, wie aus einer Liste von IDs von Benutzerkonten eine Liste der betreffenden Benutzer(-konten) gewonnen werden kann.

FALSCH:

Diese "Fehlkonfiguration" prüft effektiv, ob die Variable entityIds eine Liste von Benutzern enthält. Tatsächlich ist diese als Liste von Long-Werten definiert (s. a. Typhinweis Long[]am unteren Rand der Wertauflöserkette. Der Eingabeobjekt (Typsicher)-Wertauflöser wird daher immer nur $null zurückgeben.

RICHTIG:

►ANMERKUNG◄ Sammle Werte ignoriert $null-Werte. Falls nicht zu allen in der Variable entityIds aufgelisteten IDs wirklich Benutzer existieren, enthält der Rückgabewert weniger Elemente als die Variable und nicht etwa $null-Werte anstelle der betreffenden Einträge.

Eine Hinweis anzeigen (Popup)-Ereignisaktion informiert (z. B. immer dann, wenn ein entsprechend befugter Benutzer ein neues "ITEM" erstellt) über den aktuellen Stand der Statistik für diesen Entitätstyp.

Für die Angabe der Zeitspanne zwischen dem Erstelldatum der ältesten und der jüngsten ITEM-Entität, die hier nicht näher bezeichneten Suchkriterien erfüllen, ist eine einfache Differenzberechnung notwendig.

Die Berechnung soll ausgehend von den Felder für die Projektionen MIN_created und MAX_created im Egebnis der Tupel-Suche durch einen Berechne Wert-Wertauflöser erfolgen.

Damit der Datentyp verrechnet werden kann, muss er zuvor in einen numerischen Datentyp umgewandelt werden. Das Bild zeigt, wie in der Definition für die Variable EARLIEST der Timestamp-Wert aus dem Feld MIN_created über den Eingabeobjekt (Typsicher)-Wertauflöser in einen Long-Wert umgewandelt wird.

Entsprechend verfährt man, um der Variablen LATEST den Long-Wert zum Timestamp aus dem Feld MAX_created zuzuweisen.

Die Long-Werte geben den Datumswert in Millisekunden seit dem 01.01.1970 (UTC) an, sodass die Zeiteinheit für die Differenz noch von Millisekunden (ms) in die Zieleinheit Tage (D) umgerechnet und auf ganze Tage gerundet werden muss. Details zur Umrechnung s. Berechne Wert).

In einem Bestellformular sollen Benutzer einen "Promotion Code" als Freitext eingeben können, um besondere Konditionen zu erhalten:

In Lobster Data Platform / Orchestration ist eine Liste von gültigen Promotion Codes als Dynamische Aufzählung "Promotion code" (PROMOCODE) hinterlegt (s. Screenshot rechts) .

• Im Kopfbereich der Erfassungsmaske für Bestelllungen öffnet ein Klick auf den Button "Promotion code" die Eingabeaufforderung (s. o.).

• Stimmt der eingegebene Code mit einem der internen Namen (s. "Name" in der Liste rechts oben) überein, dann soll der entsprechende Aufzählungswert im pluralen Freie-Aufzählungsattribut "Order Options" hinzugefügt werden, das die Erfassungsmaske als schreibgeschützte Multi-Combobox anzeigt.

• Ist der Code ungültig, soll der Benutzer durch eine Fehlermeldung informiert werden.

►ANMERKUNG◄ Man könnte den Workflow vereinfachen, indem der Benutzer direkten Zugriff auf die Multi-Combobox für die "Order Options" erhält. Allerdings würden dem Benutzer dann alle legitimen "Promotion codes" zur Auswahl im Dropdown angeboten. Diese sollen aber naturgemäß ausschließlich über dedizierte Marketing-Kanäle und selektiv bekannt gemacht werden.

Der Button "Promotion code" löst ein Eigenes Aktionsevent (XF_CHECK_PROMOCODE) aus, dem die (volatilen) Daten der Bestellung als Eingabewert mitgegeben werden.

Auf dieses Auslösende Ereignis reagiert die rechts abgebildete Ereignisbehandlung. Sofern die Typprüfung in der Prüfenden Regel (nicht im Bild) den Eingabewert als "Bestellung" anerkennt, werden die folgenden Aktionen ausgeführt:

• Die Eingabeaufforderung und der Abgleich der Eingabe mit den über die benutzerdefinierte Dynamischen Aufzählung "Promotion Code" (PROMOCODE) legitimierten Codes kann über eine Verkettung von Wertauflösern direkt in der Objekt-Feld-Regel einer Wenn Dann Sonst-Ereignisaktion erledigt werden:
  
  

  • Der Benutzereingabe-Wertauflöser definiert die Eingabeaufforderung und liefert als Rückgabewert die Eingabe des Benutzers.
    
    

  • Der Eingabeobjekt (Typsicher)-Wertauflöser versucht die Eingabe des Benutzers in einen Wert der Dynamischen Aufzählung "Promotion code" umzuwandeln. Taucht die Eingabe nicht als interner "Name" in dieser Aufzählung auf, lautet der Rückgabewert $null. Anderenfalls wird der Aufzählungswert (vom Typ PROMOCODE) zurückgegeben.
    
    

  • Der verkettete Wert als Variable speichern-Wertauflöser "speichert" das Ergebnis der Typumwandlung für die Zuweisung (im Erfolgsfall) ab.

• Bestätigt der Eingabeobjekt (Typsicher)-Wertauflöser die Eingabe als "Promotion code"-Aufzählungswert, dann wird der Wert der Variablen promoCode durch die Setze Wert-Ereignisaktion einem neu hinzugefügten Listenwert (nicht im Bild) des Freie-Aufzählungsattributs "Order options" in der Bestellung übertragen.
  
  

• Verweist die Eingabe nicht auf einen legitimen "Promotion code", dann wird per Abbrechen eine Warnung mit einem lokalisierbaren Fehlertext (error/INVALID_PROMOCODE) ausgelöst.

Das Laufzeitbeispiel rechts zeigt, wie die Ausgabe aussehen soll:

• Im "Titel" der Benachrichtigung soll der Firmen-Metatyp der Firma erscheinen. Im Beispiel ist das entweder "COMPANY" oder "GROUP".
  
  

• Die "Meldung" unterhalb soll folgende Informationen enthalten:
  

  • die ID des betreffenden Firmenkontos

  • ausgewählte Adressdaten der Firma ("Name", "Stadt", "Land")

  • die Standard-Zeitzone (optional)

  • Alle Firmentypen (s. Firmentyp), die dem Firmenkonto zugeordnet sind

Die besondere Herausforderung für die Beschaffung dieser Daten besteht darin, dass das in einer Sitzung verwendete Benutzerkonto (Benutzer der Session) im Feld "Firmen" (companies) zwar auf diese Firmenkonten verweist, deren Detailsdaten aber nicht Datenmodell für Benutzer eingebettet sind. Sie müssen für die gewünschte Ausgabe also ausdrücklich vom Lobster Data Platform / Orchestration-Server abgerufen werden.

Laufzeitbeispiel:

Eine Ereignisbehandlung, die über ein eigenes eingerichtetes Eigenes Aktionsevent ausgelöst wird, wird wie rechts abgebildet konfiguriert:

• Die Für jeden Eintrag wiederholen (Schleife) iteriert über die Liste der relevanten Firmenkonten-IDs aus dem Konto des angemeldeten Benutzers. Dieser wird über den Benutzer der Session ermittelt.
  
  ►ANMERKUNG◄ Der verkettete Eingabeobjekt (Typsicher)-Wertauflöser wird hier nur eingesetzt, damit im folgenden Objekt-Feld-Wertauflöser das Feld "Firmen" (companies) per Dropdown ausgewählt werden kann, was die übergeordnete Klasse "Schnittstelle > Benutzer" nicht der Fall wäre. Solange nicht ein Gastbenutzer die Ereignisbehandlung auslöst, verbessert dieser Eingabeobjekt (Typsicher)-Wertauflöser effektiv nur die Transparenz und den Bedienkomfort bei der Konfiguration.
  
  

• Den Zugriff auf Firmen/Mandanten ausgehend von den im Feld companies aufgelisteten Long-Werten für deren IDs erreichen wir hier im Inneren der Schleife über den Eingabeobjekt (Typsicher)-Wertauflöser mit dem Typ "Firmenkonto" im Parameter Objekt Resolver einer Ausführen mit-Ereignisaktion. In deren Aktionsblock gilt das jeweilige Firmenkonto als Bezugsobjekt, sodass in der Hinweis anzeigen (Popup)-Ereignisaktion für die Parameter Titel und Meldung Details dieses Firmenkontos (und seiner Adresse) "gelesen" werden können.
  
  ►ANMERKUNG◄ Die Meldung wird hier über einen Vorlage-Wertauflöser definiert, über den das gewünschte Ausgabeformat effizienter dargestellt werden kann als über ein Aggregat aus Wertauflösern der Kategorie Textverarbeitung (Wertauflöser), mit denen zweifellos ein vergleichbares Ergebnis erzielt werden könnte.

Im Kopf einer Ausführen mit-Ereignisaktion wird der Benutzereingabe-Wertauflöser verwendet, um dem Benutzer eine Eingabeaufforderung für eine eine komma-separierte Liste von EAN-Codes (als "Artikelnummern") anzuzeigen, die wie folgt verarbeitet wird:

• Die Benutzereingabe-Wertauflöser wird für einen Teilstring innerhalb eines Textverkettung-Wertauflösers eingesetzt, der die eingegebene Zeichenfolge als Nutzlast einer Liste in JSON-Notation formatiert. Für die Eingabe im Laufzeitbeispiel oben wird der folgende Text an den nachfolgenden Objekt aus JSON erzeugen-Wertauflöser weitergegeben: [4005556270415,4105250028005]

• Der Objekt aus JSON erzeugen-Wertauflöser erzeugt aus der aufbereiteten Zeichenfolge das "Objekt" für den folgenden Aktionsblock. Im Idealfall handelt es sich dabei um eine Liste mit einem oder mehreren Werte, die numerisch sein sollten.

Die durch den Benutzereingabe -Wertauflöser erzeugte Eingabeaufforderung sieht keinerlei Eingaberestriktionen oder Validierungen für den eingegebenen Text vor. Insofern soll bevor die Suche ausgeführt wird, sichergestellt werden, dass das über den JSON-Text erzeugte Objekt den Anforderungen entspricht:

• Sofern der Benutzer z. B. durch die Eingabe von Sonderzeichen (etwa ]) die JSON-Notation unbrauchbar macht, wird kein Objekt erzeugt. Im Aktionsblock steht dann kein Bezugsobjekt (bzw. der Wert $null) zur Verfügung.
  
  

• Falls dies der Fall ist, oder der Benutzer abgesehen von den trennenden Kommas nicht-numerische Zeichen eingibt, soll die Suche (Ereignisaktion) im Aktionsblock nicht ausgeführt werden. Dies ermöglicht der Eingabeobjekt (Typsicher)-Wertauflöser, der hier verwendet wird, um zu prüfen, ob das Datenobjekt im Eingabewert eine Liste von Zahlenwerten ist. Als Typ wird dazu "Number" java.lang.Number ausgewählt, also eine übergeordnete Klasse für konkrete Datentypen wie "Long" oder "Double".

Die Wenn Dann Sonst-Ereignisaktion im Aktionsblock stellt über eine Objekt-Feld-Regel mit dem Ist leer-Vergleichstyp sicher, dass die Suchaktion ein Objekt vorhanden ist, bei dem es sich dem Typ nach um eine Liste von numerischen Werten handelt.

►ANMERKUNG◄ Im "Sonst"-Zweig könnte über das -Symbol eine Fehlermeldung bzw. eine Abbrechen konfiguriert werden, um für den Benutzer transparent zu machen, dass keine Suche ausgeführt wird.

Bisherige Konfiguration:

Alternative Konfiguration:

Wenn in Verbindung mit dem Standardwert-Wertauflöser die Suche (Ereignisaktion) immer ausgeführt werden soll, kann die Fallunterscheidung per Wenn Dann Sonst-Ereignisaktion wegfallen. Der Eingabeobjekt (Typsicher)-Wertauflöser kann dann per Verkettung direkt im Kopf der Ausführen mit-Ereignisaktion verwendet werden, wie rechts abgebildet.

Falls der Eingabeobjekt (Typsicher)-Wertauflöser feststellt, dass das via JSON-Notation erzeugte Objekt nicht ausschließlich Number-Werte enthält, soll der verkettete Standardwert-Wertauflöser eine Liste erzeugen, die genau einen Wert enthält - hier: die Dummy-Nummer 9999999999999.

ACHTUNG Falls als Eingabewert für den Eingabeobjekt (Typsicher)-Wertauflöser eine leere Liste ([]) vorliegt, wird diese als "typkonform" behandelt, also nicht durch den Rückgabewert $null ersetzt, sondern als leere Liste ([]) zurückgegeben. Die leere Liste besteht den Test, weil sie keine Elemente enthält, die nicht dem in der Konfiguration ausgewählten Typ entsprechen.

Der Standardwert-Wertauflöser greift in diesem Sonderfall nicht ein, weil die leere Liste ([]) nicht als $null gewertet wird. Im Kontext unseres Beispiels tritt eine leere Liste ([]) auch dann auf, wenn der Benutzer den Button "Abbrechen" in der Eingabeaufforderung betätigt.