Die rechts abgebildete Ereignisbehandlung reagiert auf das Auslösende Ereignis (s. Allgemein (Ereignisse)) "Erstellen", das u. a. beim Speichern einer Entitäten durch den Benutzer in einer Erfassungsmaske ausgelöst wird .

In der Prüfenden Regel wird Typprüfung sichergestellt, dass eine Enität des Typs "Ereignis" erstellt werden soll.

Als Aktion bei bestandener Regel wird zunächst die Suche (Ereignisaktion) ausgeführt, die unter allen bisher erstellten Ereignissen nach "vergleichbaren" Vorfällen sucht. Details zu den Kriterien für die Suche sind für den weiteren Workflow unerheblich.

• Die Suche übergibt das erste Ergebnis, also das zuletzt erstellte Ereignis, das alle Suchkriterien erfüllt, in die Variable latestIncident. Auf eine Prüfung, ob überhaupt ein Treffer vorliegt wurde hier zwecks Kürze verzichtet. Dieser Sonderfall kann bei Bedarf per Wenn Dann Sonst abgehandelt werden.
  
  

• Die Ausführen mit-Ereignisaktion definiert das ggf. gefundene Ereignis in der Variable lastIncident als Bezugsobjekt für folgende Aktionen:
  
  

  • Die Hinweis anzeigen (Popup)-Ereignisaktion, soll den Zeitraum seit dem gefundenen Ereignis angeben. Die erforderliche Berechnung kann direkt innerhalb der Meldung mit dem Berechne Wert-Wertauflöser dargestellt werden.
    
    

  • Der wesentliche Rechenschritt ist die Differenz zwischen der aktuellen Systemzeit und dem Erstelldatum des gefundenen Ereignisses im Eingabewert zu ermitteln. Für beide Zeitangaben sollen dabei die UTC-Millisekunden-Werte (seit 01.01.1970) verwendet werden. Entsprechende Angaben sollen über die Variablen now und created durch Wertauflöser ermittelt werden, die weiter unten beschrieben werden.
    
    

  • Innerhalb des Berechnungsausdruck wird die Long-Wert-Differenz now-created zunächst als Millisekunden (ms) deklariert, um diese dann über die convert()-Funktion in die Zeiteinheit "Tag" (D) umzurechnen. Die Zeitspanne in Tage wird mit 10 multipliziert, ganzzahlig abgerundet und danach wieder durch 10 geteilt, was als Rückgabewert einen Zahlenwert in Tagen mit einer Dezimale ergibt.
    
    

  • Die nachfolgende Textverkettung betreibt noch ein bisschen Kosmetik, um das Erscheinungsbild der Ausgabe zu optimieren, so dass anstelle des internen Namens für die Einheit (day) deren Alias (D) in Kleinbuchstaben ausgegeben wird.

Rechts sind Details zur Konfiguration des Berechne Wert-Wertauflösers zu sehen:

• Die erste Variable mit Variablenname now liest den Millisenkunden-Wert der aktuellen Systemzeit, die der Relatives Datum mit Zeit-Wertauflöser per Typ "Jetzt" liefert. Da wir nur die UTC-Millisekunden im Long-Feld "Datumswert" (dateValue) in die Berechnung einbeziehen ist die Zeitzone hier komplett irrelevant.
  
  

• Die zweite Variable created wird aus dem Feld "Erstelldatum" (created) des Eingabewerts - also der Ereignis-Entität - gelesen. Hierbei handelt es sich um den Datumstyp "Timestamp", aus dem über den Eingabeobjekt (Typsicher)-Wertauflöser über eine Umwandlung in Long direkt die UTC-Millisekunden ermittelt werden können.

►HINWEIS◄ Der Datentyp Timestamp kann nicht direkt als numerischer Wert interpretiert werden. Sonst könnte man hier im Ausdruck ohne Umweg über eine Variable per input.created zugreifen.

►ANMERKUNG◄ Die Umrechnung der Millisekunden-Differenz in Tage stützt sich auf Umrechnungsregeln in der Dynamischen Aufzählung Zeiteinheit, die keine kalenderspezifischen Operationen sind, sondern nur zwischen den Zeiteinheiten Millisekunde (ms) und Tag (D)"vermittelt". Entsprechende Umrechnungen könnten hier auch direkt und ohne Konvertierung abgewickelt werden, indem die Millisekunden durch 86.400.000 geteilt werden. So viele Millisekunden hat ein Tag nämlich.

Allerdings fällt mit der convert()-Funktion vergleichsweise leicht, die Ausgabe bei Bedarf auf andere Ziel-Zeiteinheiten umzustellen, in dem deren Alias (etwa das H für Stunden) anstelle von D eingesetzt wird.

Die geeignet initialisierte Ziel-Variable Volume (mit der Vorgabe für die Ziel-Volumeneinheit) steht wie rechts dargestellt am Anfang einer Verkettung von Wertauflösern. Für unser Beispiel sollen "0 Liter" vorbelegt sein.

