CIB merge technischer Leitfaden

6. Aufrufparameter im Detail

6.63. Parameter --source-directory

[--source/-a]

Der Parameter --source-directory setzt ein eigenes Verzeichnis für das RTF-Wurzeldokument und die RTF-Bausteine.


Syntax
--source-directory=<Verzeichnis>


Beschreibung

Der Parameter --source-directory setzt das Verzeichnis, in dem das RTF-Wurzeldokument und die RTF-Bausteine erwartet werden. Es kann auch eine Liste von Arbeitsverzeichnissen angegeben werden. Die einzelnen Angaben werden durch Semikolon getrennt. Für jede verwendete Datei wird eine Suche gestartet und die erste Fundstelle genutzt. Mit dem Parameter --source-directory kann ein Pfad absolut angegeben werden oder relativ zu dem Parameter --target-directory. Der Parameter --target-directory ist daher vor dem Parameter --source-directory zu setzen. Damit können z.B. in Multithreadanwendungen für jeden Thread das gleiche Quellenverzeichnis --source-directory, aber verschiedene Ausgabe/Logverzeichnisse --target-directory angegeben werden. Wird kein Quellenverzeichnis angegeben, dann gilt das Ausgabeverzeichnis auch als Quellenverzeichnis.

 

Ausnahme:

Haben Dateien eine eigene qualifizierte Pfadangabe im Namen, so werden die Parameter --source-directory und --target-directory für diese Dateien ignoriert.


Beispiel einer optimalen Parameterdatei mit --target-directory und --source-directory:
--target-directory=csv
--source-directory=..\templates
--inputfile=wurzelbaustein.rtf
--outputfile=!..\result\Kontenuebersicht.rtf
--datafile=multi.csv

Mit --source-directory wird das Verzeichnis gesetzt, in dem alle RTF-Bausteine zu finden sind. Somit ist eine explizite Pfadangabe bei --inputfile nicht notwendig. --source-directory wird relativ zu --target-directory angegeben.

Die Verwendung des Parameters wird im Anwendungsbeispiel Bausteine veranschaulicht.