AfAboCreate - Versionsgeschichte

Jens: Stand 4.1.13 Beispiel geändert, Helptip Ausführung angepasst

2026-02-05T10:32:44Z

Stand 4.1.13 Beispiel geändert, Helptip Ausführung angepasst

← Nächstältere Version		Version vom 5. Februar 2026, 10:32 Uhr
Zeile 5:		Zeile 5:
	<tr class="ProcSyntax">		<tr class="ProcSyntax">
	<td class="title"> AfAboCreate(int1, alpha2, int3[, int4]) : int</td>		<td class="title"> AfAboCreate(int1, alpha2, int3[, int4]) : 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>		<td class="platforms">
			[[file:DE_SymbolNoAPI.gif\|alt=Nicht ausführbar von der API\|link=Befehle der Schnittstellen\|Nicht ausführbar von der API]][[file:DE_SymbolNoDLL.gif\|alt=Nicht ausführbar von der Programmierschnittstelle (DLL)\|link=Befehle der Schnittstellen\|Nicht ausführbar von der Programmierschnittstelle (DLL)]][[file:DE_SymbolNoARC.gif\|alt=Nicht ausführbar mit der Application Remote Control\|link=Befehle der Schnittstellen\|Nicht ausführbar mit der Application Remote Control]][[file:DE_SymbolScriptAPI.gif\|alt=Ausführbar von der Script-API\|link=Befehle der Schnittstellen\|Ausführbar von der Script-API]]
			</td>
	</tr>		</tr>
	<tr class="ProcShortDescription">		<tr class="ProcShortDescription">
Zeile 347:		Zeile 349:
	<p>Nicht alle Kombinationen sind zulässig. Die Auslöser müssen zum angegebenen Objekt passen. Bei einer ungültigen Kombination gibt die Anweisung den Fehlerwert <font class=source>_ErrValueInvalid</font> zurück.</p></p>		<p>Nicht alle Kombinationen sind zulässig. Die Auslöser müssen zum angegebenen Objekt passen. Bei einer ungültigen Kombination gibt die Anweisung den Fehlerwert <font class=source>_ErrValueInvalid</font> zurück.</p></p>

	~~<p><b>~~Beispiel~~:</b>~~		== Beispiel ==
	~~</p><p>~~

	<p>In diesem Beispiel wird ein Abonnement zur Überwachung einer Anhangdatei eingerichtet. Über weitere Anweisungen wird der zu benachrichtigende Benutzer und das Zeitintervall definiert. In diesem Beispiel wird der Sachbearbeiter Dieter Staub (DST) bei Änderungen an der Anhangdatei am nachfolgenden Montag benachrichtigt.</p>

			<tabber>
			\|-\|ScriptAPI=
			In diesem Beispiel wird ein Abonnement zur Überwachung einer Anhangdatei eingerichtet. Über weitere Anweisungen wird der zu benachrichtigende Benutzer und das Zeitintervall definiert. In diesem Beispiel wird der Sachbearbeiter Dieter Staub (DST) bei Änderungen an der Anhangdatei am nachfolgenden Montag benachrichtigt.
	<pre class=source>		<pre class=source>
	gAfAboSendType # sAfSendTypeMail;		gAfAboSendType # sAfSendTypeMail;
Zeile 358:		Zeile 360:
	gAfAboNotifications # sAfAboAnhEdit \| sAfAboAnhDelete;		gAfAboNotifications # sAfAboAnhEdit \| sAfAboAnhDelete;
	tResult # AfAboCreate(sAfAboTypeAnh, gAfArcNr, var tAboNo, gAfArcFileNr);		tResult # AfAboCreate(sAfAboTypeAnh, gAfArcNr, var tAboNo, gAfArcFileNr);
	...		if (tResult != _ErrOk)
			{
			// Fehlerbehandlung
			...
			}
	tResult # AfAboUserAdd(tAboNo, sAfAboUserTypeSab, 'DST');		tResult # AfAboUserAdd(tAboNo, sAfAboUserTypeSab, 'DST');
	...		if (tResult != _ErrOk)
			{
			// Fehlerbehandlung
			...
			}
	gAfAboTimeNotifyTime # 11:00;		gAfAboTimeNotifyTime # 11:00;
	gAfAboTimeNotifyWeekDay # sAfWeekdayMonday;		gAfAboTimeNotifyWeekDay # sAfWeekdayMonday;
	tResult # AfAboTimeAdd(tAboNo, sAfCheckWeekly);		tResult # AfAboTimeAdd(tAboNo, sAfCheckWeekly);
	...		if (tResult != _ErrOk)
	</pre></p>		{
			// Fehlerbehandlung
			...
			}
			</pre>
			</tabber>

	<p>		<p>

