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.