AfAboTimeRead
 |
||||||||||||||||||||||||||||||||||||||||||||
| AfAboTimeRead(int1) : int |     |
|||||||||||||||||||||||||||||||||||||||||||
| Zeitpunkt der Benachrichtigung lesen | ||||||||||||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||||||||
Mit dieser Anweisung wird der Benachrichtigungszeitpunkt des in (int1) angegebenen Abonnements gelesen. Die Id wird von der Anweisung AfAboCreate() zurück gegeben oder kann über die Anweisung AfAboLstGet() ermittelt werden.
Nach der erfolgreichen Ausführung der Anweisung, stehen die entsprechenden Informationen in globalen Variablen zur Verfügung. Abhängig davon, ob eine Wiedervorlage oder eine Benachrichtigung bei Veränderung der Auslöser für das Abonnement ist, stehen unterschiedliche Informationen zur Verfügung:
| Variable | Datentyp | Beschreibung | Wiedervorlage | Veränderung |
| gAfAboTimeAboId | int | Id des Abonnements | ||
| gAfAboTimeNotifyType | int | Häufigkeit 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 |
Der Inhalt des Feldpuffers gAfAboTimeNotifyType kann mit folgenden Konstanten verglichen werden:
| sAfCheckPermanent | 0 | sofortige 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 |
Die Anzahl der Intervalle bis zur nächsten Benachrichtigung, findet sich in der Variablen gAfAboTimeNotifyInterval.
Ist die Variable gAfAboTimeNotifyType auf sAfCheckWeekly oder länger gesetzt, kann der Wochentag gelesen werden, zu dem das Abonnement versendet werden soll. Das Abonnement wird dann am ersten genannten Wochentag, nach dem angegebenen Intervall ausgelöst. Der Inhalt von gAfAboTimeNotifyWeekDay kann mit folgenden Konstanten verglichen werden:
| sAfWeekdayMonday | 1 | Montag |
| sAfWeekdayTuesday | 2 | Dienstag |
| sAfWeekdayWednesday | 3 | Mittwoch |
| sAfWeekdayThursday | 4 | Donnerstag |
| sAfWeekdayFriday | 5 | Freitag |
| sAfWeekdaySaturday | 6 | Samstag |
| sAfWeekdaySunday | 7 | Sonntag |
Weitere Informationen zu der Bedeutung der Feldpuffer befinden sich in der Beschreibung der Anweisung <a href="1499.htm#">AfAboTimeAdd()</a>.
Neben den allgemeinen Fehlerwerten können folgende Werte zurückgegeben werden:
| Konstante | Wert | Bedeutung |
| _ErrOk | 0 | ok - kein Fehler aufgetreten |
| _rNoKey | 3 | Das angegebene Abonnement hat keine Benachrichtigung definiert. |
Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.
