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.