CDBLog.pm beinhaltet das Klassenobjekt CDBLog, dass sich von der Klasse CDB ableitet. Es beinhaltet eine Methoden zum Auslesen der Parametertabellen wie unter DataModel - Control - Parameter beschrieben. Desweiteren finden sich hier Methoden zum Speichern von Meldungen aller Art (Logfile) auf der Datenbank. Die Tabellenstrukturen hierzu wird unter DataModel - Control - Log beschrieben.
Ließt einen Parameter aus den Parametertabellen, die unter DataModel - Control - Parameter beschrieben sind. Dazu werden die folgenden Parameter übergeben:
$Group
:
Parametergruppe (= pag_label auf der Tabelle tpag_parameter_group)
$Label
:
Parameterbezeichnung (= par_label auf der Tabelle tpar_parameter)
$Default
:
Defaultwert der zurückgegeben wird wenn der Parameter nicht in der Tabelle spezifiziert ist.
$LogSessionID = $DBLog->LogSessionID();
$DBLog->LogSessionID($LogSessionID);
Gibt die Log-Session-ID zurück, falls diese gesetzt ist. Ist sie nicht gesetzt wird 0 zurückgegeben. Wurde die Log-Session-ID andersweitig vergeben oder ermittelt, dann kann sie hier auch gesetzt werden.
Die Log-Session-ID ist der Parameter, unter dem die Meldungen auf der Datenbank abgespeichert werden. Damit sind die Log-Messages nicht nur in ihrem zeitlichen Verlauf sondern auch in ihrem funktionalen Zusammenhang auswertbar.
$LogSessionID = $DBLog->createLogSessionID();
Erzeugt eine neue Log-Session-ID auf der Datenbank und gibt diese zurück.
$DBLog->setLogMessage($Typ, $Message);
Speichert die Meldung $Message auf der Datenbank (Tabelle: tlog_log_entries). Die Art der Meldung wird in $Typ übergeben. Folgende Werte sind standardmäßig definiert:
INF:
Allgemeine Meldung
ERR:
Fehler-Meldung
TRC:
Trace-Meldung
STA:
Start-Meldung
STP:
Stop-Meldung
$DBLog->errorMessage($Message);
"Protected" Methode, die nach einem Datenbank-Fehler aufgerufen wird und von CDB vererbt wird. In CDBLog ist sie um die Speicherung der Fehlermeldungen in die Datenbank erweitert.
$String = $DBLog->prepareQuoteForSQL($String);
Wandelt einen String so um, dass " und ' sicher als Strings auf der Datenbank gespeichert werden können.
Die Klassenvariablen
(Eigenschaften):
$SaveMessage = $DBLog->SaveMessage();
$DBLog->SaveMessage($SaveMessage);
Ist die Klassenvariablen SaveMessage = true, dann werden die Meldung auf der Datenbank (Tabelle: tlog_log_entries) gespeichert.
