CIB merge technischer Leitfaden
6. Aufrufparameter im Detail
6.51. Parameter --next-mode
[--next-modus/--next]
Der Parameter --next-mode steuert das Verhalten des {NEXT}-Befehls und wirkt auf Variablen, die zwar in einem Datensatz, im nächsten aber nicht mehr vorhanden sind.
Syntax
--next-mode=<Option>
<Option>: delete, empty oder keep
Beschreibung
Variablen, die zwar in dem einen, aber im nächsten Datensatz nicht mehr vorhanden sind, können mithilfe des Parameters --next-mode gelöscht, geleert oder beibehalten werden.
Mögliche Werte für <Option> sind:
Option |
Bedeutung |
delete |
Die Variablen werden gelöscht und sind somit nicht mehr definiert. |
empty |
Die Variablen werden geleert. Diese sind dann noch definiert aber leer wie „“ |
keep |
Die Variablen werden beibehalten und die Werte bleiben unverändert. |
Beispiel
--next-mode=delete
Ist eine Variable im nächsten Datensatz nicht mehr vorhanden (z.B. fehlender Knoten im XML), so wird diese Variable gelöscht, was daraufhin zu einem Fehler führt. Dies ist erwünscht, damit der Fehler nicht unerkannt bleibt, indem der fehlende Wert einfach ausgelassen wird.
Dieser Parameter wird im Anwendungsbeispiel Serienbrief veranschaulicht.