AfAboTimeAdd: Unterschied zwischen den Versionen

Aktuelle Version vom 25. Oktober 2024, 12:59 Uhr

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

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.

@@ Zeile 4: / Zeile 4: @@
    </tr>
    <tr class="ProcSyntax">
-     <td class="title" width="100%">&nbsp;AFAboTimeAdd(int1, int2) : int</td>
+     <td class="title">&nbsp;AfAboTimeAdd(int1, int2) : int</td>
      <td class="platforms">[[file:DE_SymbolNoAPI.gif|alt=Nicht ausführbar von der API|link=Befehle der Schnittstellen]][[file:DE_SymbolNoDLL.gif|alt=Nicht ausführbar von der Programmierschnittstelle (DLL)|link=Befehle der Schnittstellen]][[file:DE_SymbolNoARC.gif|alt=Nicht ausführbar mit der Application Remote Control|link=Befehle der Schnittstellen]][[file:DE_SymbolScriptAPI.gif|alt=Ausführbar von der Script-API|link=Befehle der Schnittstellen]]</td>
    </tr>
@@ Zeile 17: / Zeile 17: @@
    <td colspan="3" width="85%" class=Right>Id des Abonnements</td>
 </tr>
 <tr class="ProcParameterItem">
@@ Zeile 66: / Zeile 65: @@
 </table></td>
 </tr>
 <tr class="ProcParameterItem">
@@ Zeile 130: / Zeile 128: @@
    <td width="15%" class=Left>Siehe</td>
    <td width="85%" class=Right colspan="3">
-[[AFAboCreate|AfAboCreate()]],
+[[:Category:Befehle für Abonnements|Verwandte Befehle]], [[AfAboCreate|AfAboCreate()]],
-[[AFAboTimeEdit|AfAboTimeEdit()]]
+[[AfAboTimeEdit|AfAboTimeEdit()]]
    </td>
 </tr>
@@ Zeile 141: / Zeile 139: @@
 </table>
 <div class="BigLang">
-<p><p>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 <a href="1501.htm#">AfAboCreate()</a> zurück gegeben. Für das Benachrichtigungsintervall stehen folgende Konstanten zur Verfügung:</p>
+<p>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|AfAboCreate()]] zurück gegeben. Für das Benachrichtigungsintervall stehen folgende Konstanten zur Verfügung:</p>
 <table class=lang>
@@ Zeile 191: / Zeile 189: @@
 </table>
-<p>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: </p></p>
+<p>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: </p>
-<p><table class=lang>
+<table class=lang>
    <tr>
      <td valign=top><b>Feldpuffer / Typ</b></td>
@@ Zeile 286: / Zeile 284: @@
 <p>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.</p>
-<p>Wird eine ungültige Kombination von Werten übergeben, gibt die Anweisung den Fehler <font class=source>_ErrValueInvalid</font> zurück. Ein Abonnement kann nur einen Benachrichtigungszeitpunkt haben. Ist dieser bereits definiert, wird der Fehler <font class=source>_rExists</font> zurückgegeben.</p></p>
+<p>Wird eine ungültige Kombination von Werten übergeben, gibt die Anweisung den Fehler <font class=source>_ErrValueInvalid</font> zurück. Ein Abonnement kann nur einen Benachrichtigungszeitpunkt haben. Ist dieser bereits definiert, wird der Fehler <font class=source>_rExists</font> zurückgegeben.</p>
 <p><b>Beispiel:</b>
-</p><p>
 <p>Einmalige Benachrichtigung für den Benutzer "admin" zum Ende des Jahres um 08:00 Uhr.</p>
+<pre class=source>
-<code><pre>
 ...
-tResult # AFAboCreate(sAfAboTypeAbm, CnvAI(tAbmId, _FmtInternal), var tAboId);
+tResult # AfAboCreate(sAfAboTypeAbm, CnvAI(tAbmId, _FmtInternal), var tAboId);
 ...
 tResult # AfAboUserAdd(tAboId, sAfAboUserTypeUsr, 'admin');
@@ Zeile 309: / Zeile 305: @@
 tResult # AfAboTimeAdd(tAboId, sAfCheckOnce);
 ...
-</pre></code>
+</pre>
+<p>
+Neben den [[Allgemeine Fehlercodes#|allgemeinen Fehlerwerten]]
+können folgende Werte zurückgegeben werden:
 </p>
-<p>
-  Neben den <a href="30.htm#">allgemeinen Fehlerwerten</a>
-können folgende Werte zurückgegeben werden:
-</p><p>
    <table class=lang>
      <tr>
@@ Zeile 345: / Zeile 339: @@
    </table>
 </p><p>
-  Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die
+Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.
-aktuelle CONZEPT 16-Hilfe.
 </p>
 </div>
+[[Category:Befehle für Abonnements]]

AfAboTimeAdd: Unterschied zwischen den Versionen

Aktuelle Version vom 25. Oktober 2024, 12:59 Uhr

Navigationsmenü

ArcFlow Wiki

Meine Werkzeuge

Namensräume

Varianten

Ansichten

Suche

Navigation

Werkzeuge