Diese Dokumentation bietet einen Schnelleinstieg für Entwickler, die den Application Log in ihre Anwendungen einbauen möchten.

Eine ausführliche Dokumentation u.a. zu allen Funktionsbausteinen finden Sie im jeweiligen System durch Ausführen des Programms SBAL_DOCUMENTATION.

Das Application Log ist ein Tool zum Sammeln von Meldungen, zum Speichern, Lesen und Löschen von Protokollen auf der Datenbank sowie zur Anzeige von Protokollen.

In einem Anwendungsprogramm können zur Laufzeit Situationen entstehen, die dem Benutzer in irgendeiner Weise zur Kenntnis gebracht werden müssen. Dies sind vornehmlich Fehlersituationen. Es mag aber auch sinnvoll sein, eine Information über einen erfolgreichen Vorgang nach außen zu geben (dies sollte aber wohl überlegt sein, da der Benutzer nicht mit unwichtigen Informationen überschüttet werden sollte).

Auf eine genaue Unterscheidung von Ausnahme, Fehler, Meldung, etc. soll an dieser Stelle verzichtet werden. Wichtig ist nur, daß es eine Situation gibt, in der eine bestimmte Information (im Allgemeinen eine T100-Nachricht oder ein Meldungstext zu einer Ausnahme) entsteht, die entweder sofort oder später in einem Protokoll zur Anzeige gebracht wird. Diese Information bezeichnen wir als Meldung.

Diese Meldungen sollen nun nicht einzeln ausgegeben werden (mit Hilfe der ABAP-Befehle MESSAGE, Raise), sondern zunächst gesammelt und zu einem anderen Zeitpunkt zusammen als Protokoll dargestellt werden.

Diese Menge von Meldungen stellt ein Protokoll dar. Zu einem Protokoll gibt es normalerweise noch grundlegende Kopfinformationen (Was für eine Art von Protokoll ist es?, Wer hat es wann und wie erstellt?, etc.). Während einer Transaktion können mehrere Protokolle entstehen.

Das Application Log bietet eine Infrastruktur an, um Meldungen zu sammeln, auf der Datenbank zu speichern und sie als Protokoll darzustellen.

Das Application Log dient zur temporären Speicherung von Meldungen. Die Protokolle sollten periodisch gelöscht werden. Daten, die aus Gründen der Revisionssicherheit für lange Zeit verfügbar sein müssen, sollten nicht mit dem Application Log, sondern mit den Änderungsbelegen gespeichert werden.

Diese Infrastruktur und einige Konventionen sollen in diesem Quickstart erläutert werden.