Wert aus Sprachverwaltung

Eine Ereignisbehandlung, die auf das Ereignis "Client angemeldet" (s. Anmeldung (Ereignisse)) reagiert, stellt in der Prüfenden Regel fst, ob die Anmeldung eine der "besonders privilegierten Rollen" betrifft.

Wie im Screenshot zu sehen, können die betreffenden Rollen in einer Rollenregel per Mehrfachauswahl buchstäblich "handverlesen" festgelegt werden.

►ANMERKUNG◄ Das Label in der Mehrfachauswahl zeigt die internen Rollennamen (roleName) unabhängig davon ob eine Lokalisierung vorliegt.

Als einzige Aktion bei bestandener Regel wird muss eine Hinweis anzeigen (Popup)-Ereignisaktion konfiguriert werden:

• Als Typ wird "Warning" ausgewählt, damit die Benachrichtigung als "Warnung" (mit dem Standard-Farbschema weiß/orange) erscheint.
  
  

• Als Titel soll deshalb auch die Standardbeschriftung des Systems für eine Warnung erscheinen. Systemseitig liegt im Bundle common eine Resource warning vor, die per Standard geeignet lokalisiert ist ("Warnung"). Der Standardwert common/warning ist nur in dem Sonderfall relevant, dass der Lokalisierungseintrag für die Aktuelle Sprache UND für die Standard-Sprache (soweit abweichend) fehlt.
  
  

• In der Meldung soll die Lokalisierung für die Rolle der Session angezeigt werden. Lokalisierungen für Rollen beziehen sich auf das Bundle rolename, wobei als Resource der interne Name der Rolle aus deren Feld roleName angegeben werden muss. Dieselbe Konfiguration (Rolle der Session und Objekt-Feld-Wertauflöser für roleName) wird auch für den Standardwert eingerichtet. Dies ist hier wichtiger als für den Titel, da für Rollen per Standard keine Lokalisierung vorliegt. Ohne Lokalisierung und ohne Standardwert würde dann "kein Wert" ($null) zurückgegeben.

►ANMERKUNG◄ Für den Parameter Schließen nach (Sekunden) wird hier der Wert 0 angegeben, damit die Warnmeldung "unbegrenzt" angezeigt bleibt (bzw. bis der Anwender sie schließt). Sie bleibt dann allerdings auch sichtbar, wenn ein Schnellwechsel zu einer anderen (ggf. weniger privilegierten) Rolle ausgeführt wird, für die keine neue Warnung erscheint.

Der Screenshot rechts zeigt in der Vorschau für E-Mails den Betreff für eine E-Mail die beim Löschen einer Rolle mit der internen ID #3301 ausgelöst wird.

Relevant für eine Lokalisierung sind im Betreff die folgenden Komponenten:

• Ereignis ("Löschen", "Erstellen")

