Die Benutzerin "Karola Mustermann" ist für den Portalbetreiber (Xflow AG) als "CustomerAccountManager" angemeldet und greift über die "Firmenübersicht" auf das Firmenkonto einer Kundenfirma zu:

• Im Tab "Kontakte" werden dort die Adresskontakte der Firma aufgelistet. Bisher verweist die Liste der Kontakte nur auf den "Geschäftsführer".
  
  ►ANMERKUNG◄ Das Formularlayout im Bild rechts wurde gegenüber dem Standard leicht angepasst. U. a. wird das Symbol zum Löschen von Einträgen ausgeblender. Stattdessen wurde ein Button zum "Löschen" innerhalb des wiederholten Containers für den Adresskontakt hinzugefügt. Dieser kann abhängig vom Kontakttyp aktiv oder inaktiv gesetzt werden, um das Löschen zu erlauben oder zu verhindern (s. Element entfernen (Optionales/Wiederholendes Element)).
  
  Im vorliegenden Anwendungsfall soll ein Adresskontakt mit dem Kontakttyp "Kundenbetreuer" nicht gelöscht werden können und außerdem bis auf den Button für den "E-Mail"-Versand deaktiviert erscheinen (s. Screenshot rechts unten).

Sobald die Bearbeitung des Firmenkontos der "fast-or-furious Ltd." per "Speichern" (im Ribbon) abgeschlossen wird, erscheint im Firmenkonto ein Adresskontakt vom Typ "Kundenbetreuer", der die Adresse des Benutzerkontos (s. Benutzer) von "Karola Mustermann" wiedergibt.

Sichtbar angezeigt werden hier nur die Name-Felder, allerdings bietet der Adresskontakt Zugriff auf die gesamte Adresse, so dass z. B. die hier nur angedeutete E-Mail-Funktion die ggf. enthaltenen Kommunikationsinformationen verwenden kann.

Für die "Registrierung" des Benutzers, der die letzte Änderung an einem Firmenkonto ausführt, wird eine Ereignisbehandlung angelegt und wie rechts gezeigt konfiguriert:

• Als Auslösende Ereignisse werden die Ereignisse "Erstellen" und "Ändern" (s. Allgemein (Ereignisse)) festgelegt.
  
  

• Die Prüfende Regel stellt per Typprüfung fest, ob der Eingabewert vom Typ "Firmenkonto" ist. Ist dies der Fall, wird das UND-verknüpfte Sub-Zuordnungskriterium ausgewertet, das per Rollenregel feststellt, ob im Anmeldungskontext die Rolle "CustomerAccountManager" beansprucht wird.

• Als Aktion bei bestandener Regel wird eine Ereignisaktion vom Typ Ausführen mit eingefügt, die dazu dient das Bezugsobjekt abweichend vom als Eingabewert anliegenden Firmenkonto zu definieren:
  
  

  • Das Firmenkonto aus dem Eingabewert wird per Parameter Firmenkonto in Variable speichern in einer Variablen mit dem Namen company gespeichert.
    
    

  • Im Objekt-Resolver wird per Verkettung zuerst der Benutzer der Session ermittelt und dann per Eingabeobjekt (Typsicher) das zugehörige Benutzerkonto gelesen. Dort findet man im Feld address die Adresse, die als Adresskontakt für den "Kundenbetreuer" hinzugefügt werden soll. Diese gilt für den folgenden Aktionsblock als Bezugsobjekt.
    
    

• Im Aktionsblock der Ausführen mit-Ereignisaktion folgt als einzige Ereignisaktion .Adresse als Kontakt einer Firma hinzufügen v4.12.0 mit folgenden Parametern:
  
  

  • Als Kontakttyp wird als statischer Wert (per "Jede dynamische Aufzählung"-Wertauflöser, s. Statische Werte) der Typ "Kudnenbetreuer" zugewiesen.
    
    

  • Der Zugriff auf die Zielfirma, die außerhalb der Ausführen mit-Ereignisaktion als Eingabewert gilt, ist innerhalb der Ausführen mit-Ereignisaktion nur über die Variable company verfügbar.

►ANMERKUNG◄ Dass die Zielfirma hier auch als Eingabewert der Ereignisbehandlung gilt ist eher Zufall. Falls die Adresse von "Frau Mustermann" in unserem Beispiel noch nicht als Adresskontakt vom Typ "Kundenbetreuer" eingetragen ist, wird das "Ändern" Ereignis für das Firmenkonto doppelt ausgelöst, weil das Hinzufügen des Adresskontakts wiederum als Änderung gilt.

Im Zuge der Adressierung einer Sendung soll für das Firmen- und Adressattribut "Abholadresse" (Firmentyp DPA) im ersten Schritt ein Firmenkonto ausgewählt werden, um dann im zweiten Schritt ggf. eine präzise Abholposition (hier: "Abholadresse Adresse") angeben zu können, die in die Adresse desselben Firmen- und Adressattributs gespeichert wird.

Beim Auswählen der Firma für die "Abholadresse", wird in der Erfassungsmaske die Aktion Kontakte dieser Firma verwenden für das Auswahlfeld/Combobox der "Abholadresse Adresse" ausgeführt. Im Beispiel soll dieses dann alle Adresskontakte mit Kontakttyp "Zufahrt/Tor" oder "Gebäude" zur Auswahl anbieten, die im Firmenkonto der ausgewählten Firma gefunden werden.

Alternativ kann auch eine komplett neue "Abholadresse Adresse" eingegeben werden.