Jens: Stand 4.1.09

2024-10-25T13:11:49Z

Stand 4.1.09

← Nächstältere Version		Version vom 25. Oktober 2024, 13:11 Uhr
Zeile 4:		Zeile 4:
	</tr>		</tr>
	<tr class="ProcSyntax">		<tr class="ProcSyntax">
	<td class="title"> ~~AFAboCreate~~(int1, alpha2, int3[, int4]) : int</td>		<td class="title"> AfAboCreate(int1, alpha2, int3[, int4]) : 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>		<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>		</tr>
Zeile 125:		Zeile 125:
	<td width="15%" class=Left>Siehe</td>		<td width="15%" class=Left>Siehe</td>
	<td width="85%" class=Right colspan="3">		<td width="85%" class=Right colspan="3">
	[[:Category:Befehle für Abonnements\|Verwandte Befehle]], [[~~AFAboEdit~~\|AfAboEdit()]], [[~~AFAboDelete~~\|AfAboDelete()]]		[[:Category:Befehle für Abonnements\|Verwandte Befehle]], [[AfAboEdit\|AfAboEdit()]], [[AfAboDelete\|AfAboDelete()]]
	</td>		</td>
	</tr>		</tr>

Jens: Jens verschob die Seite AFAboCreate nach AfAboCreate, ohne dabei eine Weiterleitung anzulegen

2024-10-25T12:51:12Z

Jens verschob die Seite AFAboCreate nach AfAboCreate, ohne dabei eine Weiterleitung anzulegen

← Nächstältere Version	Version vom 25. Oktober 2024, 12:51 Uhr
(kein Unterschied)

Jens: Stand 4.1.08 Buchstaben Kategorie entfernt

2023-11-21T14:24:37Z

Stand 4.1.08 Buchstaben Kategorie entfernt

← Nächstältere Version		Version vom 21. November 2023, 14:24 Uhr
Zeile 397:		Zeile 397:
	</div>		</div>
	[[Category:Befehle für Abonnements]]		[[Category:Befehle für Abonnements]]
	~~[[Category:ListeAllerApiBefehleA]]~~

Jens: Stand 4.1.08

2023-11-06T13:12:17Z

Stand 4.1.08

← Nächstältere Version		Version vom 6. November 2023, 13:12 Uhr
Zeile 125:		Zeile 125:
	<td width="15%" class=Left>Siehe</td>		<td width="15%" class=Left>Siehe</td>
	<td width="85%" class=Right colspan="3">		<td width="85%" class=Right colspan="3">
	[[AFAboEdit\|AfAboEdit()]], [[AFAboDelete\|AfAboDelete()]]		[[:Category:Befehle für Abonnements\|Verwandte Befehle]], [[AFAboEdit\|AfAboEdit()]], [[AFAboDelete\|AfAboDelete()]]
	</td>		</td>
	</tr>		</tr>

Jens: Die Seite wurde neu angelegt: „

file:DE_Schriftzug.gif

file:DE_Schriftzug.gif</td> </tr> <tr class="ProcSyntax"> <td class="t…“

Neue Seite
<table class=head>
<tr>
<td class="BigTitle" colspan="2" align="center">[[file:DE_Schriftzug.gif]]</td>
</tr>
<tr class="ProcSyntax">
<td class="title"> AFAboCreate(int1, alpha2, int3[, int4]) : 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>
<tr class="ProcShortDescription">
<td class="description" colspan="2">Erstellen eines Abonnements</td>
</tr>
<tr>
<td width="100%" colspan="2">
<table class="para">
<tr class="ProcParameterItem">
<td valign=top width="15%" class=Left>int1</td>
<td colspan="3" width="85%" class=Right>Abonnementtyp
<table class=lang>
<tr>
<td valign=top>sAfAboTypeAbm</td>
<td valign=top>Arbeitsmappe</td>
</tr>
<tr>
<td valign=top>sAfAboTypeArc</td>
<td valign=top>Archiv</td>
</tr>
<tr>
<td valign=top>sAfAboTypeAnh</td>
<td valign=top>Anhangdatei</td>
</tr>
</table></td>
</tr>

