Allgemeines zu Anwendungsprotokollen
Protokolle basieren immer auf dem Basis-Protokoll, welches in die Datenbanktabelle Basis.Protokoll geschrieben wird.
Alle Protokolle, die davon abgeleitet sind und die Protokollierung erweitern, haben daher ebenfalls sämtliche Basisdaten aus dieser Tabelle und darüber hinaus ggf. weitere Daten (Spalten) in deren eigene Tabellen.
Möchte man also ein bestimmtes erweitertes Protokoll konfigurieren kann man entweder die erweiterte Tabelle oder – wenn es nur auf den Inhalt des Protokolls, aber nicht auf die zusätzlichen Felder ankommt – die Basis-Tabelle benutzen. Der eigentliche Inhalt steht als HTML in der Spalte „Content“ der Basis-Tabelle.
Eine Ansicht, welche konfiguriert ist, um mit Basis.Protokoll zu arbeiten, zeigt daher immer sämtliche Protokolle an. (Also die Basis-Protokolle und alle die davon abgeleitet sind.) Wohingegen eine Ansicht die konfiguriert ist um z.B. nur mit Prozess.Protokoll zu arbeiten auch nur diese Art von Protokollen anzeigt und keine anderen.
Protokolle konfigurieren
Um Protokolle zu sehen werden eine Ansicht sowie eine Maske benötigt, welche wiederum beide eine Navigation brauchen. Eine Protokoll-Maske besteht aus folgenden Elementen:
| Datenspalte | Steuerelement | Beschreibung |
|---|---|---|
| Content | HTML-Editor | Für den eigentlichen Inhalt des Protokolls. |
| Selektor für den Protokollinhalt | Um Warnungen, Fehler oder normale Einträge aus- bzw. einblenden zu können. | |
| Process | Text | Für die Anzeige des Prozessnamens. |
| Title | Text | Für die Anzeige des Titels. |
| Start | Datum/Zeit | Wenn auch hier der Start- und Endzeitpunkt angezeigt werden sollen. |
| End | Datum/Zeit | Wenn auch hier der Start- und Endzeitpunkt angezeigt werden sollen. |
| Warnings | Text | Wenn die Anzeige der Anzahl der Fehler und Warnungen gewünscht ist. |
| Errors | Text | Wenn die Anzeige der Anzahl der Fehler und Warnungen gewünscht ist. |
Für die Protokoll-Ansicht wird festgelegt, dass Datensätze in der zuvor konfigurierten Maske geöffnet werden. Folgende Spalten können in der Ansicht verwendet werden:
| Datenspalte | Steuerelement | Beschreibung |
|---|---|---|
| OrmType | Wert aus Auswahlliste (Referenz), Anzeigeart: Nur Bild | Spalte mit Icons. |
| Process | Wert aus Auswahlliste (Referenz) | Für die Anzeige des Prozessnamens. |
| Title | Text | Für die Anzeige des Protokolltitels. |
| Warnings | Text | Für die Anzeige der Anzahl der Warnungen. |
| Errors | Text | Für die Anzeige der Anzahl der Fehler. |
| Start | Datum/Zeit | Für die Anzeige des Zeitpunktes an dem der Prozess gestartet wurde. |
| End | Datum/Zeit | Für die Anzeige des Zeitpunktes an dem der Prozess fertig wurde. |
Am Ende muss nur noch dafür gesorgt werden, dass die Protokoll-Ansicht in einer (Haupt-)Navigation aufrufbar gemacht wird.