AfAboTimeAdd

AfAboTimeAdd(int1, int2) : int
Zeitpunkt der Benachrichtigung hinzufügen
int1 Id des Abonnements int2 Intervall der Benachrichtigung sAfCheckIntervall 1 Benachrichtigungen im Abstand von Minuten sAfCheckDaily 2 Benachrichtigungen im Abstand von Tagen sAfCheckWeekly 3 Benachrichtigungen im Abstand von Wochen sAfCheckMonthly 4 Benachrichtigungen im Abstand von Monaten sAfCheckQuarterly 5 Benachrichtigung im Abstand von Quartalen sAfCheckSemiyearly 6 Benachrichtigung im Abstand von halben Jahren sAfCheckYearly 7 Benachrichtigung im Abstand von Jahren sAfCheckOnce 8 Einmalige Benachrichtigung Feldpuffer gAfAboTimeAboId int Id des Abonnements gAfAboTimeNotifyType int Typ der Benachrichtigung gAfAboTimeNotifyInterval int Abstand bis zur Benachrichtigung gAfAboTimeNotifyTime time Uhrzeit der Benachrichtigung gAfAboTimeNotifyWeekDay int Wochentag der Benachrichtigung gAfAboTimeNotifyDayOfMonth int Tag im Monat der Benachrichtigung gAfAboTimeNotifyMonth int Monat der Benachrichtigung gAfAboTimeNotifyNextCheckDate date Datum der nächsten Benachrichtigung gAfAboTimeNotifyNextCheckTime time Uhrzeit der nächsten Benachrichtigung Resultat int Fehlerwert Siehe Verwandte Befehle, AfAboCreate(), AfAboTimeEdit()

Mit dieser Anweisung wird der Versendezeitpunkt des Abonnements angegeben. In den Parametern wird die Abonnement-Id (int1) und das Benachrichtigungsintervall (int2) übergeben. Die Id wird von der Anweisung AfAboCreate() zurück gegeben. Für das Benachrichtigungsintervall stehen folgende Konstanten zur Verfügung:

Konstante	Wert	Bedeutung
sAfCheckInterval	1	Benachrichtigungen im Abstand von Minuten
sAfCheckDaily	2	Benachrichtigungen im Abstand von Tagen
sAfCheckWeekly	3	Benachrichtigungen im Abstand von Wochen
sAfCheckMonthly	4	Benachrichtigungen im Abstand von Monaten
sAfCheckQuarterly	5	Benachrichtigung im Abstand von Quartalen
sAfCheckSemiyearly	6	Benachrichtigung im Abstand von halben Jahren
sAfCheckYearly	7	Benachrichtigung im Abstand von Jahren
sAfCheckOnce	8	Einmalige Benachrichtigung

Da die Id des Abonnements und der Typ der Benachrichtigung in den Parametern übergeben wird, werden die entsprechenden Inhalte in den Feldpuffern ignoriert. Je nach angegebenem Typ müssen bestimmte Feldpuffer gefüllt werden:

Feldpuffer / Typ	sAfCheckInterval	sAfCheckDaily	sAfCheckWeekly	sAfCheckMonthly	sAfCheckQuarterly	sAfCheckSemiyearly	sAfCheckYearly	sAfCheckOnce
gAfAboTimeNotifyInterval	X	X	X	X	X	X	X
gAfAboTimeNotifyTime		X	X	X	X	X	X
gAfAboTimeNotifyWeekDay			X	X	X	X	X
gAfAboTimeNotifyDayOfMonth				X	X	X	X
gAfAboTimeNotifyMonth				X	X	X	X
gAfAboTimeNotifyNextCheckDate	X	X	X	X	X	X	X	X
gAfAboTimeNotifyNextCheckTime	X	X	X	X	X	X	X	X

Bei einer monatlichen, vierteljährlichen, halbjährlichen oder jährlichen Benachrichtigung genügt die Angabe des Tages im Monat oder des Wochentages. Eine Benachrichtigung wird dann zum Beispiel am 1. Tag des Monats oder am ersten Montag des Monates versendet.

Wird eine ungültige Kombination von Werten übergeben, gibt die Anweisung den Fehler _ErrValueInvalid zurück. Ein Abonnement kann nur einen Benachrichtigungszeitpunkt haben. Ist dieser bereits definiert, wird der Fehler _rExists zurückgegeben.

Beispiel:

Einmalige Benachrichtigung für den Benutzer "admin" zum Ende des Jahres um 08:00 Uhr.

...
tResult # AfAboCreate(sAfAboTypeAbm, CnvAI(tAbmId, _FmtInternal), var tAboId);
...
tResult # AfAboUserAdd(tAboId, sAfAboUserTypeUsr, 'admin');
...
gAfAboTimeNotifyType          # 0;
gAfAboTimeNotifyInterval      # 0;
gAfAboTimeNotifyTime          # 00:00;
gAfAboTimeNotifyWeekDay       # 0;
gAfAboTimeNotifyDayOfMonth    # 0;
gAfAboTimeNotifyMonth         # 0;
gAfAboTimeNotifyNextCheckDate # 31.12.2023;
gAfAboTimeNotifyNextCheckTime # 08:00;
tResult # AfAboTimeAdd(tAboId, sAfCheckOnce);
...

Neben den allgemeinen Fehlerwerten können folgende Werte zurückgegeben werden:

Konstante	Wert	Bedeutung
_ErrOk	0	ok - kein Fehler aufgetreten
_rExists	6	Das Abonnement hat bereits einen Benachrichtungszeitpunkt definiert.
_ErrValueInvalid	-188	In den Feldpuffern würde eine ungültige Kombination von Benachrichtigungszeitpunkten angegeben.

Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.