4D Doc Center : LOG EVENT

Home

4D v14.3

LOG EVENT


LOG EVENT ( {AusgabeTyp ;} Meldung {; Wichtigkeit} )

Parameter	Typ	Beschreibung
AusgabeTyp	Lange Ganzzahl	Ausgabetyp für Meldung
Meldung	String	Inhalt der Meldung
Wichtigkeit	Lange Ganzzahl	Wichtigkeitsebene der Meldung

Beschreibung

Der Befehl LOG EVENT ermöglicht, ein eigenes System zum Protokollieren interner Ereignisse einzurichten, die während dem Einsatz der Anwendung auftreten.

In Meldung übergeben Sie die eigene Information, die je nach Ereignis protokolliert wird.

Im optionalen Parameter AusgabeTyp können Sie für Meldung den Ausgabekanal angeben. Sie können eine der folgenden Konstanten unter dem Thema Log Ereignisse übergeben:

Konstante	Typ	Wert	Meldung
Into 4D commands log	Lange Ganzzahl	3	Dieser Wert weist 4D an, Meldung im Logbuch der 4D Befehle zu speichern, wenn diese Datei aktiviert wurde. Das Logbuch der 4D Befehle lässt sich über den Befehl SET DATABASE PARAMETER (Selector 34) aktivieren. Hinweis: 4D Log Dateien werden im Ordner Logs gesammelt, der neben der Strukturdatei der Datenbank liegt.
Into 4D debug message	Lange Ganzzahl	1	Dieser Wert weist 4D an, Meldung an die Debugging Umgebung des Systems zu senden. Das Ergebnis richtet sich nach der jeweiligen Plattform: - Mac OS: Der Befehl sendet Meldung an die Konsole. - Windows: Der Befehl sendet Meldung als eine Debug Meldung. Zum Lesen dieser Meldung benötigen Sie Microsoft Visual Studio oder das Hilfsprogramm DebugView für Windows (http://technet.microsoft.com/en-us/sysinternals/bb896647.aspx).
Into 4D diagnostic log	Lange Ganzzahl	5	Dieser Wert weist 4D an, Meldung in der Protokolldatei von 4D einzutragen, wenn diese Datei aktiviert wurde. Diese Datei lässt sich über den Befehl SET DATABASE PARAMETER (Selector 79) aktivieren.
Into 4D request log	Lange Ganzzahl	2	Dieser Wert weist 4D an, Meldung im Logbuch 4D Anfragen zu speichern, wenn diese Datei aktiviert wurde.
Into Windows log events	Lange Ganzzahl	0	Dieser Wert weist 4D an, Meldung die "Log Ereignisse" des Fensters zu senden. Dieses Logbuch empfängt und speichert Meldungen von den laufenden Anwendungen. Dann können Sie Meldung über den optionalen Parameter Wichtigkeit eine Wichtigkeitsstufe zuordnen (siehe oben). Hinweise: Diese Funktionalität ist nur verfügbar, wenn der Service Windows Log Events läuft. Auf Mac OS führt der Befehl mit diesem Wert in AusgabeTyp nichts aus.

Übergeben Sie nicht den Parameter AusgabeTyp, wird standardmäßig der Wert 0 (Into Windows Log Events) verwendet.

Haben Sie den Parameter AusgabeTyp als Into Windows Log Events definiert, können Sie in Meldung eine Wichtigkeitsebene zuordnen, das vereinfacht die Interpretation von Log Ereignissen. Es gibt drei Ebenen: Information, Warnung und Fehler. 4D bietet dafür drei vordefinierte Konstanten unter dem Thema Log Ereignisse:

Konstante	Typ	Wert
Error message	Lange Ganzzahl	2
Information message	Lange Ganzzahl	0
Warning message	Lange Ganzzahl	1

Geben Sie im Parameter Wichtigkeit keinen oder einen inkorrekten Wert an, wird der Standardwert 0 verwendet.

Beispiel

Wollen Sie eine Meldung erhalten, wenn Ihre Datenbank unter Windows geöffnet ist, könnten Sie in der Datenbankmethode On Startup z.B. folgenden Code schreiben:

LOG EVENT(Into Windows log events;"Die Datenbank Rechnungen wurde geöffnet.")

Immer wenn die Datenbank geöffnet ist, wird diese Information in die Windows Log Events geschrieben; die Wichtigkeitsebene ist 0.