RequestActionEx

Benötigt: Symcon >= 5.0

 bool RequestActionEx (int $VariablenID, mixed $Wert, string $Sender) 

Parameterliste

Rückgabewert

Konnte die Funktion erfolgreich ausgeführt werden, liefert sie als Ergebnis TRUE, andernfalls FALSE.

Beschreibung

Die Funktion führt die Aktion der Variable mit der ID VariablenID mit dem Wert Wert und dem Sender Sender aus. Hierbei wird die gleiche Schaltaktion wie im WebFront und anderen Visualisierungen verwendet. Ist für die Variable ein eigenes Aktionsskript definiert, so wird dieses Skript ausgeführt. Ansonsten wird, falls vorhanden, die Standardaktion einer Instanzvariable ausgeführt. Existiert weder eine eigene noch eine Standardaktion, so führt die Funktion RequestActionEx zu einem Fehler. Üblicherweise schalten Variablenaktionen die dazugehörige Eigenschaft eines Gerätes entsprechend des neuen Wertes und setzen abschließend den Wert der Variablen entsprechend. Kommt es beim Schalten zu einem Fehler, wird dieser ausgegeben. Es ist darauf zu achten, dass der Typ des Wertes zum Typ der Variablen passt. Ist die Zielvariable vom Typ String, so sollte auch Wert vom Typ String sein. Des Weiteren steht im Skript die Systemvariable mit $_IPS["SENDER"] = Sender zur Verfügung.

Falls der Typ der Variablen und des Wertes nicht übereinstimmen, wird der Wert in den Typ der Variable konvertiert. Das Ergebnis dieser Konvertierung kann aber vom erwarteten Ergebnis abweichen. Es ist daher besser von vornherein den richtigen Typ zu übergeben.

Beispiel

// Boolean-Variable mit Sender Alarmanlage einschalten
RequestActionEx(12345, true, "Alarmanlage");

// Integer-Variable mit Sender TemperaturKlimaanlage einstellen
RequestActionEx(23456, 18, "TemperaturKlimaanlage");