CIB merge technical documentation (EN)
6. Call parameters in detail
6.64. Parameter --source-directory
[--source/-a]
The --source-directory parameter sets a separate directory for the RTF root document and the RTF components.
Syntax
--source-directory=<Verzeichnis>
Description
The --source-directory parameter sets the directory where the RTF root document and RTF templates are expected. You can also specify a list of working directories. The individual specifications are separated by semicolons. For each usage a search is started and the first found file is used. With the parameter --source-directory a path can be specified absolute or relative to the parameter --target-directory. The parameter --target-directory must therefore be set before the parameter --source-directory. This allows e.g. in multithreaded applications to specify the same source directory --source-directory for each thread, but different output/log directories --target-directory. If no source directory is specified, the output directory is also the source directory.
Exception:
If files have their own qualified path in their name, the parameters --source-directory and --target-directory are ignored for these files.
Example of an optimal parameter file with --target-directory and --source-directory:
--target-directory=csv --source-directory=..\templates --inputfile=wurzelbaustein.rtf --outputfile=!..\result\Kontenuebersicht.rtf --datafile=multi.csv
With --source-directory you set the directory where all RTF blocks can be found. Thus an explicit path specification is not necessary with --inputfile. --source-directory is specified relative to --target-directory.
The usage of the parameter is demonstrated in the application example Templates.