[-k]

Der Parameter --keep-fields führt den Mischvorgang fort, auch wenn nicht alle Felder über die Datenversorgung gefüllt werden können.

Syntax

--keep-fields=<Option>
<Option>: unresolved-ref, unresolved-ref-as-formfield, all oder none

Beschreibung

Wenn während der Datenversorgung nicht alle Felder gefüllt werden können (Informationen liegen noch nicht vor), dann ist es möglich CIB merge mittels des Parameters --keep-fields dazu zu veranlassen, diese Felder zu übergehen, ohne den Mischvorgang abzubrechen.

Für <Option> sind folgende Werte möglich:

Option	Bedeutung
unresolved-ref	alle nicht versorgten Ref-Felder bleiben in der Ausgabedatei erhalten
unresolved-ref-as-formfield	alle nicht versorgten Ref-Felder werden durch {\rtf...formtext...} ersetzt
all	Alle Felder werden in der Ausgabedatei behalten, bei mit Daten versorgten Feldern wird das Ergebnis entsprechend befüllt.
none	Defaultwert. Parameter --keep-fields findet keine Anwendung.

Beispiel

--logfile=!cibmerge_Bausteine_KeepFields.log
--target-directory=csv
--source-directory=..\templates
--inputfile=wurzelbaustein.rtf
--outputfile=!..\result\KeepFields_out.rtf
--datafile=multi_undef.csv
--multidatafile
--charformat
--keep-fields=unresolved-ref

Hier wird in einem der RTF-Bausteine die Variable kont_kontoart verwendet. Für diese Variable erfolgt jedoch keine Versorgung aus den Datenquellen. Durch den Parameter --keep-fields=unresolved-ref wird der Mischvorgang fortgeführt, das REF-Feld für kont_kontoart bleibt in der Ausgabedatei KeepFields_out.rtf erhalten.

Die Verwendung des Parameters wird im Anwendungsbeispiel Bausteine verdeutlicht.

 

Hinweis:

Wenn CIB merge wegen des Parameters keep bzw. wegen des Schalters \* LASSEN ein Feld als solches schreibt (ohne die Daten einzumischen), erscheint eine textuelle Fehlermeldung im Logfile. Diese Aktion wird nicht als Fehler gewertet und erzeugt daher keinen Fehlerrückgabewert.

(Ab CIB merge Version 3.9.181)

Bei Steuerung über Feldschalter gibt es außer \* LASSEN noch die Möglichkeiten:

\*keepalways: Diese Feldanweisung bleibt immer im Ausgabedokument stehen.

\*keepuntilresolved: Diese Feldanweisung bleibt solange im Ausgabedokument bestehen, bis sie versorgt ist.

 

Tipp:

Dieser Parameter eignet sich als --keep-fields=unresolved-ref hervorragend zur Realisierung einer Restdatenerfassung mit den CIB office Modulen. Fragen Sie den CIB Support nach weiteren Informationen für Ihren Anwendungsfall.