• Der Wertauflöser für Elemente muss eine "Liste" zurückgeben, die simple Werte oder komplexe Datenobjekte enthalten kann. Auch ein einzelnes Element muss formal als Element einer Liste übergeben werden, damit er als einzige Option im Kontextmenü erscheint.
  
  

• Der optionale Beschriftungsausdruck (s. Berechnungsausdruck) wird je Listenelement angewendet, um die Beschriftung der Kontextmenüoption zu definieren. Dabei gilt das komplette Listenelement als $input. Der Standardeintrag {label} verweist demnach auf den Wert der label-Felds in einem aufgelisteten Objekt. Ist der Beschriftungsausdruck leer, erscheinen alle Optionen ohne Beschriftung.
  
  

• Der optionale Parameter Datenfeld der Kindknoten identifiziert ein Datenfeld des aufgelisteten Objekts, das eine Liste enthalten kann, die Einträge eines Untermenüs definiert. Auch die darin aufgelisteten Objekte werden anhand Beschriftungsausdruck und Icon Ausdruck als Menüpunkte visualisiert. Dieses Konzept kann kaskadierend, also für mehrere verschachtelte Menüebenen, angewendet werden. Menüeinträge gelten dabei nur dann als auswählbar, wenn sie keine "Kindknoten" enthalten.
  
  

• Der optionale Icon Ausdruck (s. Berechnungsausdruck) wird je Listenelement angewendet, um den Pfad zu einem Icon zu definieren (s. Arbeiten mit Bildressourcen (Icons)). Dabei gilt das komplette Listenelement als $input. Der Standardeintrag {icon} verweist demnach auf den Wert des icon-Felds in einem aufgelisteten Objekt. Ist der Beschriftungsausdruck leer, erscheinen alle Optionen ohne Icon und das Kontextmenü ohne Icon-Spalte.
  
  

• Die Option Suche aktivieren steuert, ob eine Suchfunktion für Kontextmenü-Einträge angeboten wird oder nicht (Standard).

Die weiteren Parameter betreffen das Verhalten des geöffneten Kontextmenüs in Bezug auf die Auswahl eines Eintrags durch den Benutzer. Abhängig vom ausgewählten Modus werden dabei unterschiedliche Konfigurationsmöglichkeiten angeboten:

Als Modus ist per Standard die Option Auswahl zurückliefern vorbelegt, mit der das Kontextmenü synchron geöffnet wird.

• Der Parameter Variablenname des Rückgabeobjekts definiert über welche Variable die nachfolgenden Ereignisbehandlungen auf das Rückgabeobjekt zugreifen können, sobald das Kontextmenü (mit oder ohne Auswahl) geschlossen wird. Wählt der Benutzer einen Menüeintrag aus dem Kontextmenü, dann gilt das zugehörige Listenelement (aus der per Elemente definierten Liste) insgesamt als Rückgabeobjekt.
  
  

• Die Wartezeit Wertrückgabe definiert die Dauer der Wartezeit (in Sekunden) bis zum automatischen Schließen des Kontextmenüs, falls der Benutzer keine Auswahl trifft und das Kontextmenü auch nicht ohne Auswahl schließt. Als Standardwert sind hier 30 Sekunden vorgegeben. Der Mindestwert ist 1 Sekunde. Die Wartezeit kann durch hohe Werte zwar "sehr lang" eingestellt aber nicht als "unbegrenzt" definiert werden.

Alternativ kann der Modus auf die Option Aktion im Client ausführen umgestellt werden, mit dem das Kontextmenü asynchron geöffnet wird, so dass die Ereignisbehandlung ohne eine Auswahl im geöffneten Kontextmenü abzuwarten unmittelbar fortgesetzt wird.

Als einzige Aktion bei Auswahl steht die Option Client Workflow zur Verfügung. Mit der Auswahl dieser Option kann ein Client Workflow definiert werden, den die Ereignisbehandlung zur Laufzeit an den Client zur Ausführung beim Schließen des Kontextmenüs übergibt. Für den Kontext des Client Workflows gilt dabei:

