Regel-Listen Resolver

Das Auswahlfeld für den Elementtyp ermöglicht eine statische Einfachauswahl eines konkreten Typs oder einer übergeordneten Klasse (im Sinne einer Typprüfung), die unterschiedliche konkrete Typen abgedeckt.

Wie im Bild zu sehen wird eine Suchfunktion angeboten, die sowohl die internen Namen als auch die im Kontext anwendbare Lokalisierung betrifft.

Falls ein Elementtyp ausgewählt ist, gelten nur Einträge aus dem Eingabewert als akzeptabel, die eine Typprüfung gegen die ausgewählte Klasse bestehen würden.

Ohne Auswahl eines Elementtyp gelten alle Einträge aus dem Eingabewert als akzeptabel.

Die Option Alle Werte als Liste kann ausgewählt werden, um als Rückgabewert eine Liste aller Einträge aus dem Eingabewert zu erhalten, die alle durch die anderen optionalen Parameter konfigurierten Akzeptanzkriterien erfüllen.

Ein Klick auf das -Symbol leitet die Konfiguration einer Regel ein, die anschließend durch UND- und ODER-Verknüpfungen beliebig komplex ausgebaut werden kann.

Im Beispiel rechts wurde eine Objekt-Feld-Regel ausgewählt, um für Einträge mit dem ausgewählten Elementtyp "Ort" (s. Orte) zu prüfen, ob deren Feld "Bezirk-Code" (countyCode) ausgefüllt (s. Ist leer und not (Vergleichstyp)) ist.

►HINWEIS◄ Sofern aufgrund des Kontexts in der Konfiguration der Eingabewert als Liste von Orten (Ort[]) definiert ist, muss der Elementtyp "Ort" nicht explizit ausgewählt werden, um die "passende" Feldauswahl im Dropdown des Objekt-Feld-Wertauflösers zu erhalten. Die zusätzliche "Deklaration" über den Parameter schadet dann allerdings auch nicht. Entscheidend ist die Angabe des Elementtyps, wenn dadurch nur eine Teilmenge von Einträgen aus einer heterogenen Liste (mit Objekten unterschiedlicher Klassen) als akzeptabel gelten soll.

Die rechts dargestellte Konfiguration dient ausschließlich zur Demonstration der Effekte unterschiedlicher Parametrierungen für den Regel-Listen Resolver mit dem immer gleichen Eingabewert.

Dieser wird hier im Parameter Objekt Resolver einer Ausführen mit-Ereignisaktion über einen Erzeuge Liste-Wertauflöser als Liste mit statisch bestimmten Einträgen unterschiedlicher Datentypen definiert:

• Der erste Wert ist der statische Long-Wert 123.
  
  

• Der zweite Wert ist die statische Kommazahl 3.57.
  
  

• Der dritte Wert ist der statische String-Wert 0815.

Diese Liste wird per Verkettung als Eingabewert an einen Regel-Listen Resolver übergeben. Die Tabelle stellt unterschiedliche Parametrierungen und das resultierende Ergebnis (als String-Abbild des Rückgabewerts) gegenüber.

In der Konfiguration erzeugt eine Hinweis anzeigen (Popup)-Ereignisaktion dieses String-Abbild, indem der Rückgabewert des Wertauflösers als Text einer Meldung ausgegeben wird.

Der Titel der Meldung gibt die Anzahl der Einträge in der zurückgegebenen Liste an.

Die folgenden Tabelle listet unterschiedliche Parametrierungen für den Regel-Listen Resolver auf, die sich am recht abgebildeten Schema orientieren:

• Ein Elementtyp wird ausgewählt oder nicht.
  
  

• Die Option Alle Werte als Liste ist ausgewählt oder nicht.
  
  

• Eine Regel wird nicht konfiguriert.

►ANMERKUNG◄ Wie die Darstellungen recht zeigen, beeinflusst die Option Alle Werte als Liste zusammen mit der Auswahl für den Elementtyp den Datentyp für den Rückgabewert.

Im konkreten Fall ist als Datentyp für den Rückgabewert oben (mit ausgewählter Option Alle Werte als Liste) eine Liste von Zahlenwerten (Number[]) zu erwarten, während unten nur mit einem einzelnen Zahlenwert (Number) zu rechnen ist.

"Alle Number-Werte als Liste":

"Nur erster Number-Wert":

Der Screenshot rechts zeigt die Konfiguration für ein Zuordnungskriterium, das genau dann zutrifft, wenn die Firma der Session mehr als einem Firmenkonto mit dem Firmen-Metatyp "Gruppe" (GROUP) untergeordnet ist:

• Die primären Daten für die Prüfung liefert hier der Firma der Session-Wertauflöser, nämlich das Firmenkonto der angemeldeten Firma.
  
  

