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).

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 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.

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.