Dokumentation
IPS_SetEventConditionDayOfTheWeekRule
Benötigt: IP-Symcon >= 5.2
boolean IPS_SetEventConditionDayOfTheWeekRule (int $EreignisID, int $BedingungsID, int $RegelID, int $Vergleich, int $Wochentag)
Parameterliste
| EreignisID | ID des zu verändernden Ereignisses |
||||||||||||||||||
| BedingungsID | ID der Bedingung, welche die Regel beinhaltet |
||||||||||||||||||
| RegelID | Eindeutige ID für diese Regel. IDs müssen nur für dieses Bedingung eindeutig sein. |
||||||||||||||||||
| Vergleich |
|
||||||||||||||||||
| Wochentag |
|
Rückgabewert
Konnte der Befehl erfolgreich ausgeführt werden, liefert er als Ergebnis TRUE, andernfalls FALSE.
Beschreibung
Diese Funktion modifiziert die Regel mit der ID RegelID der Bedingung mit der ID BedingungsID des Ereignisses mit der ID EreignisID. Die Regel vergleicht den aktuellen Wochentag mit dem Wochentag, entsprechend der Vergleichoperation Vergleich. Falls keine Regel mit der ID RegelID existiert, wird eine erstellt.
Ist der Wert Wochentag gleich 0, wird die Regel mit der ID RegelID gelöscht.
Welche RegelID welche Regel beinhaltet kann via IPS_GetEvent nachgesehen werden.
Beispiel
//Eine AND Bedingung hinzufügen
IPS_SetEventCondition(12345, 0, 0, 0)
// Fügt hinzu/Modifiziert die Regel mit der ID 2 beim Ereignis mit der ObjektID 12345
// Es ist größer gleich Donnerstag d.h.: Donnerstag bis Sonntag inklusive
IPS_SetEventConditionDayOfTheWeekRule(12345, 0, 2, 3, 4);
// Fügt hinzu/Modifiziert die Regel mit der ID 3 beim Ereignis mit der ObjektID 12345
// Es ist ungleich Sonntag
IPS_SetEventConditionDayOfTheWeekRule(12345, 0, 3, 1, 7);
// Lösche die Regel mit der ID 2
IPS_SetEventConditionDayOfTheWeekRule(12345, 0, 2, 0, 0);