• Der Berechne Wert-Wertauflöser erhält den Wert der vorbelegten Variable Volume als Eingabewert, auf den der Berechnungsausdruck über den Namen input zugreifen kann. Die verschachtelte Berechnung wird nachfolgend "von innen nach außen" schrittweise beschrieben:
  
  

  • Auf der "innersten" Ebene werden die Längenangaben in den Variablen length, width und height in eine willkürlich gewählte einheitliche Längeneinheit ("Meter" mit Alias m) umgerechnet. Dies leistet die convert()-Funktion mit der Zieleinheit m.

  • Formal wird einem Produkt aus drei Größen mit derselben Einheit diese Einheit auch im Ergebnis zugewiesen. So ergibt sich hier aus den konvertierten Längen ein Zahlenwert, der zwar Kubikmeter "meint", aber technisch als "Meter" ausgewiesen wird. Das ist nicht besonders sinnvoll. Aber aufgrund der vorab ausgeführten Umrechnung der Eingangsdaten in die einheitliche Einheit (m) wissen wir zumindest, dass der Zahlenwert als "Kubikmeter" (m3) zu werten ist.
    
    

  • In der im Screenshot selektierten Zeile 6 wird das Produkt aus den "Längen" noch mit der Alias m3 multipliziert. Innerhalb des viergliedrigen Produkts sollen - aus Sicht des Systems - damit Angaben in nicht-kompatiblen Einheiten (Längen in m vs. Volumen in m3) verrechnet werden. Da dafür keine Umrechnungsvorschrift greift, wird das Produkt als skalare Größe (ohne Einheit) ausgewiesen.
    
    

  • Die skalare Größe, deren Zahlenwert (wie wir wissen) Kubikmeter angibt, wird durch die umgebende convert()-Funktion nun auch formal in die Einheit m3 umgewandelt. Diese Umwandlung würde für eine Angabe in m scheitern.
    
    

  • In der äußersten Ebene kann nun endlich eine echte Umrechnung von den inzwischen formal deklarierten "Kubikmetern" (m3) in die gewünschte Ziel-Volumeneinheit erfolgen. Dafür reicht der Verweis auf den Eingabewert (input) aus, wobei nur dessen Einheit aber nicht dessen Wert berücksichtigt wird.
    
    

• Der verkettete Wert als Variable speichern-Wertauflöser speichert das Ergebnis hier direkt in die Variable Volume, so dass die komplette Wertauflöserkette z. B. direkt in einer Hinweis anzeigen (Popup)-Ereignisaktion verwendet werden kann. Stattdessen könnte man auch eine Setze Wert-Ereignisaktion verwenden, um die berechnete "Zahl mit Einheit" in die Variablen zu schreiben.

Der Screenshot rechts zeigt wie in unserem Beispiel zu Testzwecken die Belegung der Variablen für die Eingangsdaten length, width und height gelöst wurde:

• Für die Variable length wurde hier eine statische "Kommazahl" (mit dem Wert 1,2) zugewiesen. Durch die ausdrückliche Konvertierung im Berechnungsausdruck wird sichergestellt, dass diese eigentlich skalare Angaben als Meter (m) interpretiert wird.
  
  ►HINWEIS◄ Der Dezimaltrenner "Komma" betrifft hier nur die Darstellung im Eingabekontext. Direkt im Berechnungsausdruck müsste man 1.2 schreiben, um dasselbe Ergebnis zu erzielen.
  
  

• Der Variable width wird eine statische Angabe in Zentimetern (cm) zugewiesen. Das funktioniert recht bequem, in dem man wiederum einen Berechne Wert-Wertauflöser mit einem statischen Ausdruck (80cm) einsetzt.
  
  

• Der Variable height wird eine statische Angabe in Fuß (ft) zugewiesen. Wiederum kommt ein Berechne Wert-Wertauflöser mit einem statischen Ausdruck (3.33ft) zum Einsatz.

Für die operative Praxis macht die Zuweisung von statischen Werten für die drei Variablen natürlich keinen Sinn. Ausgehend von der Annahme, dass die Angaben für die drei Dimensionen des Packstücks z. B. als Felder (oder Attribute) eines gemeinsamen Datenobjekts vorliegen, könnte man dieses durch eine Ausführen mit-Ereignisaktion als Bezugsobjekt im Kontext des Wertauflösers definieren, um dann in den Zuweisungen für die Variablen length, width und height über die entity-Variable darauf zuzugreifen. Im Kontext einer nicht näher bezeichneten Entität würde der Zugriff auf ein Feld itemLength für die Zuweisung an die Variable length z. B. so aussehen:

Der Screenshot rechts zeigt eine Wertauflöserkette, der als Eingabewert das Datenobjekt für das Packstück direkt (hier: als Bezugsobjekt) zugeführt wird. Die zu verrechnenden Abmessungen sollen in den Feldern "Länge" (length), "Breite" (width) und "Höhe" (height) jeweils als "Zahl mit Einheit" vorliegen.

