AfArcReadCustomFld - Versionsgeschichte

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

2026-02-04T09:44:35Z

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

← Nächstältere Version		Version vom 4. Februar 2026, 09:44 Uhr
Zeile 8:		Zeile 8:
	<td class="title"> AfArcReadCustomFld(alpha1, alpha2, int3[, alpha4]) : int</td>		<td class="title"> AfArcReadCustomFld(alpha1, alpha2, int3[, alpha4]) : int</td>
	<td class="platforms">		<td class="platforms">
	[[file:DE_SymbolAPI.gif\|alt=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]]		[[file:DE_SymbolAPI.gif\|alt=Ausführbar von der API\|link=Befehle der Schnittstellen\|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>		</td>
	</tr>		</tr>
Zeile 236:		Zeile 236:
	<p>{{Info\|Bei Kombinationen mit der Leseoption <code>_RecFirst</code>, <code>_RecPrev</code>, <code>_RecNext</code> oder <code>_RecLast</code> wird nicht der Fehler <code>_rNoRec</code> zurückgegeben, wenn kein Archiv mit dem angegebenen Inhalt gefunden wurde. Statt dessen wird das Archiv gelesen, bei dem das Zusatzfeld gesetzt ist und der entsprechenden Position in der Sortierung entspricht.}}</p></p>		<p>{{Info\|Bei Kombinationen mit der Leseoption <code>_RecFirst</code>, <code>_RecPrev</code>, <code>_RecNext</code> oder <code>_RecLast</code> wird nicht der Fehler <code>_rNoRec</code> zurückgegeben, wenn kein Archiv mit dem angegebenen Inhalt gefunden wurde. Statt dessen wird das Archiv gelesen, bei dem das Zusatzfeld gesetzt ist und der entsprechenden Position in der Sortierung entspricht.}}</p></p>

	~~<p><b>~~Beispiele~~</b>{{Marker}}~~		== Beispiele ==
	~~</p><p>~~

			<tabber>
			\|-\|ScriptAPI=
	<pre class=source>		<pre class=source>
	// Read all archives of one type		// Read all archives of one type
Zeile 248:		Zeile 249:
	}		}
	</pre>		</pre>

	<pre class=source>		<pre class=source>
	tErr # AfArcReadCustomFld('ArchiveType', 'zzz', _RecFirst);		tErr # AfArcReadCustomFld('ArchiveType', 'zzz', _RecFirst);
Zeile 258:		Zeile 258:
	// same as AfArcReadCustomFld('ArchiveType', '', _RecFirst);		// same as AfArcReadCustomFld('ArchiveType', '', _RecFirst);
	}		}
	</pre></p>		</pre>
			\|-\|ArcFlowAPI=
			<pre class=source>
			// Read all archives of one type
			for tErr # AF.API:AfArcReadCustomFld('ArchiveType', 'Invoice', 0);
			loop tErr # AF.API:AfArcReadCustomFld('ArchiveType', 'Invoice', _RecNext, gArcNr);
			while (tErr = _rOk)
			{
			...
			}
			</pre>
			<pre class=source>
			tErr # AF.API:AfArcReadCustomFld('ArchiveType', 'zzz', _RecFirst);
			if (tErr = _rOk)
			{
			// Archive with value "zzz" in custom field
			// or
			// Archive with lowest value in custom field
			// same as AfArcReadCustomFld('ArchiveType', '', _RecFirst);
			}
			</pre>
			</tabber>

	<p>		<p>

Jens: Stand 4.1.09

2024-10-30T07:52:31Z

Stand 4.1.09

← Nächstältere Version		Version vom 30. Oktober 2024, 07:52 Uhr
Zeile 6:		Zeile 6:
	</tr>		</tr>
	<tr class="ProcSyntax">		<tr class="ProcSyntax">
	<td class="title"> ~~AFArcReadCustomFld~~(alpha1, alpha2, int3[, alpha4]) : int</td>		<td class="title"> AfArcReadCustomFld(alpha1, alpha2, int3[, alpha4]) : int</td>
	<td class="platforms">		<td class="platforms">
	[[file:DE_SymbolAPI.gif\|alt=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]]		[[file:DE_SymbolAPI.gif\|alt=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]]