• Das übergebene Eingabeobjekt ist das Rückgabeobjekt des Kontextmenüs. Wählt der Benutzer einen Menüeintrag aus dem Kontextmenü, dann gilt das zugehörige Listenelement (aus der per Elemente definierten Liste) insgesamt als Rückgabeobjekt. Wird das Kontextmenü ohne Auswahl geschlossen gilt das Rückgabeobjekt "kein Wert" ($null).
  
  

• Der asynchron ausgelöste Client Workflow erhält keinen Zugriff auf im Kontext der Ereignisbehandlung definierte Variablen bzw. deren Inhalt. Das bedeutet auch, dass im ausgelösten Client Workflow normalerweise kein Zugriff auf das Eingabeobjekt aus dem aufrufenden Kontext besteht, sofern dieses nicht im Rückgabeobjekt enthalten oder damit identisch ist.

►ANMERKUNG◄ In Verbindung mit dem Modus Aktion im Client ausführen bleibt das Kontextmenü grundsätzlich "unbegrenzt" geöffnet.

Über einen Objekt aus JSON erzeugen-Wertauflöser (s. a. Abschnitt "Beispiele" unten) kann aus der links abgebildeten JSON-Struktur eine "Liste" für den Parameter Elemente in einer Öffne Kontextmenü-Ereignisaktion erzeugt werden.

Laufzeitbeispiel: Das Kontextmenü wird beim Klick auf einen Button geöffnet, um das Ziel einer Tour mehr oder weniger präzise angeben zu können.

• Die Optionen unter "COMPASS" erscheinen nun durch eine horizontale Linie unterteilt nach Nord/Süd und Ost/West.
  
  

• Die Option GPS erscheint nicht nur "inaktiv" (grau), sondern kann auch wirklich nicht ausgewählt werden.

Anstelle des labels wird jetzt ein eindeutiges Feld key bereitgestellt, das gleichzeitig die eindeutige Identifikation und damit den Ansatzpunkt für eine Lokalisierung der Einträge über die Sprachverwaltung (s. rechts) gewährleistet.

• Dem Kontextmenü wird ein eigenes Resource bundle gewidmet (contextHeading), was nicht zwingend notwendig ist aber wartungsfreundlich.

• In der Spalte Resource name sollten alle Werte erscheinen, die in der JSON-Definition (links) als Wert für das Feld key erscheinen. Diese werden hier mit Übersetzungen für die Sprachen Deutsch und Englisch versehen.

• Die Abkürzung GPS muss nicht übersetzt werden.

Detailanforderungen:

• Beim Klick auf einen Button soll ein Kontextmenü geöffnet werden, das relevante Benutzer (mit Name und Benutzername) alphabetisch aufsteigend sortiert auflistet und dabei per Icon auf die für deren Benutzerkonto ausgewählte "Sprache" hinweist.
  
  

• Auswählbar sollen nur Benutzer sein, deren Benutzerkonto "Aktiv" gesetzt ist. "Inaktive" Benutzer sollen ebenfalls aufgelistet werden, aber nicht auswählbar sein.

Laufzeitbeispiel:

• Als Prüfende Regel wird hier eine Statische Regel (mit dem Standardwert true) verwendet, da die Ausführung der folgenden Aktionen ohne einschränkende Bedingungen erfolgen soll.

• Die Suche (Ereignisaktion) definiert eine Tupel-Suche für die Entität Benutzer, die - wie anschließend detaillierter ausgeführt - neben der reinen Auswahl der relevanten auch bestimmte Benutzerdaten für die Darstellung des Kontextmenüs aufbereitet.
  
  