<tr class="ProcParameterItem">
<td valign=top width="15%" class=Left>alpha2</td>
<td colspan="3" width="85%" class=Right>Archiv- oder Arbeitsmappennummer</td>
</tr>

<tr class="ProcParameterItem">
<td valign=top width="15%" class=Left>int3</td>
<td colspan="3" width="85%" class=Right>Nummer des neuen Abonnements</td>
</tr>

<tr class="ProcParameterItem">
<td valign=top width="15%" class=Left>int4</td>
<td colspan="3" width="85%" class=Right>Nummer der Anhangdatei (optional)</td>
</tr>

<tr class="ProcParameterItem">
<td valign=top width="15%" class=Left>Feldpuffer</td>
<td colspan="3" width="85%" class=Right><table class=lang>

<tr>
<td valign=top>gAfAboId</td>
<td valign=top>int</td>
<td valign=top>Nummer des Abonnements</td>
</tr>
<tr>
<td valign=top>gAFAboObjectType</td>
<td valign=top>int</td>
<td valign=top>Objekttyp</td>
</tr>
<tr>
<td valign=top>gAfAboObject</td>
<td valign=top>alpha(80)</td>
<td valign=top>Nummer der Arbeitsmappe, des Archives und der Anhangdatei</td>
</tr>
<tr>
<td valign=top>gAFAboSendType</td>
<td valign=top>int</td>
<td valign=top>Benachrichtigungstyp</td>
</tr>
<tr>
<td valign=top>gAFAboName</td>
<td valign=top>alpha(250)</td>
<td valign=top>Bezeichnung</td>
</tr>
<tr>
<td valign=top>gAFAboNote</td>
<td valign=top>alpha(4096)</td>
<td valign=top>Beschreibung</td>
</tr>
<tr>
<td valign=top>gAFAboNotifications</td>
<td valign=top>int</td>
<td valign=top>Anzahl der Benachrichtigungen</td>
</tr>
<tr>
<td valign=top>gAFAboOwner</td>
<td valign=top>alpha(25)</td>
<td valign=top>Ersteller</td>
</tr>
<tr>
<td valign=top>gAfAboWorkFlow</td>
<td valign=top>int</td>
<td valign=top>Standard-Workflow</td>
</tr>
<tr>
<td valign=top>gAFAboRepeat</td>
<td valign=top>logic</td>
<td valign=top>Wiederholendes Abonnement</td>
</tr>
<tr>
<td valign=top>gAFAboMaxRepeats</td>
<td valign=top>int</td>
<td valign=top>Anzahl der Wiederholungen</td>
</tr>

</table></td>
</tr>

<tr class="ProcResultItem">
<td width="15%" class=Left>Resultat</td>
<td width="15%" class=Right>int</td>
<td width="70%" class=Right colspan="2">Fehlerwert</td>
</tr>

<tr>
<td width="15%" class=Left>Siehe</td>
<td width="85%" class=Right colspan="3">
[[AFAboEdit|AfAboEdit()]], [[AFAboDelete|AfAboDelete()]]
</td>
</tr>

</table>
</td>
</tr>
</table>
<div class="BigLang">
Die Funktion erstellt ein Abonnement bei dem übergebenen Objekt. Der Objekt-Typ wird in (int1) übergeben. Folgende Typen können angegeben werden:

<table class=lang>
<tr>
<td valign=top>Konstante</td>
<td valign=top><center>Wert</center></td>
<td valign=top>Beschreibung</td>
</tr>
<tr>
<td valign=top>sAfAboTypeAbm</td>
<td valign=top><center>ABM</center></td>
<td valign=top>Arbeitsmappe</td>
</tr>
<tr>
<td valign=top>sAfAboTypeArc</td>
<td valign=top><center>ARC</center></td>
<td valign=top>Archiv</td>
</tr>
<tr>
<td valign=top>sAfAboTypeAnh</td>
<td valign=top><center>ANH</center></td>
<td valign=top>Anhangdatei</td>
</tr>
</table>

Soll das Abonnement einer Arbeitsmappe zugewiesen werden, muss in (alpha2) die in eine Zeichenkette gewandelte Id (siehe CnvAI()) der Arbeitsmappe angegeben werden. Beim Erstellen eines Abonnements für ein Archiv oder für eine Anhangdatei, werden in (alpha2) die Archivnummer und gegebenenfalls in (int4) die Nummer der Anhangdatei angegeben. Die weiteren Informationen zum Abonnement müssen in den folgenden globalen Variablen vor dem Aufrufen der Anweisung geschrieben werden.

