Log4J Logging

Dieser Adapter gibt Daten aus dem Prozess über Log4J in das Server-Log aus. Als Input-Daten können alle Daten dienen, die sich in eine Zeichenkette umwandeln lassen. Im AdvancedMode können in einem XML-Dokument mit adapterspezifischer Struktur Daten auf verschiedenen Log-Stufen direkt ausgegeben werden.

Dieser Adapter gibt seine Input-Daten unverändert an den nächsten Prozess-Schritt weiter.

Eigenschaften (Properties)

Operation

Bestimmt, welche Operation der Adapter durchführt

Mögliche Werte: Execute: Adapter ausführen

Parameter

Adapter	Hauptklasse des Adapters (nicht verändern!) Mögliche Werte: `de.softproject.integration.adapter.log4j.Log4jAdapter`: Hauptklasse (Standard)
logger	Verwendeter Logger, an den die Log-Nachricht gesendet werden soll Mögliche Werte: Beliebiger Logger-Name `X4Logger`: Ausgabe als `X4Logger` in der Server-Konsole über Log4j
level	Stufe der ausgegebenen Log-Nachricht. In der Log4j-Konfiguration ist eine Schwelle (Parameter `Threshold`) definiert, ab welcher Stufe Log-Nachrichten ausgegeben werden; meist ist dies `INFO`. Mögliche Werte: `DEBUG`: Debug-Informationen ausgeben (falls dies die Logging-Konfiguration zulässt) `INFO`: Allgemeine Informationen oder verarbeitete Prozessdaten ausgeben `WARN`: Warnung für eine unerwartete Situation ausgeben `ERROR`: Fehlermeldung (abgefangene Exception) ausgeben `FATAL`: Kritischen Systemfehler ausgeben Log-Nachrichten mit dem Level `FATAL` werden technisch bedingt mit dem Level `ERROR` ausgegeben. Die Ausgabe erhält `FATAL:` als Präfix.
advancedMode	Erweiterten Modus aktivieren, in dem ein Input-XML-Dokument mit einer adapterspezifischen Struktur gesondert verarbeitet wird. Ein solches XML-Dokument kann Log-Nachrichten enthalten, die auf einer angegebenen Log-Stufe ausgegeben werden (siehe Beispiel unten) Mögliche Werte: `ja`: Input-XML-Dokumente parsen `nein`: Input-Daten nicht parsen (Standard)
modifyMessage	Log-Nachricht verändern/erweitern Mögliche Werte: `Nothing`: Log-Nachricht mit unverändertem Layout ausgeben `AddPid`: In der Log-Nachricht zusätzlich die aktuelle Prozess-Instanz-ID ausgeben (Standard)

Statuswerte

`1`	Die Operation wurde erfolgreich ausgeführt.
`-1`	Die Operation ist aufgrund eines technischen Fehlers fehlgeschlagen.

Beispiel

Wenn der Parameter advancedMode aktiviert ist: Dieses adapterspezifische Input-XML-Dokument enthält Angaben zur Log-Stufe und die auszugebenden Log-Nachrichten. Die Nachrichten werden direkt ins Server-Log ausgegeben:

HTML/XML

<logs>
   <log logger="X4Logger">
      <message level="DEBUG">This is a debug message.</message>
      <message level="INFO">This is a info message. </message>
      <message level="WARN">This is a warn message. </message>
      <message level="ERROR">This is an error message. </message>
      <message level="FATAL">This is a fatal message. </message>
   </log>
</logs>