Zeile 165:		Zeile 165:
	<td width="85%" class=Right colspan="3">		<td width="85%" class=Right colspan="3">
	[[:Category:Befehle für Archive\|Verwandte Befehle]],		[[:Category:Befehle für Archive\|Verwandte Befehle]],
	[[~~AFArcRead~~#\|~~AFArcRead~~()]]		[[AfArcRead#\|AfArcRead()]]
	</td>		</td>
	</tr>		</tr>
Zeile 241:		Zeile 241:
	<pre class=source>		<pre class=source>
	// Read all archives of one type		// Read all archives of one type
	for tErr # ~~AFArcReadCustomFld~~('ArchiveType', 'Invoice', 0);		for tErr # AfArcReadCustomFld('ArchiveType', 'Invoice', 0);
	loop tErr # ~~AFArcReadCustomFld~~('ArchiveType', 'Invoice', _RecNext, gAFArcNr);		loop tErr # AfArcReadCustomFld('ArchiveType', 'Invoice', _RecNext, gAFArcNr);
	while (tErr = _rOk)		while (tErr = _rOk)
	{		{

Jens: Jens verschob die Seite AFArcReadCustomFld nach AfArcReadCustomFld, ohne dabei eine Weiterleitung anzulegen

2024-10-30T07:45:23Z

Jens verschob die Seite AFArcReadCustomFld nach AfArcReadCustomFld, ohne dabei eine Weiterleitung anzulegen

← Nächstältere Version		Version vom 30. Oktober 2024, 07:45 Uhr
(kein Unterschied)

Jens: Stand 4.1.08

2023-11-08T14:00:08Z

Stand 4.1.08

← Nächstältere Version		Version vom 8. November 2023, 14:00 Uhr
Zeile 164:		Zeile 164:
	<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">
	[[Befehle für Archive#\|Verwandte Befehle]],		[[:Category:Befehle für Archive\|Verwandte Befehle]],
	[[AFArcRead#\|AFArcRead()]]		[[AFArcRead#\|AFArcRead()]]
	</td>		</td>
Zeile 327:		Zeile 327:
	</translate>		</translate>
	[[Category:Befehle für Archive]]		[[Category:Befehle für Archive]]
	~~[[Category:ListeAllerApiBefehleA]]~~

Jens am 26. Oktober 2023 um 07:59 Uhr

2023-10-26T07:59:04Z

Änderungen zeigen

AfWikiBot: Die Seite wurde neu angelegt: „
2020-08-19T14:36:14Z
Die Seite wurde neu angelegt: „<languages /> <translate> <table class=head> <tr> <td class="BigTitle" colspan="2" align="center">file:DE_Schriftzug.gif</td> </tr> <tr clas…“
Neue Seite
<languages />
<translate>
<table class=head>
<tr>
<td class="BigTitle" colspan="2" align="center">[[file:DE_Schriftzug.gif]]</td>
</tr>
<tr class="ProcSyntax">
<td class="title"> AFArcReadCustomFld(alpha1, alpha2, int3[, alpha4]) : int</td>
<td class="platforms">
[[file:DE_SymbolAPI.gif|alt=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">Archiv über kundenspezifische Zusatzfelder lesen</td>
</tr>
<tr>
<td width="100%" colspan="2">
<table class="para">
<tr class="ProcParameterItem">
<td valign=top width="15%" class=Left>alpha1</td>
<td colspan="3" width="85%" class=Right>Name des Zusatzfeldes</td>
</tr>

<tr class="ProcParameterItem">
<td valign=top width="15%" class=Left>alpha2</td>
<td colspan="3" width="85%" class=Right>Inhalt des Zusatzfeldes</td>
</tr>

<tr class="ProcParameterItem">
<td valign=top width="15%" class=Left>int3</td>
<td colspan="3" width="85%" class=Right>Leseoptionen:

<table class=lang>

<tr>
<td valign=top>_RecFirst
</td>
<td valign=top>erstes Archiv lesen
</td>
</tr>
<tr>
<td valign=top>_RecPrev
</td>
<td valign=top>vorheriges Archiv lesen
</td>
</tr>
<tr>
<td valign=top>_RecNext
</td>
<td valign=top>nächstes Archiv lesen
</td>
</tr>
<tr>
<td valign=top>_RecLast
</td>
<td valign=top>letztes Archiv lesen
</td>
</tr>
<tr>
<td valign=top>_RecLock
</td>
<td valign=top>Archiv sperren
</td>
</tr>
<tr>
<td valign=top>_RecUnlock
</td>
<td valign=top>Archiv entsperren
</td>
</tr>

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

<tr class="ProcParameterItem">
<td valign=top width="15%" class=Left>alpha4</td>
<td colspan="3" width="85%" class=Right>Startarchiv (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>gAfArcNr
</td>
<td valign=top>alpha
</td>
<td valign=top>Nummer des Archives
</td>
</tr>
<tr>
<td valign=top>gAfArcDocDate
</td>
<td valign=top>date
</td>
<td valign=top>Dokumentdatum
</td>
</tr>
<tr>
<td valign=top>gAfArcScanDate
</td>
<td valign=top>date
</td>
<td valign=top>Scandatum
</td>
</tr>
<tr>
<td valign=top>gAfArcCreateModul
</td>
<td valign=top>alpha
</td>
<td valign=top>Erstell-Modul
</td>
</tr>
<tr>
<td valign=top>gAfArcTypeString
</td>
<td valign=top>alpha
</td>
<td valign=top>Dateitypen
</td>
</tr>
<tr>
<td valign=top>gAfArcFilesCnt
</td>
<td valign=top>int
</td>
<td valign=top>Anzahl der Anhangdateien
</td>
</tr>
<tr>
<td valign=top>gAfArcScanFileCnt
</td>
<td valign=top>int
</td>
<td valign=top>Anzahl der Scanseiten
</td>
</tr>
<tr>
<td valign=top>gAfArcFileSize
</td>
<td valign=top>int
</td>
<td valign=top>Archivgröße (in KB)
</td>
</tr>
<tr>
<td valign=top>gAfArcStorageYears
</td>
<td valign=top>int
</td>
<td valign=top>Aufbewahrungsfrist (in Jahren)
</td>
</tr>
<tr>
<td valign=top>gAfArcCaption
</td>
<td valign=top>alpha
</td>
<td valign=top>Beschreibung
</td>
</tr>
<tr>
<td valign=top>gAfArcLocation
</td>
<td valign=top>alpha
</td>
<td valign=top>Standort
</td>
</tr>
<tr>
<td valign=top>gAfArcInvisible
</td>
<td valign=top>logic
</td>
<td valign=top>Archiv nicht sichtbar
</td>
</tr>
<tr>
<td valign=top>gAfArcCustomFld
</td>
<td valign=top>alpha
</td>
<td valign=top>Inhalt des kundenspezifischen Feldes
</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">
[[Befehle für Archive#|Verwandte Befehle]],
[[AFArcRead#|AFArcRead()]]
</td>
</tr>

</table>
</td>
</tr>
</table>
<div class="BigLang">
Die Funktion liest bei Angabe von 0 in (int3) das Archiv, dessen Zusatzfeld (alpha1) mit dem in (alpha2) übergebenen Wert übereinstimmt.

Die Suche nach dem Archiv kann an dem in (alpha4) angegebenen Archiv begonnen werden. Es wird dann ausgehend von dem angegebenen Archiv gesucht.

{{Info|Bei Datums- und Zeitfeldern sind folgende Formate zwingend: YYYY-MM-DD bzw. HH:MM:SS.}}

Über den Parameter (int3) können zudem folgende Leseoptionen übergeben werden:

<table class=lang>

<tr>
<td valign=top>'''Konstante'''
</td>
<td valign=top>'''Funktion'''
</td>
</tr>
<tr>
<td valign=top>_RecFirst
</td>
<td valign=top>Liest das erste Archiv, dessen Zusatzfeld (alpha1) gefüllt ist
</td>
</tr>
<tr>
<td valign=top>_RecPrev
</td>
<td valign=top>Liest das vorherige Archiv, dessen Zusatzfeld (alpha1) gefüllt ist, ausgehend vom übergebenen Archiv
</td>
</tr>
<tr>
<td valign=top>_RecNext
</td>
<td valign=top>Liest das nächste Archiv, dessen Zusatzfeld (alpha1) gefüllt ist, ausgehend vom übergebenen Archiv
</td>
</tr>
<tr>
<td valign=top>_RecLast
</td>
<td valign=top>Liest das letzte Archiv, dessen Zusatzfeld (alpha1) gefüllt ist
</td>
</tr>
<tr>
<td valign=top>_RecLock
</td>
<td valign=top>sperrt das Archiv für exklusiven Zugriff
</td>
</tr>
<tr>
<td valign=top>_RecUnlock
</td>
<td valign=top>entsperrt das Archiv
</td>
</tr>

</table>

Die Lese-Optionen können mit den Sperr-Optionen kombiniert werden.

Nach dem Aufruf der Funktion stehen in den Feldpuffern die Informationen des gelesenen Archivs zur Verfügung.

{{Info|Bei Kombinationen mit der Leseoption _RecFirst, _RecPrev, _RecNext oder _RecLast wird nicht der Fehler _rNoRec zurückgegeben, wenn kein Archiv mit dem angegebenen Inhalt gefunden wurde. Statt dessen wird das Archiv gelesen, bei dem das Zusatzfeld gesetzt ist und der entsprechenden Position in der Sortierung entspricht.}}

Beispiele{{Marker}}


<pre class=source>
// Read all archives of one type
for tErr # AFArcReadCustomFld('ArchiveType', 'Invoice', 0);
loop tErr # AFArcReadCustomFld('ArchiveType', 'Invoice', _RecNext, gAFArcNr);
while (tErr = _rOk)
{
...
}
</pre>

<pre class=source>
tErr # AfArcReadCustomFld('ArchiveType', 'zzz', _RecFirst);
if (tErr = _rOk)
{
// Archive with value "zzz" in custom field
// or
// Archive with lowest value in custom field
// same as AfArcReadCustomFld('ArchiveType', '', _RecFirst);
}
</pre>


Neben den [[Allgemeine Fehlercodes#|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>_rLocked</td>
<td align=center valign=top>1</td>
<td>Das Archiv ist von einem anderen Benutzer gesperrt</td>
</tr>

<tr class="ProcErrorItem">
<td class=source valign=top>_rMultiKey</td>
<td align=center valign=top>2</td>
<td>Es sind mehrere Archive mit den angegebenen Schlüsselwerten vorhanden</td>
</tr>

<tr class="ProcErrorItem">
<td class=source valign=top>_rNoKey</td>
<td align=center valign=top>3</td>
<td>Es existiert kein Archiv mit den angegebenen Kriterien</td>
</tr>

<tr class="ProcErrorItem">
<td class=source valign=top>_rLastRec</td>
<td align=center valign=top>4</td>
<td>Es existiert kein Archiv mit den angegebenen Kriterien</td>
</tr>

<tr class="ProcErrorItem">
<td class=source valign=top>_rNoRec</td>
<td align=center valign=top>5</td>
<td>Das angegebene Archiv existiert nicht</td>
</tr>

<tr class="ProcErrorItem">
<td class=source valign=top>sAfErrNoRights</td>
<td align=center valign=top>-20029</td>
<td>Die Benutzerrechte reichen nicht aus</td>
</tr>

</table>

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

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

file:DE_Schriftzug.gif