Dokumentation
IPS_SetEventConditionDateRule
Benötigt: IP-Symcon >= 4.4
boolean IPS_SetEventConditionDateRule (int $EreignisID, int $BedingungsID, int $RegelID, int $Vergleich, int $Tag, int $Monat, int $Jahr)
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 |
|
||||||||||||||
| Tag | Tag mit dem das aktuelle Datum verglichen wird |
||||||||||||||
| Monat | Monat mit dem das aktuelle Datum verglichen wird |
||||||||||||||
| Jahr | Jahr mit dem das aktuelle Datum verglichen wird |
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 das aktuelle Datum mit den Tag, Monat und Jahr, entsprechend der Vergleichsoperation Vergleich. Falls keine Regel mit der ID RegelID existiert, wird eine erstellt.
Ist einer der Werte Tag, Monat oder Jahr < 0 , wird die Regel mit der ID RegelID gelöscht.
Tag, Monat und Jahr kann auf 0 gesetzt werden und so als Wildcard genutzt werden
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 die erste Jahreshälfte -> aktuelles Datum < 01.07.2018
IPS_SetEventConditionDateRule(12345, 0, 2, 4, 1, 7, 2018);
// Lösche die Regel mit der ID 1
IPS_SetEventConditionDateRule(12345, 0, 1, 0, -1, 0, 0);