Der Berechnungsausdruck ist grundsätzlich aufgebaut wie oben beschrieben, allerdings mit folgenden Anpassungen:

• Der Zugriff auf die Abmessungen erfolgt nun über Datenfeldpfade für die Variable input (in Zeile 3-5).
  
  

• Die Zieleinheit für die Umrechnung in den Zielwert (s. Zeile 8) wird nun nicht mehr aus dem input sondern aus der Variable Volume bezogen, die ursprünglich noch als input galt.

►HINWEIS◄ Die explizite "Zuordnung" der numerischen Eingangsgrößen in Variablen entfällt hier komplett. Allerdings funktioniert dieser Zugriff nur, solange die gelesenen Daten direkt als numerische Werte (hier: mit Einheit) im input vorliegen.

►ANMERKUNG◄ Für Tests kann z. B. ein Erzeuge Instanz mit Werten-Wertauflöser als Start für die Wertauflöserkette ergänzt werden, um ein "Packstück" als Client-Objekt bereitzustellen.

Im Kontext einer Mit-Regel, die den zu bewertenden Benutzer als Bezugsobjekt definiert (z. B. den Benutzer der Session), wird das im Screenshot rechts abgebildete Kriterium geprüft:

• Eine Typprüfung stellt zunächst sicher, dass ein "Benutzer" als Bezugsobjekt vorliegt und (mit Blick auf den Benutzer der Session ggf. entscheidend) kein Gastbenutzer.
  
  

• Innerhalb einer UND-Verknüpfung folgt eine Objekt-Feld-Regel nach, über den Vergleiche mit (Vergleichstyp)-Vergleichstyp feststellen soll, ob die als Prüfwert (links) berechnete "Reichweite" in der gewünschten Relation (≥) zum Vergleichswert (rechts) steht.
  
  

  • Der Prüfwert kann mit dem Berechne Wert-Wertauflöser sehr elegant ermittelt werden, da die benötigen Eingangsdaten direkt im Eingabewert (input) adressiert werden können. Das length-Feld gibt jeweils die Anzahl der Einträge im übergeordneten Listenfeld des Benutzerkontos wieder. Der Berechnungsausdruck nutzt diese Information für die Listenfelder "Firmen" (companies) und "Rollen" (roles) des Benutzerkontos.
    
    

  • Der Vergleichswert wird hier als statischer Long-Wert 3 festgelegt.

►ANMERKUNG◄ Dass der Wert im Objekt-Feld length hier nur auf eine interne Berechnung (für "Listen") zurückgeht und nicht etwa auf ein persistiertes Datenbankfeld des Benutzers, spielt für den Zugriff per Datenfeldpfad keine Rolle.

Der Screenshot rechts zeigt eine Ausführen mit-Ereignisaktion, für deren Aktionsblock die Map in der sales-Variable als temporäres Bezugsobjekt gilt.

Berechnung und Wertzuweisung können innerhalb derselben Setze Wert-Ereignisaktion abgewickelt werden:

• Als Ziel für die Wertzuweisung (links) wird ein Map-Wert über den durch statischen Text bestimmten Schlüssel TOTAL identifiziert. Ob dieser bereits einen Wert enthält bzw. überhaupt existiert ist nicht von Belang.
  
  

• Der zuzuweisende Wert (rechts) wird über den Berechne Wert-Wertauflöser ermittelt, für den die Map (sales) im Bezugsobjekt als Eingabewert (input) gilt. Der Berechnungsausdruck kann ganz einfach alle möglicherweise relevanten "Schlüssel" in der Map im Eingabewert (input) abrufen und aufaddieren. Für nicht gefundene Schlüssel wird der Wert 0 verwendet.

Der Screenshot rechts zeigt eine Wertauflöserkette (s. Verketteter Wertauflöser), über die das "Gesamtmoment" z. B. als Meldung in einer Hinweis anzeigen-Ereignisaktion ermittelt werden kann:

• Der Variable-Wertauflöser stellt eine konkrete Aircraft-Entität bereit, die alle Rohdaten für eine Weight & Balance-Ermittlung enthält.
  
  

• Der verkettete Berechne Wert-Wertauflöser erhält das komplette Aircraft-Objekt als Eingabewert (input) und kann im Berechnungsausdruck die maximal definierbaren 4 Bereiche (areas) mit je 2 Zonen (zones) in einem Gesamtansatz für das "Gesamtmoment" verarbeiten.
  
  ►WICHTIG◄ Für nicht parametrierte Bereiche und Zonen wird jeweils der Wert 0 berücksichtigt, was diesen konkreten Rechengang nicht beeinträchtigt.
  
  

• Das Gesamtergebnis der berechneten "Produktsumme" (Gewicht x Hebelarm) wird als "Gesamtmoment" über einen Wert als Variable speichern-Wertauflöser in die Variable totalMoment geschrieben.