Dokumentation
IPS_SetEventScheduleActionEx
Benötigt: IP-Symcon >= 6.0
boolean IPS_SetEventScheduleActionEx (int $EreignisID, int $WochenplanAktionsID, string $Name, int $Farbe, string $AktionsID, array $AktionsParameter)
Parameterliste
| EreignisID | ID des zu verändernden Ereignisses |
| WochenplanAktionsID | Eindeutige ID für diese Wochenplanaktion. Die Sortierung wird anhand der ID vorgenommen. IDs müssen nur für dieses Ereignis eindeutig sein. |
| Name | Name zur angegebenen Wochenplanaktion |
| Farbe | Farbwert im HTML Farbcode (z.b. 0x0000FF für Blau) |
| AktionsID | ID 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 setzt den Namen, die Farbe und auszuführende Aktion mit der ID AktionsID mit Parametern AktionsParameter für die Wochenplanaktion mit der ID WochenplanAktionsID eines Wochenplan Ereignisses mit der ID EreignisID. Falls über die Aktion ein PHP-Skript ausgeführt wird, ist die Systemvariable $_IPS['ACTION'] definiert. Es stehen für die Skriptinhalte die Systemvariablen zur Verfügung.
Wenn der Name leer ist, wird die Wochenplanaktion mit der angegebenen WochenplanAktionsID gelöscht. Dies ist jedoch nur Möglich, wenn kein Schaltpunkt mehr auf diese WochenplanAktionsID verweist.
Die Spezialparameter TARGET, ENVIRONMENT und PARENT müssen hier nicht gesetzt werden, da sich diese durch das Ereignis ergeben
Der Wert −2147483648 ist keine gültige WochenplanAktionsID.
Es können maximal 32 Wochenplanaktionen erstellt werden.
Beispiel
//Anlegen von Wochenplanaktionen
IPS_SetEventScheduleActionEx($EreignisID, 0, "Warm", 0xFF0000, "{3644F802-C152-464A-868A-242C2A3DEC5C}", ["VALUE" => 22.5]);
IPS_SetEventScheduleActionEx($EreignisID, 1, "Kalt", 0xFF0000, "{3644F802-C152-464A-868A-242C2A3DEC5C}", ["VALUE" => 17]);
IPS_SetEventScheduleActionEx($EreignisID, 2, "Öko", 0xFF0000, "{3644F802-C152-464A-868A-242C2A3DEC5C}", ["VALUE" => 20]);
//Wochenplanaktion mit ID 2 wieder löschen
IPS_SetEventScheduleAction($EreignisID, 2, "", 0, "", []);