• Das Ergebnis der Suche wird per Variable an die Ereignisaktion Öffne Kontextmenü übergeben, die dem Benutzer die Auswahl überlässt, welcher Ansprechpartner angeschrieben werden soll. Auf eine Überprüfung, ob die Suchaktion überhaupt Ansprechpartner geliefert hat, wird dabei verzichtet. Ggf. erscheint das Kontextmenü daher leer.
  
  

• Damit der E-Mail-Client nur adressiert wird, wenn der Benutzer einen der im Kontextmenü angebotenen Ansprechpartner ausgewählt hat, prüft die folgende Wenn Dann Sonst-Ereignisaktion, ob die zur Übergabe verwendete Variable leer ist.

• Der Parameter Ergebnis speichern als definiert den Namen der Variablen (hier: users), über die nach der Suchaktion auf deren Rückgabewert zugegriffen werden kann.
  
  

• Die gesuchte Entität sind in unserem Beispiel Benutzer.
  
  

• Unter Modus wurde der Suchwert ausgewählt, damit alle "Ergebniszeilen" direkt als Liste zurückgegeben werden.
  
  

• Die Suche wird als Tupel-Suche definiert, da der Zugriff auf komplette Benutzerkonten einerseits nicht erfoderlich ist und andererseits Daten durch die Definition von Projektionen für das Kontextmenü aufbereitet werden sollen.

• Die Felder "Benutzername" (username), "ID" (id) und Sprache (locale) werden direkt als Feldprojektion übernommen.
  
  

• Für die Beschriftung (label) im Kontextmenü werden die Name-Felder aus der Adresse (adresse.name1/2/3) des Benutzers über je ein literales Leerzeichen per "Textverkettungsprojektion" verkettet.
  
  

• Das Feld disabled, das im Kontextmenü steuert, ob ein Ansprechpartner auswählbar ist oder nicht, soll eine Negation des Booleschen Werts aus dem Feld "Aktiv" (active) im Benutzerkonto zugeordnet werden:

Die Negation kann hier nur über eine Wenn ( Case ) Projektion dargestellt werden, was etwas umständlich wirkt, aber mit wenigen Klicks konfiguriert werden kann.

Für das Kontextmenü ist wichtig, dass der als Literale Projektion zugewiesene Werte (true oder false) tatsächlich vom Datentyp Boolean sind und nicht etwa nur gleichlautende Textwerte.

Die Suche (Ereignisaktion) speichert alle zurückgegebenen Ergebniszeilen als Liste in der Variablen users, die damit im Wertauflöser für die Elemente für das zu öffnende Kontextmenü direkt verwendet werden kann:

• Obwohl die gewünschte alphabetische Sortierung nach dem Feld label auch innerhalb der Definition der Suche möglich wäre, soll hier zur Demonstration die Ergebnisliste nachträglich sortiert werden, indem ein Liste sortieren-Wertauflöser verkettet wird, der das Feld label als Vergleichswert verwendet.
  
  

• Der Beschriftungsausdruck verbindet die Felder label und username mit etwas literaler Formatierung.
  
  

• Ein Datenfeld für Kindknoten wird nicht spezifiziert.
  
  

• Der Icon Ausdruck nutzt den Umstand, dass zum Standard von Lobster Data Platform / Orchestration eine Sammlung von Icons für Nationalflaggen gehört, deren Dateiname für viele Staaten zur internen Kennung für die auswählbare "Sprache" (locale) passt. Wie der Ausdruck vermittelt musste allerdings per $replace-Funktion eine Ausnahme definiert werden, damit das Icon für die Flagge von Großbritannien (gb.png) erscheint, wenn die Sprache "Englisch" gewählt ist.
  
  

• Als Modus ist Auswahl zurückliefern gewählt, da das Kontextmenü synchron geöffnet und der aufrufende Client Workflow bis zum Schließen oder dem Ablauf der Wartezeit Wertrückgabe (30 Sekunden) unterbrochen werden soll.
  
  

• Der Variablenname des Rückgabeobjekts legt fest, dass das vom Benutzer ausgewählte Element in der Variable selectedUser gespeichert wird.