Über den Button "Als Kontakt der Firma hinzufügen" soll eine neu eingegebene oder auch geänderte Adresse der Firma als Kontakt hinzugefügt werden können. Dabei soll der Benutzer den dabei zugewiesenen Kontakttyp für den Adresskontakt per Kontextmenü (s. Screenshot rechts) aus den für die Abholadresse relevanten Optionen festlegen können.

Für das Auslösende Ereignis "Adresse hinzufügen" (s. Adresse (Ereignisse)) wird die rechts abgebildete Ereignisbehandlung konfiguriert:

• Die Prüfende Regel stellt per Typprüfung sicher, dass als Eingabewert eine "Adresse" übergeben wurde. Beim Auslösen des Ereignisses durch den Button "Als Kontakt der Firma hinzufügen" sollte dies implizit gewährleistet sein. Die Typprüfung deklariert hier also im Wesentlichen den Datentyp "Adresse" für den Eingabewert.
  
  ►ANMERKUNG◄ Das Ereignis wird hier allgemeingültig definiert und verzichtet deshalb auf weitere Regeln für die übergebene "Adresse" oder die Werte der beim Auslösen des Ereignisses automatisch befüllten Variablen (contactCompanyId, contactType und contactTypes).
  
  

• Unter den Aktionen bei bestandener Regel soll deshalb zunächst festgestellt werden, ob der Kontakttyp, der dem Firmenkonto hinzugefügt werden soll durch den Kontext eindeutig bestimmt ist. Die Ausführen mit-Ereignisaktion definiert im Objekt Resolver zu diesem Zweck die Kontakttyp-Liste in der Variablen contactTypes als abweichendes Bezugsobjekt für den folgenden Block von Ereignisaktionen:
  
  

  • Eine Wenn Dann Sonst-Ereignisaktion untersucht durch eine Objekt-Feld-Regel das Feld length der Liste, um festzustellen, ob diese mehr als ein einziges Element enthält. Nur wenn dies der Fall ist, soll der Benutzer per Kontextmenü aus den vorhandenen Optionen auswählen müssen.
    
    

  • Ist eine Entscheidung erforderlich soll die Öffne Kontextmenü-Ereignisaktion die lokalisierten Texte für die in der Liste enthaltenen Kontakttypen als Optionen anzeigen.
    
    

    • Da die Liste bereits als Bezugsobjekt anliegt, gibt der unter Elemente eingefügte Objekt-Feld-Wertauflöser ohne Feld die ganze Liste.
      
      

    • Der Beschriftungsausdruck greift mit der Sytnax [bundle, resource]auf die Sprachverwaltung zu, um dort im Bundle de.lobster.scmbase.address.attributes.ContactType den Lokalisierungseintrag für den Namen des jeweiligen Kontakttyps (Resource {name}) nachzuschlagen.
      
      

    • Als Variablenname des Rückgabeobjekts wird hier die Variable contactType angegeben, die bis zum Aufruf des Kontextmenüs den ersten Wert der Liste enhält, weil das Ereignis "Adresse hinzufügen" diese Variable automatisch vorbelegt.
      
      

    • Die Auswahl im Kontextmenü gibt den angeklickten Kontakttyp zurück, sofern der Benutzer nicht die hier auf 300 Sekunden eingestellte Wartezeit Wertrückgabe verstreichen lässt oder das Kontextmenü ohne Auswahl schließt (per Esc-Taste oder durch einen Mausklick ins Formular).

►ANMERKUNG◄ Die bereits vorbelegte Variable contactType wird hier gezielt auch als Ziel für das Rückgabeobjekt des Kontextmenüs ausgewählt, damit innerhalb der Ereignisaktion Adresse als Kontakt einer Firma hinzufügen für den Parameter Kontakttyp immer der Wert der Variablen contactType übernommen werden kann. Im Sonderfall eines Abbruchs bzw. Timeouts nach dem Öffnen des Kontextmenüs sollte dann aber verhindert werden, dass die Ereignisaktion Adresse als Kontakt einer Firma hinzufügen überhaupt ausgeführt wird, sonst wird "kein Wert" als Kontakttyp übergeben, was zu einem Abbruch mit Fehlmeldung (inkl. Rollback) führt.

Nach dem Abschluss der Ausführen mit-Ereignisaktion, die nur relevant ist, wenn der Kontakttyp nicht eindeutig vorbestimmt ist, gilt wieder die hinzuzufügende Adresse als Bezugsobjekt. In diesem Kontext soll die Ereignisaktion Adresse als Kontakt einer Firma hinzufügen ausgeführt werden:

• Innerhalb einer Wenn Dann Sonst-Ereignisaktion wird allerdings vorher geprüft, ob die Variable contactType nicht leer ist:
  
  

  • Gibt die Variable den vorbestimmten oder ausgewählten Kontakttyp an, dann wird die Ereignisaktion Adresse als Kontakt einer Firma hinzufügen ausgeführt, wobei als Kontakttyp die Variable contactType und als Zielfirma die Variable contactCompanyId zugewiesen wird.
    
    ►HINWEIS◄ Falls im Anmeldekontext der Sitzung keine Berechtigung zum Ändern des betreffenden Firmenkontos besteht, sollte die Ereignisaktion innerhalb einer Ausführen als-Ereignisaktion mit abweichendem Anmeldekontext ausgeführt werden.
    
    

  • Ohne Angabe für den Kontakttyp - also wenn der Benutzer ein Kontextmenü ohne Auswahl beendet hat - soll die Ereignisbehandlung kommentarlos und ohne weitere Ereignisaktionen beendet werden.