Name

Standardwert:
(...LogMessageActor)

Textfeld für Direkteingabe
oder
(zum Umschalten Pfeil in der linken unteren Ecke drücken!)
Wert-Konfiguration, deren Rückgabewert in einen String umgewandelt wird

Der Name benennt den zu verwendenden Logger. Der Name erscheint im Log-Eintrag als Präfix vor der Nachricht hervorgehoben durch eckige Klammern: [Name]

Im Beispiel (statischer Text): Name

Nachricht

Standardwert:
null

Die Nachricht erscheint am Ende des Log-Eintrags. Sie kann Platzhalter für Werte enthalten ({0}, {1}, ...), die über Parameter (s. u.) definiert werden.

Im Beispiel (statischer Text): Nachricht von {0}mit Platzhalter {0 } für die Firma der Session (s. Parameter)

Level

Standardwert:
DEBUG

Auswahlfeld/Combobox für Einfachauswahl aus der statischen Aufzählung "Log Level" (LogLevel)

Vom gewählten Level hängt ab, ob und ggf. in welche Log-Datei ein Log-Eintrag geschrieben wird. Außerdem erscheint der interne Name des Aufzählungswerts im automatisch erzeugten Vorspann des Log-Eintrags zwischen eckigen Klammern.

[ERROR]

Parameter ({0},{1},...)

Standardwert: null

Wiederholendes Element für Wert-Konfigurationen, deren Rückgabewert in einen String umgewandelt wird

Optional können Wert-Konfigurationen für Parameter bereitgestellt werden, die in der Nachricht über ihren Index (aufsteigend von 0) zwischen geschweiften Klammern adressiert werden können (s. Hinweise unten).

Der Screenshot rechts zeigt einen Überblick der Konfiguration für die Ereignisbehandlung mit der Log-Nachricht-Ereignisaktion:

• Als Auslösendes Ereignis dient hier "Client angemeldet" (s. Anmeldung (Ereignisse))

• Die Prüfende Regel verwendet eine Mit-Regel, die feststellen soll, ob sich ein Gastbenutzer anmeldet, der nicht nie angemeldet war:

  • Der Objekt Feld Resolver definiert den Benutzer der Session als temporäres Bezugsobjekt für die nachfolgend ausgewerteten Regeln.

  • Unterhalb folgt eine UND-Verknüpfung (s. Verknüpfung) von zwei Regeln:

    • Die Typprüfung prüft, ob das Bezugsobjekt ein Gastbenutzer ist.

    • Die folgende Objekt-Feld-Regel vergleicht das Objekt-Feld "Anzahl Logins" (loginCount) mit der statischen Ganzzahl 0, um sicherzustellen, dass nur dann Aktionen ausgeführt werden, wenn der Gastbenutzer noch nie angemeldet war.

• Als einzige Aktion bei bestandener Regel wird eine Log-Nachricht-Ereignisaktion ausgeführt, deren Parametrierung unten weiter ausgeführt wird.

• Für die Log-Nachricht-Ereignisaktion wird statische Text WELCOME als Name per Direkteingabe eingetragen.

• Die Nachricht mit drei Platzhaltern für Parameter (s. u.) wird ebenfalls per Direkteingabe statisch festgelegt:

  Guest user #{0} from {1} as {2}

  ►ANMERKUNG◄ Da in den Log-Dateien überwiegen englischer Inhalt zu finden ist, wird hier darauf verzichtet, die Sprachverwaltung zu beanspruchen (s. Wert aus Sprachverwaltung).

• Der Level wird durch Auswahl in der als Standard vorgegeben Combobox als INFO festgelegt. Technisch kommt hier ein Statische Aufzählung-Wertauflöser zum Einsatz, der sich auf die statische Aufzählung "Log-Level" (LogLevel) bezieht.

• Es folgen drei Wert-Konfigurationen für Parameter ({0},{1},...):

  • {0}: Die erste Wert-Konfiguration liest das Objekt-Feld id aus dem Rückgabewert des Benutzer der Session-Wertauflösers.

  • {1}: Die zweite Wert-Konfiguration liest das Feld "Name"(address.Name1) aus der Adresse des Firmenkontos, das der Firma der Session-Wertauflöser zurückgibt.

  • {2}: Die dritte Wert-Konfiguration liest das Feld "Rollenname" (roleName) aus dem Rückgabewert des Rolle der Session-Wertauflösers.

►ANMERKUNG◄ Für Gastbenutzer sind eindeutige Auswahl für die Felder "Firma" (companyId) und "Rolle" (roleId) verpflichtend. Wie die internen Feldnamen nahelegen, referenziert das Gastbenutzerkonto "Firma" und "Rolle" dabei allerdings nur, ohne deren Detaildaten einzubinden. Da die betreffenden Parameter in der Nachricht mit Klartext versorgt werden sollen, ist der Zugriff über Firma der Session und Rolle der Session hier eleganter.

• Als auslösendes Ereignis dient das Ereignis "Client angemeldet" (s. Anmeldung (Ereignisse)).

• Die Prüfende Regel bezieht sich per Objekt Feld Resolver auf den Benutzer der Session als Bezugsobjekt für eine UND-Verknüpfung:
  
  

  • Die Typprüfung stellt sicher, dass die Anmeldung einen Gastbenutzer betrifft.
    
    

  • In diesem Fall wird eine verneinte Rollenregel ausgewertet, die als bestanden gilt, wenn eine andere Rolle als die für Gastbenutzer designierte Rolle XF_GUEST als Rolle der Session gilt.

• Als Aktionen bei bestandener Regel sollen zwei Ereignisaktionen ausgeführt werden:
  
  

  • Die Log-Nachricht-Ereignisaktion stellt sicher, dass der Vorfall einer "unangemessenen" Anmeldung als Gastbenutzer im error.log nachvollziehbar ist.
    
    

  • Die nachfolgende Abbrechen-Ereignisaktion stellt sicher, dass die formal legitime Sitzung in diesem Fall sofort wieder beendet wird.

►ANMERKUNG◄ Da der abgemeldete Benutzer eine beim Abbrechen ausgelöste Fehlermeldung sowieso nicht mehr angezeigt bekommt, ist dabei der Modus "Unterdrücken" ausgewählt.

Die Log-Nachricht-Eregnisaktion wird wie rechts abgebildet konfiguriert:

• Als Name wird (wie oben) per Direkteingabe der statische Text WELCOME eingegeben.
  
  

• Die Nachricht mit zwei Platzhaltern für Parameter wird ebenfalls per Direkteingabe angelegt:
  
  Denied access to Guest user {0} as {1}
  
  

• Der Level wird über einen Bedingter Wert-Wertauflöser definiert, der zwei Fälle unterscheidet:
  
  

  • Falls eine Rollenregel zutrifft, die besonders "mächtigen" Rollen als Positivliste verwendet, wird der Level "Fatal" (FATAL) zugewiesen.
    
    

  • Anderenfalls wird der Level "Fehler" (ERROR) zugewiesen.
    
    

• Die beiden Parameter in der Nachricht werden mit das Daten aus den Rückgabewerten für Benutzer der Session und Rolle der Session versorgt.