• Entitätstyp ("Rolle", Benutzer", "Firmenkonto")

Zum Vergleich zeigt der Screenshot rechts ein Beispiel für eine Nachricht, die ohne Lokalisierung ausgegeben wurde.

• Der Text DELETE ist hier der interne Name des Ereignisses "Löschen".

• Anstelle des Entitätstyps erscheint die String-Abbildung der Klasse für Rollen.

Für die E-Mail-Benachrichtigung wird eine Ereignisbehandlung wie rechts abgebildet konfiguriert:

• Als Auslösende Ereignisse werden die Standard-Ereignisse Erstell und Löschen aus der Kategorie "Allgemein" ausgewählt.

• Die Prüfende Regel prüft per Typprüfung ob es um einen der als "sensibel" eingestuften Entitätstypen geht. Der ver-ODER-ten Reihe können weitere Elemente hinzugefügt werden.

• Es werden genau zwei Aktionen bei bestandener Regel benötigt:
  
  

  • Eine Setze Wert-Ereignisaktion weist der Variablen mailToUser das Konto des Benutzers zu, der benachrichtigt werden soll. Im Beispiel wird immer derselbe Benutzer zugewiesen, stattdessen könnte aber auch eine Fallunterscheidung oder Suche konfiguriert werden, um die Zuständigkeit dynamisch zu regeln.

  • Alle weiteren Konfigurationen betreffen direkt die folgenden E-Mail-Versand-Ereignisaktion.

►HINWEIS◄ Nachfolgend wird nur die Lokalisierung für den "Betreff" der E-Mail im Detail ausgeführt.

Der Text für den Betreff innerhalb der E-Mail-Versand-Ereignisaktion wird hier über einen Textverkettung-Wertauflöser schrittweise aufgebaut:

• Die erste Teilzeichenfolge der Verkettung soll den lokalisierten Namen für das Ereignis ausgeben, das die Ereignisbehandlung ausgelöst hat.
  
  

  • Da die Ereignisse "Erstellen" und "Löschen" beide der Kategorie "Allgemein" angehören, können wir den Namen für das Bundle statisch über den Klasse-Wertauflöser definieren, dessen String-Abbildung das Bundle benennt: de.lobster.scm.action.event.CommonActionEvent
    
    

  • Den Schlüsselwert liefert der Auslösendes Ereignis-Wertauflöser, dessen Rückgabewert als String-Abbildung direkt für den Parameter Resource verwendet werden kann (Werte: DELETE, CREATE).

  • Der Standardwert wiederholt die Konfiguration für den Parameter Resource, auch wenn eine Lokalisierung für die Allgemein-Ereignisse systemseitig mindestens durch die Standard-Sprache (als Fallback) gewährleistet sein sollte.
    
    

  • Es werden keine Werte für Parameter angegeben.
    
    

  • Die Sprache wird aus dem Feld "Sprache" (locale) des über die Variable mailToUser angegebenen Benutzerkontos zugeordnet.
    
    

• Die zweite Teilzeichenfolge gibt einen statischen Text (" / ") als Trennzeichen vor.

• Die dritte Teilzeichenfolge soll den lokalisierten Namen des Entitätstyps ausgeben, der erstellt oder gelöscht wurde:
  

  • Die vom System automatisch befüllte Variable entityClass verweist allgemein auf die Klasse des Bezugsobjekts und im Kontext eines "Erstellen" oder "Löschen" Aktion auf den Typ der betreffenden Entität. Die String-Abbildung der Klasse kann hier direkt dem Parameter Bundle zugewiesen werden.
    
    

  • Der lokalisierte Name für einen Entitätstyp ist per Standard per Resource $name abrufbar.
    
    

  • Auch wenn für die im Beispiel relevanten Entitätstypen mindestens für die Standard-Sprache systemseitige Lokalisierungen abrufbar sein sollten, wird der Standardwert hier ebenfalls die Zeichenfolge $name zugeordnet. Ggf. könnte man per Textverkettung noch den Wert der Variablen entityClass ergänzen.
    
    

  • Die Sprache wird wie oben beschrieben aus dem Konto des Benutzers gelesen, der angeschrieben wird.
    
    

• Die vierte Teilzeichenfolge definiert einen statischen Text (" #") zur Trennung und als Präfix für die nachfolgende ID (id).
  
  

• Die vierte Teilzeichenfolge identifiziert das Bezugsobjektfür das Ereignis , also die zu erstellende oder zu löschende Entität, über dessen Feld ID (id).
  ►WICHTIG◄ Da eine neue Entität im Kontext des "Erstellen"-Ereignisses noch nicht über eine ID verfügt, sollte für die E-Mail-Versand-Ereignisaktion die Option "Mailinhalt erst beim Commit erstellen" ausgewählt sein, sonst wird die ID 0 ausgegeben.

Anstelle des Textverkettung-Wertauflösers wird in der rechts abgebildeten Konfiguration eine weitere Instanz des Wert aus Sprachverwaltung-Wertauflösers eingerichtet:

• Der äußere Wert aus Sprachverwaltung-Wertauflöser dient hier nur als Plattform, um den Standardwert ({0} / {1} #{2}) ins Spiel zu bringen. Die Parameter Bundle und Resource bleiben leer, da wir tatsächlich nicht auf der Suche nach einem Sprachverwaltungseintrag sind.
  
  

• Die Liste der Parameter kann durch Kopieren und Einfügen der Konfigurationen für die entsprechenden Teilzeichenfolgen aus dem Betreff "zusammengeklaut" werden:
  
  

  • Der erste Parameter ({0}) beschafft die Lokalisierung für das auslösende Ereignis über einen Wert aus Sprachverwaltung-Wertauflöser (Details s. o.) .
    
    

  • Der zweite Parameter ({1}) beschafft die Lokalisierung für den Entitätstyp über einen Wert aus Sprachverwaltung-Wertauflöser (Details s. o.).
    
    

  • Der dritte Parameter ({2}) gibt die ID (id) der erstellten oder gelöschten Entität zurück (s. o.), was ohne Zugriff auf die Sprachverwaltung funktioniert.
    

Laufzeitbeispiel:

Wie ein Screenshot der E-Mail-Vorschau belegt, liefert diese Konfiguration für den "Mail-Body" denselben Text wie die oben gezeigte für den Betreff.

Die "Textverkettung" per Standardwert wirkt sogar übersichtlicher und ist flexibler, v. a. wenn die Reihenfolge der Platzhalter für Parameter nachträglich geändert wird oder derselbe Parameter mehrfach "zitiert" werden soll.