Dokumentation
IPS_RunActionWait
string IPS_RunActionWait (string $AktionsID, array $AktionsParameter)
Parameterliste
| AktionsID | ID 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 ID AktionsID und den Parametern AktionsParameter. Die Aktion wird ausgeführt und wartet auf das Ende um ggfs. 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ührumgebung 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;
}