« Zurück zu Produkt

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
}
Haben Sie noch Fragen?