AfArcFileLstGet - Versionsgeschichte

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

2026-01-21T10:49:05Z

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

← Nächstältere Version		Version vom 21. Januar 2026, 10:49 Uhr
Zeile 8:		Zeile 8:
	<td class="title"> AfArcFileLstGet(alpha1, int2[, logic3]) : int</td>		<td class="title"> AfArcFileLstGet(alpha1, int2[, logic3]) : int</td>
	<td class="platforms">		<td class="platforms">
	[[file:DE_SymbolAPI.gif\|alt=Ausführbar von der API\|link=Befehle der Schnittstellen]][[file:DE_SymbolDLL.gif\|alt=Ausführbar von der Programmierschnittstelle\|link=Befehle der Schnittstellen]][[file:DE_SymbolARC.gif\|alt=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_SymbolDLL.gif\|alt=Ausführbar von der Programmierschnittstelle (DLL)\|link=Befehle der Schnittstellen\|Ausführbar von der Programmierschnittstelle (DLL)]][[file:DE_SymbolARC.gif\|alt=Ausführbar mit der Application Remote Control\|link=Befehle der Schnittstellen\|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 62:		Zeile 62:
	<p>{{Info\|Wird ein ungültiger Deskriptor übergeben, kommt es zu einem Laufzeitfehler.}}</p></p>		<p>{{Info\|Wird ein ungültiger Deskriptor übergeben, kommt es zu einem Laufzeitfehler.}}</p></p>

	== ~~Beispiel~~ ==		== Beispiele ==

	<tabber>		<tabber>
Zeile 96:		Zeile 96:
	return(_ErrOk);		return(_ErrOk);
	</pre>		</pre>
	~~</tabber>~~		\|-\|ArcFlowRemoteControl=
			<pre class=source>
	~~<p><p>Bei der Verwendung mit der~~		af_rmtcontrol.exe /user=admin /password=troja /action=fnc /fnc=AFArcFileLstGet /ArcNr=2008.0000012 /ExtendedPara=1 /RsltPath=c:\temp\AFAPIRES.TXT
	~~[[Application Remote Control (ARC)#~~\|~~Application Remote Control]]~~		</pre>
	~~werden die Parameter mit folgenden Namen übergeben:</p>~~		In der Ergebnisdatei wird in der ersten Zeile die übergebene Anweisung geschrieben. In der zweiten Zeile wird der Rückgabewert der Funktion gespeichert.In den folgenden Zeilen werden je Zeile der Name einer Anhangdatei geschrieben. Werden die erweiterten Daten ermittelt, stehen die zusätzlichen Informationen in der gleichen Zeile durch <font class=source>#</font> getrennt.
			\|-\|ArcFlow.NEXT=
	~~<table class~~=~~lang>~~		<pre class=source>
	<~~tr>~~
	~~<td valign=top><font~~ class=source>/~~ArcNr<~~/~~font><~~/~~td>~~
	~~<td valign~~=~~top>Nummer des Archivs<~~/~~td>~~
	</~~tr>~~
	~~<tr>~~
	~~<td valign~~=~~top><font class=source>~~/ExtendedPara</~~font></td>~~
	~~<td valign~~=~~top>Erweiterte Daten ermitteln</td>~~
	</tr>
	~~<tr>~~
	~~<td valign=top>~~<font class=source>~~/RsltPath~~</font>~~</td>~~
	~~<td valign~~=~~top>Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird.</td>~~
	<~~/tr~~>
	~~</table>~~

	~~<!--~~
	af.next.AfArcFileLstGet('2024.0001234', false).then(result => {		af.next.AfArcFileLstGet('2024.0001234', false).then(result => {
	if (result.code == af.next.constants.AfErrOk) {		if (result.code == af.next.constants.AfErrOk) {
Zeile 125:		Zeile 110:
	}		}
	});		});
			</pre>
			Ausgabe:
			<pre class=source>
	afArcFileCheckoutUser: ""		afArcFileCheckoutUser: ""
	afArcFileDescr: ""		afArcFileDescr: ""
Zeile 137:		Zeile 124:
	afArcFileState: 0		afArcFileState: 0
	afArcFileType: "ZIP"		afArcFileType: "ZIP"
	-->		</pre>
	<~~p>Zum Beispiel:<br~~>		</tabber>
	<~~font class=source~~>~~/user=admin /password=troja /action=fnc /fnc=AFArcFileLstGet /ArcNr=2008.0000012 /ExtendedPara=1 /RsltPath=c~~:~~\temp\AFAPIRES.TXT</font>~~</p>
			<p>Bei der Verwendung mit der [[Application Remote Control (ARC)#\|Application Remote Control]] werden die Parameter mit folgenden Namen übergeben:</p>

	<p>~~In der Ergebnisdatei wird in der ersten Zeile die übergebene Anweisung~~		<table class=lang>
	~~geschrieben. In der zweiten Zeile wird der Rückgabewert der Funktion gespeichert.In~~		<tr>
	~~den folgenden Zeilen werden je Zeile der Name einer Anhangdatei geschrieben. Werden die erweiterten~~ Daten ~~ermittelt, stehen die zusätzlichen Informationen in der gleichen Zeile durch~~ <font class=source>#</font> ~~getrennt~~.</p></p>		<td valign=top><font class=source>/ArcNr</font></td>
			<td valign=top>Nummer des Archivs</td>
			</tr>
			<tr>
			<td valign=top><font class=source>/ExtendedPara</font></td>
			<td valign=top>Erweiterte Daten ermitteln</td>
			</tr>
			<tr>
			<td valign=top><font class=source>/RsltPath</font></td>
			<td valign=top>Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird.</td>
			</tr>
			</table>

	<p>		<p>
	Neben den [[Allgemeine Fehlercodes#\|allgemeinen Fehlerwerten]]		Neben den [[Allgemeine Fehlercodes#\|allgemeinen Fehlerwerten]] können folgende Werte zurückgegeben werden:
	können folgende Werte zurückgegeben werden:
	</p><p>		</p><p>
	<table class=lang>		<table class=lang>

Jens: /* Beispiel */

2025-07-24T12:04:28Z

Beispiel

← Nächstältere Version		Version vom 24. Juli 2025, 12:04 Uhr
Zeile 73:		Zeile 73:
	// Error handling for AfCteOpen()		// Error handling for AfCteOpen()
	AfAddLogEntry(_LogError, 'Archivanhangliste konnte nicht angelegt werden.', CnvAI(tArcFileList));		AfAddLogEntry(_LogError, 'Archivanhangliste konnte nicht angelegt werden.', CnvAI(tArcFileList));
	return(~~tArcFileList~~);		return(_ErrGeneric);
	}		}

Jens: Stand 4.1.12 Beispiel SkriptAPI hinzugefügt

2025-07-24T12:03:16Z

Stand 4.1.12 Beispiel SkriptAPI hinzugefügt

← Nächstältere Version		Version vom 24. Juli 2025, 12:03 Uhr
Zeile 61:		Zeile 61:

	<p>{{Info\|Wird ein ungültiger Deskriptor übergeben, kommt es zu einem Laufzeitfehler.}}</p></p>		<p>{{Info\|Wird ein ungültiger Deskriptor übergeben, kommt es zu einem Laufzeitfehler.}}</p></p>

			== Beispiel ==

			<tabber>
			\|-\|ScriptAPI=
			<pre class=source>
			// leere Liste anlegen
			tArcFileList # AfCteOpen(_CteList);
			if (tArcFileList <= 0)
			{
			// Error handling for AfCteOpen()
			AfAddLogEntry(_LogError, 'Archivanhangliste konnte nicht angelegt werden.', CnvAI(tArcFileList));
			return(tArcFileList);
			}

			tResult # AFArcFileLstGet(tArcNo,tArcFileList);
			if (tResult != _ErrOk)
			{
			// Error handling AFAbmArcLstGet()
			AfAddLogEntry(_LogError, 'Fehler beim Ermitteln der Anhangdateiliste.', CnvAI(tResult), tArcNo);
			tArcFileList->AFCteCloseAll();
			return(tResult);
			}

			// Alle Anhangdateien durchsuchen
			for tArcFileItem # tArcFileList->CteRead(_CteFirst);
			loop tArcFileItem # tArcFileList->CteRead(_CteNext,tArcFileItem);
			while (tArcFileItem > 0)
			{
			// Anhangdatei lesen
			tResult # AfArcFileRead(tArcNo, CnvIA(tArcFileItem->spName));
			...
			}
			return(_ErrOk);
			</pre>
			</tabber>

	<p><p>Bei der Verwendung mit der		<p><p>Bei der Verwendung mit der

Jens: Stand 4.1.09 Beispiel ArcFlow.NEXT vorbereitet

2024-11-21T12:09:10Z

Stand 4.1.09 Beispiel ArcFlow.NEXT vorbereitet

@@ Zeile 81: / Zeile 81: @@
 </table>
 <p>Zum Beispiel:<br>
 <font class=source>/user=admin /password=troja /action=fnc /fnc=AFArcFileLstGet /ArcNr=2008.0000012 /ExtendedPara=1 /RsltPath=c:\temp\AFAPIRES.TXT</font></p>

Jens: Stand 4.1.09

2024-10-29T10:21:14Z

Stand 4.1.09

← Nächstältere Version		Version vom 29. Oktober 2024, 10:21 Uhr
Zeile 6:		Zeile 6:
	</tr>		</tr>
	<tr class="ProcSyntax">		<tr class="ProcSyntax">
	<td class="title"> ~~AFArcFileLstGet~~(alpha1, int2[, logic3]) : int</td>		<td class="title"> AfArcFileLstGet(alpha1, int2[, logic3]) : int</td>
	<td class="platforms">		<td class="platforms">
	[[file:DE_SymbolAPI.gif\|alt=Ausführbar von der API\|link=Befehle der Schnittstellen]][[file:DE_SymbolDLL.gif\|alt=Ausführbar von der Programmierschnittstelle\|link=Befehle der Schnittstellen]][[file:DE_SymbolARC.gif\|alt=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_SymbolDLL.gif\|alt=Ausführbar von der Programmierschnittstelle\|link=Befehle der Schnittstellen]][[file:DE_SymbolARC.gif\|alt=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 46:		Zeile 46:
	<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]],
	[[~~AFArcFileVerLstGet~~#\|~~AFArcFileVerLstGet~~()]]		[[AfArcFileVerLstGet#\|AfArcFileVerLstGet()]]
	</td>		</td>
	</tr>		</tr>
Zeile 56:		Zeile 56:
	</table>		</table>
	<div class="BigLang">		<div class="BigLang">
	<p><p>Mit der Funktion lassen sich alle Anhangdateien{{Marker}}<!--Anhagdatei--> des in (alpha1) übergebenen Archivs ermitteln. Im zweiten Parameter muss der Deskriptor einer leeren Cte-Liste übergeben werden, die vor dem Aufruf der Funktion über den Befehl [[~~AFCteOpen~~#\|AfCteOpen()]] angelegt wurde.</p>		<p><p>Mit der Funktion lassen sich alle Anhangdateien{{Marker}}<!--Anhagdatei--> des in (alpha1) übergebenen Archivs ermitteln. Im zweiten Parameter muss der Deskriptor einer leeren Cte-Liste übergeben werden, die vor dem Aufruf der Funktion über den Befehl [[AfCteOpen#\|AfCteOpen()]] angelegt wurde.</p>

	<p>Nach dem Aufruf der Funktion ist pro Anhangdatei ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen werden und über die Eigenschaft "Name" die Anhang-Nummer und über die Eigenschaft "Custom" der Original-Dateiname ausgelesen werden. Wurde in (logic3) <font class=source>true</font> übergeben, befindet sich in der "Custom"-Eigenschaft neben dem Dateinamen noch die Größe der Originaldatei (in Byte) sowie das Datum (im Format yyyy-mm-dd) und die Uhrzeit der letzten Änderung. Die Informationen sind durch das Zeichen <font class=source>#</font> getrennt.</p>		<p>Nach dem Aufruf der Funktion ist pro Anhangdatei ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen werden und über die Eigenschaft "Name" die Anhang-Nummer und über die Eigenschaft "Custom" der Original-Dateiname ausgelesen werden. Wurde in (logic3) <font class=source>true</font> übergeben, befindet sich in der "Custom"-Eigenschaft neben dem Dateinamen noch die Größe der Originaldatei (in Byte) sowie das Datum (im Format yyyy-mm-dd) und die Uhrzeit der letzten Änderung. Die Informationen sind durch das Zeichen <font class=source>#</font> getrennt.</p>

Jens: Jens verschob die Seite AFArcFileLstGet nach AfArcFileLstGet, ohne dabei eine Weiterleitung anzulegen

2024-10-29T10:18:34Z

Jens verschob die Seite AFArcFileLstGet nach AfArcFileLstGet, ohne dabei eine Weiterleitung anzulegen

← Nächstältere Version		Version vom 29. Oktober 2024, 10:18 Uhr
(kein Unterschied)

Afwiki: Stand 4.1.08 Buchstaben Kategorie entfernt

2023-11-22T12:56:29Z

Stand 4.1.08 Buchstaben Kategorie entfernt

← Nächstältere Version		Version vom 22. November 2023, 12:56 Uhr
Zeile 133:		Zeile 133:
	</translate>		</translate>
	[[Category:Befehle für Archive]]		[[Category:Befehle für Archive]]
	~~[[Category:ListeAllerApiBefehleA]]~~

Jens: Stand 4.1.08

2023-11-08T13:18:52Z

Stand 4.1.08

← Nächstältere Version		Version vom 8. November 2023, 13:18 Uhr
Zeile 45:		Zeile 45:
	<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]],
	[[AFArcFileVerLstGet#\|AFArcFileVerLstGet()]]		[[AFArcFileVerLstGet#\|AFArcFileVerLstGet()]]
	</td>		</td>

AfWikiBot: Die Seite wurde neu angelegt: „
2020-08-19T14:50:18Z
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"> AFArcFileLstGet(alpha1, int2[, logic3]) : int</td>
<td class="platforms">
[[file:DE_SymbolAPI.gif|alt=Ausführbar von der API|link=Befehle der Schnittstellen]][[file:DE_SymbolDLL.gif|alt=Ausführbar von der Programmierschnittstelle|link=Befehle der Schnittstellen]][[file:DE_SymbolARC.gif|alt=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">Liste der Anhangdateien zu einem Archiv</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>Nummer des Archives</td>
</tr>

<tr class="ProcParameterItem">
<td valign=top width="15%" class=Left>int2</td>
<td colspan="3" width="85%" class=Right>Deskriptor einer leeren Cte-Liste</td>
</tr>

<tr class="ProcParameterItem">
<td valign=top width="15%" class=Left>logic3</td>
<td colspan="3" width="85%" class=Right>Erweiterte Informationen</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]],
[[AFArcFileVerLstGet#|AFArcFileVerLstGet()]]
</td>
</tr>

</table>
</td>
</tr>
</table>
<div class="BigLang">
<p><p>Mit der Funktion lassen sich alle Anhangdateien{{Marker}} des in (alpha1) übergebenen Archivs ermitteln. Im zweiten Parameter muss der Deskriptor einer leeren Cte-Liste übergeben werden, die vor dem Aufruf der Funktion über den Befehl [[AFCteOpen#|AfCteOpen()]] angelegt wurde.</p>

<p>Nach dem Aufruf der Funktion ist pro Anhangdatei ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen werden und über die Eigenschaft "Name" die Anhang-Nummer und über die Eigenschaft "Custom" der Original-Dateiname ausgelesen werden. Wurde in (logic3) <font class=source>true</font> übergeben, befindet sich in der "Custom"-Eigenschaft neben dem Dateinamen noch die Größe der Originaldatei (in Byte) sowie das Datum (im Format yyyy-mm-dd) und die Uhrzeit der letzten Änderung. Die Informationen sind durch das Zeichen <font class=source>#</font> getrennt.</p>

<p>{{Info|Wird ein ungültiger Deskriptor übergeben, kommt es zu einem Laufzeitfehler.}}</p></p>

<p><p>Bei der Verwendung mit der
[[Application Remote Control (ARC)#|Application Remote Control]]
werden die Parameter mit folgenden Namen übergeben:</p>

<table class=lang>
<tr>
<td valign=top><font class=source>/ArcNr</font></td>
<td valign=top>Nummer des Archivs</td>
</tr>
<tr>
<td valign=top><font class=source>/ExtendedPara</font></td>
<td valign=top>Erweiterte Daten ermitteln</td>
</tr>
<tr>
<td valign=top><font class=source>/RsltPath</font></td>
<td valign=top>Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird.</td>
</tr>
</table>

<p>Zum Beispiel:<br>
<font class=source>/user=admin /password=troja /action=fnc /fnc=AFArcFileLstGet /ArcNr=2008.0000012 /ExtendedPara=1 /RsltPath=c:\temp\AFAPIRES.TXT</font></p>

<p>In der Ergebnisdatei wird in der ersten Zeile die übergebene Anweisung
geschrieben. In der zweiten Zeile wird der Rückgabewert der Funktion gespeichert.In
den folgenden Zeilen werden je Zeile der Name einer Anhangdatei geschrieben. Werden die erweiterten Daten ermittelt, stehen die zusätzlichen Informationen in der gleichen Zeile durch <font class=source>#</font> getrennt.</p></p>

<p>
Neben den [[Allgemeine Fehlercodes#|allgemeinen Fehlerwerten]]
können folgende Werte zurückgegeben werden:
</p><p>
<table class=lang>
<tr>
<td><b>Konstante</b></td>
<td align=center width=80><b>Wert</b></td>
<td><b>Bedeutung</b></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>_rNoRec</td>
<td align=center valign=top>5</td>
<td>Es existiert kein Archiv mit der in (alpha1) angegebenen Nummer</td>
</tr>

<tr class="ProcErrorItem">
<td class=source valign=top>sAfErrItemLimit</td>
<td align=center valign=top>-20015</td>
<td>Die maximale Anzahl an übertragbaren Elementen (ca. 5000) wurde überschritten</td>
</tr>

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

</table>
</p><p>
Für weitere CONZEPT 16-spezifische Rückgabewerte siehe die aktuelle CONZEPT 16-Hilfe.
</p>
</div>
</translate>
[[Category:Befehle für Archive]]
[[Category:ListeAllerApiBefehleA]]

file:DE_Schriftzug.gif