Dokumentation
IPS_RunAction
boolean IPS_RunAction (string $AktionsID, array $AktionsParameter)
Parameterliste
AktionsID | GUID der auszuführenden Aktion |
AktionsParameter | Liste der Parameter der auszuführenden Aktion |
Rückgabewert
Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis TRUE, andernfalls FALSE.
Beschreibung
Die Funktion veranlasst die Ausführung der Aktion mit der GUID AktionsID und den Parametern AktionsParameter. Die Ausführung läuft parallel (gleichzeitig) zum aufrufenden Skript.
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
IPS_RunAction("{7938A5A2-0981-5FE0-BE6C-8AA610D654EB}", ["TARGET" => 12345, "ENVIRONMENT" => "Default", "PARENT" => $_IPS['SELF']]);
// Zeige alle Aktionen und dazugehörigen GUIDs an
foreach(json_decode(IPS_GetActions(), true) as $action) {
echo $action['id'] . " -> " . $action['caption'] . PHP_EOL;
// var_dump($action); <-- Gibt alle Details wie z.B. restrictions aus
}