Bedingungen

Die Beschreibung des Assistenten kann alle Elemente einer Sektion mit Bedingungen versehen. Über eine Bedingung lässt sich die ausgegebene HTML-Seite kontextabhängig verändern, indem bestimmte Konfigurationsmöglichkeiten in Abhängigkeit der zuvor getätigten Einstellungen ein- oder ausgeblendet werden.

Die Bedingungen beziehen sich dabei immer auf das vorhergehende Element und bestehen aus der Angabe einer Klasse und einem oder mehreren Bedingungsmustern. Ein Muster wiederum besteht aus zwei Operanden und einem Operator. Hierbei gilt:

Eine Klasse darf beliebig viele Bedingungsmuster und ein Element beliebig viele Bedingungen enthalten. Die folgenden Bedingungen z. B. zeigen die Sektion nur dann an, wenn die interne Variable wizard.test_select1 gleich 1, und wizard.test_select4 oder wizard.test_select5 gleich 0 sind:

section
only_if wizard.test_select1, "1", equal
only_if wizard.test_select4, "0", equal, wizard.test_select5, "0", equal

Klassen

Die Beschreibung kann die folgenden Klassen enthalten:
  • only-if: Das vorhergehende Element wird nur ausgeführt oder angezeigt, wenn mindestens eines der folgenden Bedingungsmuster erfüllt ist.
  • skip-if: Das vorhergehende Element wird nicht ausgeführt oder angezeigt, wenn alle der folgenden Bedingungsmuster erfüllt sind.

Operanden

Das Bedingungsmuster kann folgende Operanden enthalten:
  • Statische Texte
  • Interne Variablen des Assistenten
  • Variablen zur Referenzierung von Werten aus der aktuellen Konfiguration des Gerätes (Konfigurations-Variablen)
  • Das Zeichen '*' als Platzhalter (Wildcard)

Operatoren

Das Bedingungsmuster kann folgende Operatoren enthalten:
  • equal: Prüft, ob die beiden Operanden gleich sind.
  • exists: Prüft, ob die angegebene Konfigurations-Variable gesetzt ist, also der Wert des Parameters in der Konfiguration nicht leer ist.
  • empty: Prüft, ob der erste Operand leer ist. Der zweite Operand wird als Platzhalter (Wildcard) '*' angegeben.
  • contains: Prüft, ob der erste Operand den zweiten Operanden enthält.
  • !: Verneint die Bedingung.

Beispiele

Die folgende Bedingung zeigt die Sektion nur dann an, wenn die interne Variable 'wizard.test_select' gleich '0' ist.

section
only_if wizard.test_select, "0", equal

Die folgende Bedingung setzt die interne Variable 'wizard.intranet_name' auf den Wert 'INTRANET', wenn diese Variable bisher leer ist.

set wizard.intranet_name, "INTRANET"
only_if wizard.intranet_name, *, empty

Die folgende Bedingung setzt die interne Variable 'wizard.target_1' auf den Wert 'ZIEL_1', wenn die interne Variable 'wizard.select_target' entweder den Wert '1' oder den Wert '5' hat.

set wizard.target_1,"ZIEL_1"
only_if wizard.select_target,"1",equal,wizard.select_target,"5",equal