CIB merge technischer Leitfaden

6.4. Parameter --analyse

Der Parameter --analyse spielt nur für das Reportingtool „CIB report&analyse“ eine Rolle. Er bestimmt die statische Feldstruktur.

Syntax

--analyse=<Dateiname>

Beschreibung

Die Struktur, die mithilfe von --analyse bestimmt wird, kann zur weiteren Analyse oder Darstellung dienen. Die Meldung erfolgt in eine gesonderte Datei im Csv-Format. Es werden zunächst nur Ref, Mergerec, Next und Includetext (Ref, Datensatz, Nächster und Einfügentext) Felder bestimmt. Sie haben nur einen Parameter, der auch gemeldet wird. Dieser Parameter ist sinnvoll in dem Zusatzprojekt CIB report&analyse.

Die statische Feldstruktur ist die Reihenfolge der Felder wie aufgeschrieben.

Beispiel für statische Feldstruktur

{If {Mergerec ?Data} <> 0 „{Ref Name}{Next data}” \* Solange} meldet 1. If, 2. Mergerec, 3. Ref und 4. Next

Die dynamische Feldstruktur ist die Reihenfolge der Felder während der Auswertung.

Beispiel für dynamische Feldstruktur

{If {Mergerec ?Data} <> 0 „{Ref Name}{Next data}” \* Solange} meldet 1. If, 2. Mergerec, 3. Ref, 4. Next, 5. Mergerec, 6. Ref, 7. Next, 8. Mergerec, 9. Ref, 10. Next, … und so weiter, bis die Schleife beendet ist.

CSV-Dateien bestehen aus Zeilenschaltungen getrennte Datenzeilen, welche durch Komma, Tabulator oder Semikolon () getrennt sind. Die erste Zeile enthält die Spaltenüberschriften (Feldnamen). Jede Zeile muss die gleiche Anzahl Felder haben. Felder, die Feldtrenner oder Zeilenschaltungen oder Anführungszeichen im Inhalt haben, werden von Anführungszeichen umschlossen. Die inhaltlichen Anführungszeichen werden verdoppelt.

Beispiel: Auszug aus der Parameterdatei:

--logfile=!Felder.csv
-mPfad;Feld;Wert
--logfile=!cibmerge_Bausteine_analyse.log
--source-directory=templates
--outputfile=-
--analyse=+Felder.csv
# für jeden Text
--inputfile=Basisbaustein.rtf
-m@
--filter
--inputfile=Bezug.rtf
-m@
--filter
... für jeden RTF-Baustein...
--inputfile=wurzelbaustein.rtf
-m@
--filter
-mdone 

Dieses Beispiel besteht aus mehreren RTF-Bausteinen. Mit dem Parameter --analyse wird die Ausgabe „Felder.csv“ erzeugt. Diese Datei besitzt folgenden Aufbau:

Pfad;Feld;Wert

Eine genauere Beschreibung der Ausgabe ist im Anwendungsbeispiel Bausteine zu finden.

Hinweis:

Wegen der statischen Feldreihenfolge werden Felder in Schleifen nur einmal ausgegeben. Aus dem gleichen Grund werden Felder sowohl aus dem Dann- und Sonst-Zweig einer Wenn/If-Anweisung ausgegeben. Weil der Filter- und nicht der Mischvorgang die Ausgabe erzeugt, werden keine Felder berechnet und darum auch keine eingebetteten Texte (Includetext/Einfügentext) aufgelöst oder deren Felder ausgegeben.

Macht man eine zusammengehängte Feldanalyse über eine ganze Menge von Texten und Bausteinen, dann erhält man auch den Aufrufbaum mit den eingefügten Bausteinen. Mehrfach auftretende gleiche Felder werden auch mehrfach gemeldet. (Zum Beispiel zweimal {Ref Name})