Bedingte Zuweisungen¶

Bedingte Zuweisungen bieten die Möglichkeit, einer Variable nur dann einen Wert zuzuweisen, wenn eine Bedingung erfüllt ist.

Allgemein gilt also:

Variable = If <Bedingung> erfüllt, then wird der Variablen der Inhalt von <Wert> zugewiesen.
Trifft die Bedingung nicht zu, so bleibt der Inhalt der Variablen unverändert.

Syntax¶

$def::var//n// = $func::getif//condition//(<Comparison partner>,<Value>)

Wobei gilt:

n adressiert eine bestimme Variable.
Bedingung ist ein Platzhalter für das Schlüsselwort, das die Bedingung beschreibt.
Vergleichspartner wird in die Ermittlung der Bedingung eingesetzt.
Wert ist der Inhalt, der zugewiesen wird, falls die Bedingung erfüllt ist.

Folgende bedingte Zuweisungen stehen im Skriptpaket zur Verfügung:

Zuweisung	Beschreibung
$func::getifcomponenttypeid(`<ID>`, `<Wert>`)	Überprüft, ob das Skript mit einem Bezug zu der Komponententyp-ID ausgeführt wird, die über`<ID>`übergeben wird
$func::getifcomponentid(`<ID>`, `<Wert>`)	Überprüft, ob das Skript mit einem Bezug zu der Komponenten-ID ausgeführt wird, die über`<ID>`übergeben wird
$func::getifuserid(`<ID>`, `<Wert>`)	Überprüft, ob das Skript mit einem Bezug zu dem Benutzer ausgeführt wird, der über`<ID>`übergeben wird
$func::getifip(`<IP>`, `<Wert>`)	Überprüft, ob das Skript auf dem Rechner ausgeführt wird, der über`<IP>`übergeben wird.`<IP>`kann entweder die IP-Adresse oder der Rechnername sein
$func::getiffileexists(`<Datei>`, `<Wert>`)	Überprüft, ob die Datei vorhanden ist, die über`<Datei>`übergeben wird
$func::getifjobid(`<Job-ID>`, `<Wert>`)	Überprüft, ob das Skript mit einem Bezug zu der Job-ID ausgeführt wird, die über`<ID>`übergeben wird. Diese Bedingung steht ausschließlich für das Ereignisse BeforeUpload, AfterUpload und AfterSchedulerJobRun zur Verfügung.
$func::getiftrue(`<Bedingung>`, `<Wert>`) $func::getiffalse(`<Bedingung>`, `<Wert>`)	Interpretiert die Bedingung, die in "chCondition" beschrieben ist. Der Rückgabewert ist das logische Ergebnis der Bedingung. Beispiele für die Bedingungsformulierung sind: `a=b` `a<b` `a>b` `a!=b` `a<=b` `a>=b`.
	Sonderworte für ein true sind: true, yes, y, 1.
	Sonderworte für false sind: false, no, n, 0,`<leer>`.
	Folgende Beispiele führen die Zuweisung durch:`$def::var1 = $func::getiftrue(0<=5, Wert)` `$def::var1 = $func::getiftrue(1=1, Wert)` `$def::var1 = $func::getiftrue(true, Wert)`.
	Folgende Beispiele führen keine Zuweisung durch:`$def::var1 = $func::getiftrue(6<4, Wert)` `$def::var1 = $func::getiftrue( , Wert)` `$def::var1 = $func::getiftrue(false , Wert)`
	`$func::getiffalse` ist die invertierte Methode von `$func::getiftrue` und funktioniert analog.