• Der verkettete Objekt-Feld-Wertauflöser greift auf das Feld "Übergeordnete Firmen" (parentCompanies) dieses Firmenkontos zu und liefert die darin gespeicherte Liste von Long-Werten, die sich auf die IDs der übergeordneten Firmenkontos beziehen.
  
  

• Der verkettete Regel-Listen Resolver soll aus dieser Liste die Teilmenge der IDs herausfiltern, die sich auf Gruppen-Firmenkonten beziehen:
  

  • Die Option Alle Werte als Liste ist ausgewählt, da für unser Prüfkriterium die Anzahl aller übergeordneten Gruppen entscheidend ist.
    
    

  • Damit die Objekt-Feld-Regel den "Metatyp" (metaType) einer übergeordneten Firma prüfen kann, muss ausgehend von der ID zunächst das komplette Firmenkonto beschafft werden. Dies leistet der Eingabeobjekt (Typsicher)-Wertauflöser, der auf der linkes Seite mit dem Objekt-Feld-Wertauflöser für das Feld "Metatyp" verkettet wird.

  • Auf der rechten Seite des Ist Gleich-Vergleichs wird der relevante Firmen-Metatyp "Gruppe" (GROUP) statisch ausgewählt.
    
    

• Das eigentliche Prüfkriterium bildet die äußere Objekt-Feld-Regel (per Vergleiche mit (Vergleichstyp) "> (größer)") ab. Dabei wird die Anzahl der Einträge (Feld length) im Rückgabewert vom Regel-Listen Resolver mit dem Vergleichswert 1 gegenübergestellt.

Der Screenshot rechts zeigt die Konfiguration für eine Ereignisbehandlung, die auf ein eigens eingerichtetes Eigenes Aktionsevent XF_CALL_LAST_MODIFIER als Auslösendes Ereignis reagiert.

Die Prüfende Regel beschränkt sich auf eine Typprüfung, die sicherstellt, dass im Kontext des Ereignisses eine Entität vorliegt. Damit sollte gewährleistet sein, dass das Feld lastModifierId existiert und ggf. auf die ID eines Benutzers verweist.

►ANMERKUNG◄ Die Möglichkeit, dass Gastbenutzer eine Entität ändern können, soll hier nicht berücksichtigt werden.

Als Aktion bei bestandener Regel wird hier eine Ausführen mit-Ereignisaktion verwendet, da ausgehend von der lastModifierId aus der Entität im Kontext als abweichendes Bezugsobjekt das betreffende Benutzerkonto gesetzt werden soll. Dies ermöglicht der mit der ID verkettete Eingabeobjekt (Typsicher)-Wertauflöser.

Mit dem Benutzerkonto als Kontext wird eine Hinweis anzeigen (Popup)-Ereignisaktion ausgeführt, die im Titel innerhalb einer Textverkettung zunächst auf das Feld "Benutzername" (username) zugreift, das den Benutzer in der Benachrichtigung identifizieren soll.

Die Meldung verwendet ebenfalls den Textverkettung-Wertauflöser, um die relevante Telefonnummer in Verbindung mit einer Beschriftung auszugeben. Diese wird über eine Verkettung von Wertauflösern beschafft, in der dem Regel-Listen Resolver die buchstäblich entscheidende Rolle zukommt:

• Zunächst muss der Objekt-Feld-Wertauflöser auf das address-Feld des als abweichendes Bezugsobjekt vorliegenden Benutzerkontos zugreifen.
  
  

• Der verkettete Plurale Attribute-Wertauflöser liefert die Liste aller Kommunikationsinformationen innerhalb dieser Adresse.
  
  

• Der verkettete Regel-Listen Resolver sucht in dieser Liste den ersten Treffer (Option Alle Werte als Liste ist abgewählt), für den die beiden in der Regel UND-verknüpften Kriterien zutreffen:
  
  

  • Die erste Objekt-Feld-Regel prüft, ob der Kommunikationstyp "Mobil" (MOBILE) vorliegt.
    
    

  • Die zweite Objekt-Feld-Regel prüft, ob als "Kontext" (communicationContext) der Textschlüssel 24/7 eingetragen ist.
    
    

• Falls die Adresse eine Kommunikationsinformation enthält, die beide Kriterien erfüllt, kann der verkettete Objekt-Feld-Wertauflöser anschließend deren Feld "Wert" (communicationValue) für den Text der Meldung beisteuern.

►ANMERKUNG◄ Im Beispiel wurde auf eine "Fehlerbehandlung" für den Fall verzichtet, dass im Benutzerkonto kein Wert für die "24/7-Mobilnummer" angegeben ist. Über den Standardwert-Wertauflöser könnte ein Hinweistext wie "n/a" zugewiesen oder mit der im Beispiel demonstrierten Zugriffsmethode nach einer Kommunikationsinformation mit einer abweichenden Spezifikation (z. B. Typ "MOBILE" und Kontext "PRIVATE", s. Beispieldaten oben) als Ersatz gesucht werden.