CIB format technischer Leitfaden (DE)

4. Ausgabemodule

4.15. CIB format/SyntaxCheck

(ab CIB format Version 5.3.240)

Der CIB format bietet ab Version 5.3.240 für Analysezwecke zwei Varianten an:
CIB format&analyze
CIB format syntaxcheck

 Welche der beiden Module zum Einsatz kommt, wird durch den jeweiligen Anwendungsfall bestimmt:

1.     Analysieren einer Datei während deren Formatierung.

2.     Durchführen einer reinen Syntaxprüfung der Eingabedatei(en)  (z.B.. in CIB workbench oder CIB cosys (Darkdesk))

Im Fall 1) bekommt der CIB format seine Analyse-Informationen während des Formatierungsvorgangs. Voraussetzung hierfür ist das Vorliegen einer einzigen Eingabedatei (kein Dokumenten-Projekt, kein Rohdokument). Hierfür wird der CIB format&analyze verwendet.

Im Fall 2) soll die Eingabe nur auf syntaktische Korrektheit geprüft werden. Die Datei(en) liegen als Rohdokumente vor und enthalten damit Feldbefehle wie REF, SET, IF ELSE, etc. Sie können weitere Dokumente inkludieren (via INCLUDETEXT), wenn es sich um ein Dokumenten-Projekt handelt.

In diesem Fall ist es nicht sinnvoll, eine Formatierung durchzuführen. Dies würde nur zu einer unnötigen Performance-Verschlechterung führen, bzw. sogar Fehlverhalten provozieren. Für die reine Syntaxprüfung wird der CIB format syntaxcheck eingesetzt.

Spezielle Properties für den CIB format syntaxcheck

Diese Properties können nicht im RTF über PRINT CIB Befehl gesetzt werden.

Optionsname

Optionswert

Datentyp

OutputFormat

Diese Property muss mit dem Wert "FormatSyntaxCheck" belegt werden

Char*

OutputFilename

Wenn kein AnalysisCallback oder AnalysisFilename angegeben ist, erfolgt die Ausgabe der Analyse in die angegeben Ausgabedatei, oder wenn keine angegeben ist, in
<Name Eingabedatei.txt>.

Char*

MemoryOutputCallback

Übergabe der Callbackadresse, um die erzeugte Auftragsergebnisdatei entgegenzunehmen. Nullterminierte Zeichenkette, die den dezimalen Wert der Adresse einer ausführbaren Funktion enthält.

Schnittstellenbeschreibung siehe Kapitel „MemoryOutputCallback”

Char*

AnalysisFilename

 Alle Details der internen Analyse werden in der angegebenen Text-Datei abgelegt.

Char*

AnalysisOutputCallback

Übergabe der Callbackadresse, um die erzeugte Analysedatei entgegenzunehmen.
Schnittstellenbeschreibung siehe Kapitel „MemoryOutputCallback”

Char*

DocumentUsedFonts

Dokumentinformation über verwendete Schriftarten im Input-Dokument.

Details siehe unter „Allgemeine Properties“.

Char*

DocumentUsedOriginFonts

Dokumentinformation über Original-Schriftarten im InputDokument.

Details siehe unter „Allgemeine Properties“.

Char*

DocumentUsedBookmarks

Ausgabe der in einem Dokument verwendeten Textmarken.
Details siehe unter „Allgemeine Properties“.

Char*

DocumentUsedPaperFormats

Liefert eine Liste der im Dokument verwendeten Seitengrößen und Ausrichtungen.

Details siehe unter „Allgemeine Properties“.

Char*

AnalyzeNonPrintableParagraph

Gibt an, ob Schriftarten berücksichtigt werden, die nur zur Formatierung von Absatzzeichen, etc. benutzt wurden.

Details siehe unter „Allgemeine Properties“.

Char*

 

Beispiel für die Ansteuerung über die CIB runshell:

cibrsh.exe -sc input.rtf <optional output filename>