CIB merge technical documentation (EN)
6. Call parameters in detail
6.13. Parameter --default-prefix
This parameter defines a prefix for variables, i.e. it sets a prefix before the original variable name.
Syntax
--default-prefix=<prefix>
Description:
With the parameter --default-prefix a variable can be assigned a substitute value (default). The common default is the variable that has the same name as the default prefix. The default prefix is “default”. This parameter must be specified in combination with the --default-mode parameter.
Example 1
--default-mode=all --default-prefix=Default.
Here a default value is searched for if a variable cannot be filled by the data supply because the variable does not exist or is empty. To determine the default value, the prefix "Default." is prefixed to the variable.
The use of the parameter is described in detail in the use case example Gap Text.Example 2
--default-mode=undefined --default-prefix=Default.
Assignment of variables: A=Anton, B=Berta, C=, Default.B=Bruno, Default.C=Cäsar, Default.D=Dora, Default.=Mama
The default mode defines the prefix "Default" for undefined variables. The variables supply the following values:
REF A delivers Anton
REF B delivers Berta
REF C delivers „“
REF D delivers Dora
REF E delivers Mama, because Default.E is not defined. If "Default." were not assigned, there would be an error with the message that E is not assigned.
If the default mode is set to all or empty (--default-mode=all/--default-mode=empty) then the evaluation for REF C provides Cäsar.
REF D returns an error with a default mode off (--default-mode=off) or empty (--default-mode=empty).