Dokumentation
IPS_RunAction
bool IPS_RunAction (string $AktionsID, array $AktionsParameter)
Parameterliste
| AktionsID | GUID der auszuführenden Aktion |
| AktionsParameter | Liste der Parameter der auszuführenden Aktion |
Rückgabewert
Konnte die Funktion erfolgreich ausgeführt werden, liefert sie 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ü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
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
}