CIB merge technischer Leitfaden
12. Sonstiges
12.3. Fehlerprotokolldatei
AllgemeinDiagnoselevel
Fehlerkategorien
Fehlerprotokolldatei bis CIB merge 3.8.x
Allgemein
Mit dem Parameter -L(!)<Fehlerprotokolldatei> schreibt CIB merge eine Beschreibung der Fehlermeldung in die angegebene Logdatei. Tritt kein Fehler auf, so wird eine leere Datei geschrieben. Siehe auch Kapitel -L<Logdatei>.
Fehlerprotokolldatei mit --verbose ab CIB merge 3.9.x
CIB merge schreibt ab version 3.9.x eine nach Fehlerkategorien und Diagnoseleveln frei skalierbare Fehlerprotokolldatei, die somit individuell auf die Bedürfnisse der User zugeschnitten werden kann.
Diagnoselevel
Die Diagnoselevel bezeichnen dabei die Detailtiefe der Protokolldatei wie folgt:
|
level |
verbosity |
name |
standards |
function |
remarks |
|
0 |
nothing |
silent/still/stumm |
|
quiet |
|
|
1 |
severe errors |
severe/schwer(wiegend) |
|
errors |
|
|
2 |
all errors |
error(s)/Fehler |
|
|
|
|
3 |
important consequences |
initial |
initial |
|
|
|
4 |
helpful consequences |
""/default/standard |
default |
|
|
|
5 |
all consequences |
stack |
|
|
|
|
6 |
helpful information |
info(rmation) |
|
trace |
|
|
7 |
technical information |
technical/technisch |
|
|
|
|
8 |
timing information |
timing/Zeit(en) |
|
|
reserved |
|
9 |
memory information |
memory/Speicher |
|
|
reserved |
Wird --verbose nicht gesetzt, so wird der initial Level 3 gesetzt. Wird --verbose ohne einen Diagnoselevel gesetzt, so gilt der default Level 4.
Fehlerkategorien
CIB merge unterscheidet zur Protokollierung mit --verbose verschiedene Fehlerkategorien:
ALL/ALLE, DATA/DATEN, DIALOG, DOC/DOCUMENT/DOK/DOKUMENT, INCLUDE/EINFUEGEN, FIELD/FELD, FILE/DATEI, PAR, REF, SOURCE/QUELLE, SOURCEPATH/QUELLPFAD
Diese können beliebig kombiniert werden, z.B. --verbose +DATA +DOK +INCLUDE oder --verbose +ALL -SOURCE
Fehlerprotokolldatei bis CIB merge 3.8.x
Die Fehlerprotokolldatei und enthält Informationen für Anwendungsentwickler, Rohtextentwickler und den CIB Support. Eine Skalierung mit --verbose ist nicht möglich, die Datei ist wie folgt aufgebaut:
Die erste Zeile gibt die Fehlerart und Kategorie an.
Die zweite Zeile beschreibt, in welcher Datei der Fehler passiert ist. CIB merge Versionen < 3.8.108 geben in der zweiten Zeile Informationen für den CIB Support aus.
In den weiteren Zeilen erhält der Anwender die nötigen Hinweise für die Verfolgung der Fehlerursachen.
Die letzte Zeile der Fehlermeldungen enthält die folgenden Angaben:
Programmrückgabewert: xxxx - siehe Kapitel Programmrückgabewerte "==>" bezeichnet immer die Folgen in CIB merge.
Hinweise zur Analyse der Fehlerprotokolldatei
Feldanweisungen werden grundsätzlich von innen nach außen ausgewertet, CIB merge listet daher zuerst den "innersten" Fehler und anschließend die daraus folgenden Fehler in den äußeren Feldern aus.
BeispielEine Variable wird in einer WENN-Bedingung mit einem festen Wert verglichen. Der Baustein ist Teil eines größeren Projekts und wird mit EINFÜGENTEXT in das Wurzeldokument eingefügt. Fehlt nun die Variable in der Datenversorgung, so wird CIB merge folgendes ausgeben:
FEHLER: Fehlbedienung: Fehlerhafte Feldanweisung
Fehler während der Datei baustein.rtf
unbekannte Variable
Name: dummy_feld
==> konnte Feldanweisung nicht auswerten
Befehl: REF
Parameter: 2 Stück
1: REF
2: dummy_feld
Schalter: 0 Stück
==> Feld nicht neu berechnet
==> linken Operanden nicht ausgewertet
==> Bedingung nicht ausgewertet
==> konnte Feldanweisung nicht auswerten
Befehl: WENN
Parameter: 6 Stück
1: WENN
2: {REF dummy_feld}
3: <>
4: ""
5: "REF dummyfeld ist nicht leer"
6: "REF Dummyfeld ist leer"
Schalter: 0 Stück
==> Feldergebnis nicht neu berechnet und geschrieben
==> Feld nicht korrekt ausgewertet und geschrieben
==> Dokument nicht vollständig bearbeitet und geschrieben
==> Datensatz-Nr.: 1
==> konnte Feldanweisung nicht auswerten
Befehl: EINFÜGENTEXT
Parameter: 2 Stück
1: EINFÜGENTEXT
2: "baustein.rtf"
Schalter: 0 Stück
==> Feldergebnis nicht neu berechnet und geschrieben
==> Feld nicht korrekt ausgewertet und geschrieben
==> Einzeldokument nicht vollständig bearbeitet und geschrieben
==> Mischvorgang abgebrochen
==> Dokument nicht vollständig bearbeitet und geschrieben
==> Datensatz-Nr.: 1
==> Dokument nicht korrekt bearbeitet
Programmrückgabewert 0010