Dokumentation
IPS_RunScriptEx
bool IPS_RunScriptEx (int $SkriptID, array $Parameter)
Parameterliste
| SkriptID | Eindeutige ID des Skriptes |
| Parameter | Key (string) => Value (variant) Paare, auf die im neu ausgeführten Skript zugegriffen werden kann. |
Rückgabewert
Konnte die Funktion erfolgreich ausgeführt werden, liefert sie als Ergebnis TRUE, andernfalls FALSE.
Beschreibung
Die Funktion veranlasst den Start des Skripts mit der ID SkriptID und übergibt dabei das Array Parameter als Argument. Das aufgerufene Skript läuft parallel (gleichzeitig) zum aufrufenden Skript. Auch hier gelten die bei IPS_RunScript beschriebenen Hinweise.
Skripte, die durch IPS_RunScriptEx ausgeführt werden, beinhalten diese Systemvariablen
Das Array Parameter kann beliebig viele “Key => Value” Paare enthalten (siehe PHP Arrays). Jedes Paar steht im aufgerufenen Skript in der globalen Variable __$_IPS unter dem Index Key mit ihrem Inhalt Value__ zur Verfügung.
Beispiel
//Skript, das ein anderes Skript mit Parameterübergabe starten will
IPS_RunScriptEx(12345 /*[Temp]*/, Array("Titel" => "Temp.", "Tmin" => 10.0));
//Skript, das aufgerufen wurde. Parameter sind als einzelne Variablen in der
//globalen Variablen $_IPS verfügbar. Der Variablenname entspricht dem im Array-Index
//übergebenen Namen.
$Ueberschrift = $_IPS['Titel']. "verlauf"; //Ergibt: Temp.verlauf
$MaxTemp = $_IPS['Tmin'] + 30.0;