Lückenlose Protokollierung von Belegänderungen in avisor 4.2
Inhalt
Funktionsbeschreibung
Konfiguration
Aktion
Aktion und Feldname(n)
Aktion, Feldname(n) und Wertepaar(e)
Physikale Speicherung
Funktionsbeschreibung
Dieses Kapitel beschreibt die Funktionsweise der lückenlosen Protokollierung von Belegänderungen in avisor 4.2.
Die Revisionssicherheit ist ein zentrales Funktionsmerkmal von avisor. Immer dann, wenn ein Benutzer einen avisor Beleg verändert wird diese Aktion in Form eines Protokolleintrages festgehalten. Das Protokoll ist ein integraler Bestandteil des Belegdatensatzes und kann in der grafischen Benutzeroberfläche der Anwendung angezeigt werden. Zu Recherchezwecken können die Protokolldaten als Abfragebedingung in Filtern hinterlegt werden.
Die in diesem Dokument beschriebene Funktionserweiterung greift ausschließlich bei solchen Belegveränderungen, die aus der Eingabe von Daten in der Bearbeitungsmaske von avisor resultieren. Die dazu korrespondierenden Protokolldatensätze werden im Kontext einer Belegsitzung geschrieben. Eine solche Sitzung beginnt mit dem Einladen des Beleges in die Bearbeitungsmaske und endet mit dem Laden eines anderen Beleges oder jeder anderen Aktion, die einen Protokolleintrag notwendig macht, wie z. B. einem Statuswechsel durch eine Freigabe oder dem Export des Beleges.
Die Darstellung eines Protokolleintrag besteht aus einem Vorgangsnamen (z. B. „Erstellen“, „Aktualisieren“ oder „Exportieren“), einem Zeitstempel, der Benutzer Identifikation, dem Benutzernamen sowie einem Kommentar. Je nach Konfigurationseinstellung wird der Kommentar des Protokolleintrages mit Zusatzinformationen angereichert.
Konfiguration
Die Funktionserweiterung wird durch einen Konfigurationsparameter gesteuert. Dadurch kann der Grad der Protokollierung justiert werden. Das Ändern der Konfiguration kann im avisor Programm über den Menüpunkt Ansicht -> Konfiguration… vorgenommen werden. Nach Auswahl des Menüpunktes wird ein neuer Dialog angezeigt, der eine Liste aller verfügbaren Konfigurationen beinhaltet. Die aktive Konfiguration ist vorselektiert. Über die Schaltfläche Bearbeiten… gelangt man dann in einen weiteren Dialog, der den Konfigurationstext enthält. Die Konfigurationsdatei folgt dem Aufbau von Microsoft Windows Initialisierungsdateien, das bedeutet, es gibt Sektionen, deren Namen in eckigen Klammern eingeschlossen sind. Innerhalb einer Sektion können beliebig viele Schlüssel/Wertepaare stehen. Der Schlüssel wird durch ein Gleichheitszeichen von seinem Wert getrennt. Die lückenlose Protokollierung wird in der Sektion [Settings] mit dem Schlüssel ProtocolCommentDetailLevel konfiguriert. Es wird zwischen den drei nachfolgenden Graden unterschieden.
Aktion
Der Protokolleintrag weist die Aktion „Aktualisieren“ aus. Dieser Grad ist die Standardeinstellung von avisor und ist daher auch ohne Änderung der Konfiguration aktiviert. Die explizite Konfiguration geschieht über den Wert None.
Aktion und Feldname(n)
Im Kommentar des Protokolldatensatzes werden die Namen aller innerhalb der Protokollsitzung geänderten Felder aufgelistet. Die Konfiguration geschieht über den Wert Field.
Aktion, Feldname(n) und Wertepaar(e)
Im Kommentar des Protokolldatensatzes werden die Namen aller innerhalb der Protokollsitzung geänderten Felder aufgelistet sowie deren alter und neuer Wert. Die Konfiguration geschieht über den Wert Values.
Physikale Speicherung
Aus Gründen der Platzersparnis wird bei der Protokollierung des Feldnamens kein Klartext sondern eine in geschweifte Klammern gesetzte Nummer in der Datenbank gespeichert. Bei Positionsdaten kann der Feldname mit einer vorangestellten zweiten Nummer versehen sein, um das Datengitter zu spezifizieren. Die normalen Aufmaßpositonen tragen kein solches Präfix, Kontierungsdaten hingegen schon. Der Kommentar eines Protokolldatensatzes kann maximal 255 Zeichen umfassen. Wenn der Speicherplatz innerhalb einer Belegsitzung verbraucht ist, wird der Protokolltext um drei Punkte als Auslassungszeichen erweitert und die Protokollierung weiterer Änderungen innerhalb der Sitzung gestoppt. Die oben gezeigten Darstellungen von Protokolldatensätzen sehen in der Datenbank wie nachfolgend dargestellt aus.
Die Zuordnung zwischen Feldnamen und Kennziffer können bei uns erfragt werden.