<table class=lang>
<tr>
<td valign=top>gAFAboSendType</td>
<td valign=top>int</td>
<td valign=top>Benachrichtigungstyp</td>
</tr>
<tr>
<td valign=top>gAFAboName</td>
<td valign=top>alpha(250)</td>
<td valign=top>Bezeichnung</td>
</tr>
<tr>
<td valign=top>gAFAboNote</td>
<td valign=top>alpha(4096)</td>
<td valign=top>Beschreibung</td>
</tr>
<tr>
<td valign=top>gAFAboNotifications</td>
<td valign=top>int</td>
<td valign=top>Auslöser der Benachrichtigung</td>
</tr>
<tr>
<td valign=top>gAFAboOwner</td>
<td valign=top>alpha(25)</td>
<td valign=top>Ersteller</td>
</tr>
<tr>
<td valign=top>gAfAboWorkFlow</td>
<td valign=top>int</td>
<td valign=top>Standard-Workflow</td>
</tr>
<tr>
<td valign=top>gAFAboRepeat</td>
<td valign=top>logic</td>
<td valign=top>Wiederholendes Abonnement</td>
</tr>
<tr>
<td valign=top>gAFAboMaxRepeats</td>
<td valign=top>int</td>
<td valign=top>Anzahl der Wiederholungen</td>
</tr>
</table>

{{Info|Die Variablen <code>gAfAboId</code>, <code>gAfAboObjectType</code> und <code>gAfAboObject</code> werden durch die Übergabeparameter überschrieben.}}

In der Variablen gAfAboSendType wird der Benachrichtigungstyp angegeben. Es stehen folgende Konstanten zur Verfügung:

<table class=lang>
<tr>
<td valign=top>Konstante</td>
<td valign=top>Wert</td>
<td valign=top>Beschreibung</td>
</tr>
<tr>
<td valign=top>sAfSendTypeMail</td>
<td valign=top><center>1</center></td>
<td valign=top>Benachrichtigung per Mail</td>
</tr>
<tr>
<td valign=top>sAfSendTypeDlg</td>
<td valign=top><center>2</center></td>
<td valign=top>Benachrichtigung per Dialog beim ArcFlow-Agent</td>
</tr>
<tr>
<td valign=top>sAfSendTypeWfl</td>
<td valign=top><center>4</center></td>
<td valign=top>Starten eines Workflows</td>
</tr>
</table>

Die Konstanten sAfSendTypeMail und sAfSendTypeDlg können miteinander kombiniert werden. Wird ein Workflow gestartet, erfolgt keine Benachrichtigung vom Abonnement, sondern von den einzelnen Workflow-Schritten.

Im Feldpuffer gAfAboNotifications werden die Ereignisse angegeben, die zu einer Auslösung des Abonnements führen. Es kann eine Kombination aus folgenden Konstanten angegeben werden:

<table class=lang>
<tr>
<td valign=top>Konstante</td>
<td valign=top>Wert</td>
<td valign=top>Arbeitsmappe</td>
<td valign=top>Archiv</td>
<td valign=top>Anhangdatei</td>
<td valign=top>Beschreibung</td>
</tr>
<tr>
<td valign=top>sAfAboAnhCreate</td>
<td valign=top>0x00000001</td>
<td valign=top></td>
<td valign=top><center>X</center></td>
<td valign=top></td>
<td valign=top>Anhangdatei anlegen</td>
</tr>
<tr>
<td valign=top>sAfAboAnhEdit</td>
<td valign=top>0x00000002</td>
<td valign=top></td>
<td valign=top><center>X</center></td>
<td valign=top><center>X</center></td>
<td valign=top>Anhangdatei ändern</td>
</tr>
<tr>
<td valign=top>sAfAboAnhDelete</td>
<td valign=top>0x00000004</td>
<td valign=top></td>
<td valign=top><center>X</center></td>
<td valign=top><center>X</center></td>
<td valign=top>Anhangdatei löschen</td>
</tr>
<tr>
<td valign=top>sAfAboArcCreate</td>
<td valign=top>0x00000010</td>
<td valign=top><center>X</center></td>
<td valign=top></td>
<td valign=top></td>
<td valign=top>Archiv anlegen</td>
</tr>
<tr>
<td valign=top>sAfAboArcEdit</td>
<td valign=top>0x00000020</td>
<td valign=top><center>X</center></td>
<td valign=top><center>X</center></td>
<td valign=top></td>
<td valign=top>Archiv ändern</td>
</tr>
<tr>
<td valign=top>sAfAboArcDelete</td>
<td valign=top>0x00000040</td>
<td valign=top><center>X</center></td>
<td valign=top><center>X</center></td>
<td valign=top></td>
<td valign=top>Archiv löschen</td>
</tr>
<tr>
<td valign=top>sAfAboAbmCreate</td>
<td valign=top>0x00000100</td>
<td valign=top><center>X</center></td>
<td valign=top></td>
<td valign=top></td>
<td valign=top>untergeordnete Arbeitsmappe anlegen</td>
</tr>
<tr>
<td valign=top>sAfAboAbmEdit</td>
<td valign=top>0x00000200</td>
<td valign=top><center>X</center></td>
<td valign=top></td>
<td valign=top></td>
<td valign=top>untergeordnete Arbeitsmappe ändern</td>
</tr>
<tr>
<td valign=top>sAfAboAbmDelete</td>
<td valign=top>0x00000400</td>
<td valign=top><center>X</center></td>
<td valign=top></td>
<td valign=top></td>
<td valign=top>untergeordnete Arbeitsmappe löschen</td>
</tr>
<tr>
<td valign=top>sAfAboAbmSelfEdit</td>
<td valign=top>0x00002000</td>
<td valign=top><center>X</center></td>
<td valign=top></td>
<td valign=top></td>
<td valign=top>eigene Arbeitsmappe ändern</td>
</tr>
<tr>
<td valign=top>sAfAboAbmSelfDelete</td>
<td valign=top>0x00004000</td>
<td valign=top><center>X</center></td>
<td valign=top></td>
<td valign=top></td>
<td valign=top>eigene Arbeitsmappe löschen</td>
</tr>

<tr>
<td valign=top>sAfAboAbmLinkEdit</td>
<td valign=top>0x00020000</td>
<td valign=top><center>X</center></td>
<td valign=top></td>
<td valign=top></td>
<td valign=top>Mappenverknüpfung ändern</td>
</tr>

</table>

Nicht alle Kombinationen sind zulässig. Die Auslöser müssen zum angegebenen Objekt passen. Bei einer ungültigen Kombination gibt die Anweisung den Fehlerwert _ErrValueInvalid zurück.

Beispiel:


In diesem Beispiel wird ein Abonnement zur Überwachung einer Anhangdatei eingerichtet. Über weitere Anweisungen wird der zu benachrichtigende Benutzer und das Zeitintervall definiert. In diesem Beispiel wird der Sachbearbeiter Dieter Staub (DST) bei Änderungen an der Anhangdatei am nachfolgenden Montag benachrichtigt.

<pre class=source>
gAfAboSendType # sAfSendTypeMail;
gAfAboName # 'Benachrichtigung bei Veränderung der Anhangdatei';
gAfAboNote # '';
gAfAboNotifications # sAfAboAnhEdit | sAfAboAnhDelete;
tResult # AfAboCreate(sAfAboTypeAnh, gAfArcNr, var tAboNo, gAfArcFileNr);
...
tResult # AfAboUserAdd(tAboNo, sAfAboUserTypeSab, 'DST');
...
gAfAboTimeNotifyTime # 11:00;
gAfAboTimeNotifyWeekDay # sAfWeekdayMonday;
tResult # AfAboTimeAdd(tAboNo, sAfCheckWeekly);
...
</pre>


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

<table class=lang>
<tr>
<td>Konstante</td>
<td align=center width=80>Wert</td>
<td>Bedeutung</td>
</tr>
<tr class="ProcErrorItem">
<td class=source valign=top>_ErrOk</td>
<td align=center valign=top>0</td>
<td>ok - kein Fehler aufgetreten</td>
</tr>

<tr class="ProcErrorItem">
<td class=source valign=top>_ErrValueInvalid</td>
<td align=center valign=top>-188</td>
<td>Der in (int1) übergebene Typ oder die Auslöser in gAfAboNotifications ist ungültig.</td>
</tr>

</table>

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

</div>
[[Category:Befehle für Abonnements]]
[[Category:ListeAllerApiBefehleA]]