Windows Event Reader | X4Documentation

Der Adapter liest das Event Log (Ereignisprotokoll) von Microsoft Windows und gibt sämtliche oder nach Filterkriterien gewählte Ereignis-Einträge in einem XML-Dokument aus.

Folgende Bedingungen müssen erfüllt sein, um diesen Adapter verwenden zu können:

Der Windows-Computer, von dem das Ereignisprotokoll gelesen werden soll, muss in derselben Domäne liegen wie der X4 Server.
Der X4 Server muss auf einem Windows-Computer laufen, der Domänen-Administratoren-Rechte besitzt.
Eine JNI-Lizenz wird benötigt.

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. windowseventlog.WindowsEventLogAdapter`: Hauptklasse (Standard)
log	Windows-Protokoll/Log, dessen Ereignisse angezeigt werden sollen Mögliche Werte: Beliebiges Windows-Protokoll/Log (z.B. `Application`) `System`: Systemereignisse ausgeben (Standard)
from	Startdatum zur Beschränkung auf einen Zeitraum Mögliche Werte: Beliebiges Datum und Uhrzeit im Format `YYYY-MM-DDThh:mm:ss` (z.B. `2012-03-31T13:45:03`)
to	Enddatum zur Beschränkung auf einen Zeitraum Mögliche Werte: Beliebiges Datum und Uhrzeit im Format YYYY-MM-DDThh:mm:ss (z.B. `2012-03-31T13:45:03`)
type	Nach einem Ereignis-Typ (Ebene) filtern Mögliche Werte: Beliebiger Ereignis-Typ (z.B. `Error`)
source	Nach einer Ereignis-Quelle (dies kann beispielsweise eine Anwendung sein) filtern Mögliche Werte: Beliebige Zeichenkette (z.B. `PrintSpooler`)
category	Nach einer Ereignis-Kategorie filtern Mögliche Werte: Beliebige Zeichenkette
eventId	Nach einer Ereignis-ID filtern Mögliche Werte: Beliebige ganze Zahl
user	Nach einem Benutzer filtern Mögliche Werte: Beliebige Zeichenkette (z.B. `SYSTEM`)
computer	Name des Computers, von dem das Ereignisprotokoll gelesen werden soll Mögliche Werte: Beliebiger Computer-Name oder IP-Adresse `127.0.0.1`: Momentan genutztes System, d.h. localhost (Standard)

Statuswerte

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

Output

Dieser Funktions-Adapter gibt ein UTF-8-kodiertes XML-Dokument mit folgender Struktur aus. Für jedes Ereignis wird ein XML-Element <log/> erzeugt, das eine Reihe von Informationen sowie die Ereignis-Beschreibung zum Ereignis enthält:

<logs>
    <log type="Ereignistyp" date="Datum und Uhrzeit"
        source="Quelle" category="Kategorie" event="Ereignis-ID" user="Benutzer"
        computer="Computername">Ereignis-Beschreibung</log>
</logs>