Dokumentation
IPS_RunActionWait
string IPS_RunActionWait (string $AktionsID, array $AktionsParameter)
Parameterliste
| AktionsID | GUID der auszuführenden Aktion |
| AktionsParameter | Liste der Parameter der auszuführenden Aktion |
Rückgabewert
Fehlermeldung der Ausführung
Beschreibung
Die Funktion veranlasst die Ausführung der Aktion mit der GUID AktionsID und den Parametern AktionsParameter. Die Funktion wartet auf das Ende der Ausführung, um ggf. eine Fehlermeldung zurückzugeben. Lief die Ausführung fehlerfrei, so gibt die Funktion einen leeren String zurück.
Hierbei müssen die Aktionsparameter folgende Einträge beinhalten:
| Parameter | Beschreibung |
|---|---|
| TARGET | ID des Zielobjektes der Aktion (-1 bei allgemeinen Aktionen) |
| ENVIRONMENT | Die Ausführungsumgebung der Aktion, siehe auch Umgebungen |
| PARENT | ID des ausführenden Objekts der Aktion, beispielsweise das Skript oder der Ablaufplan |
Beispiel
// Führe Skript mit der ID 12345 aus
$error = IPS_RunActionWait("{7938A5A2-0981-5FE0-BE6C-8AA610D654EB}", ["TARGET" => 12345, "ENVIRONMENT" => "Default", "PARENT" => $_IPS['SELF']]);
if ($error === "") {
echo "Aktion wurde fehlerfrei ausgeführt";
}
else {
echo "Bei der Ausführung gab es einen Fehler: " . $error;
}