AfAbmReadByName - Versionsgeschichte

Jens: Stand 4.1.16 Beispiel ArcFlow.NEXT hinzugefügt

2026-02-13T14:48:41Z

Stand 4.1.16 Beispiel ArcFlow.NEXT hinzugefügt

@@ Zeile 8: / Zeile 8: @@
      <td class="title">&nbsp;AfAbmReadByName(alpha1, int2, int3) : int</td>
      <td class="platforms">
-[[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]]
+[[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]][[file:SymbolNext.gif|alt=Ausführbar von ArcFlow.NEXT|link=Befehle der Schnittstellen|Ausführbar von ArcFlow.NEXT]]
      </td>
    </tr>
@@ Zeile 228: / Zeile 228: @@
 </table>
-== Beispiel ==
+== Beispiele ==
 <tabber>
@@ Zeile 236: / Zeile 236: @@
 </pre>
 <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 wird die Nummer der Arbeitsmappe, der Name der Arbeitsmappe, die Nummer der Elternmappe, Beschreibung, Abschlussvorgabe, die Mappenunterteilung und der Mappentyp gespeichert.</p>
 </tabber>

Jens: Stand 4.1.13 Rückgabewert korrigiert

2026-02-12T13:22:52Z

Stand 4.1.13 Rückgabewert korrigiert

← Nächstältere Version		Version vom 12. Februar 2026, 13:22 Uhr
Zeile 265:		Zeile 265:
	<td class=source valign=top>sAfErrNoRecAbm</td>		<td class=source valign=top>sAfErrNoRecAbm</td>
	<td align=center valign=top>-20026</td>		<td align=center valign=top>-20026</td>
	<td>Die in (~~int1~~) übergebene Arbeitsmappe existiert nicht</td>		<td>Die in (alpha1) übergebene Arbeitsmappe existiert nicht</td>
	</tr>		</tr>

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

2026-01-06T07:30:56Z

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

← Nächstältere Version		Version vom 6. Januar 2026, 07:30 Uhr
Zeile 8:		Zeile 8:
	<td class="title"> AfAbmReadByName(alpha1, int2, int3) : int</td>		<td class="title"> AfAbmReadByName(alpha1, int2, int3) : 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 228:		Zeile 228:
	</table>		</table>

	~~<p>Zum Beispiel: <br>~~		== Beispiel ==
	~~<font class~~=~~source>/user~~=~~admin /password=troja /action=fnc /fnc=AFAbmReadByName /Name=Rechnungen /Parent=600448 /Option~~=~~1 /RsltPath~~=~~c:\temp\AFAPIRES.TXT</font></p>~~

	<p>In der Ergebnisdatei wird in der ersten Zeile die übergebene Anweisung		<tabber>
	geschrieben. In der zweiten Zeile wird der Rückgabewert der Funktion gespeichert. In		\|-\|ArcFlowRemoteControl=
	den folgenden Zeilen wird die Nummer der Arbeitsmappe, der Name der Arbeitsmappe, die		<pre class=source>
	Nummer der Elternmappe, Beschreibung, Abschlussvorgabe, die Mappenunterteilung und		af_rmtcontrol.exe /user=admin /password=troja /action=fnc /fnc=AFAbmReadByName /Name=Rechnungen /Parent=600448 /Option=1 /RsltPath=c:\temp\AFAPIRES.TXT
	der Mappentyp gespeichert.</p></p>		</pre>
			<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 wird die Nummer der Arbeitsmappe, der Name der Arbeitsmappe, die Nummer der Elternmappe, Beschreibung, Abschlussvorgabe, die Mappenunterteilung und der Mappentyp gespeichert.</p>
			</tabber>

	<p>		<p>

Jens: Stand 4.1.09

2024-10-18T09:55:38Z

Stand 4.1.09

← Nächstältere Version		Version vom 18. Oktober 2024, 09:55 Uhr
Zeile 6:		Zeile 6:
	</tr>		</tr>
	<tr class="ProcSyntax">		<tr class="ProcSyntax">
	<td class="title"> ~~AFAbmReadByName~~(alpha1, int2, int3) : int</td>		<td class="title"> AfAbmReadByName(alpha1, int2, int3) : 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 103:		Zeile 103:
	<td width="85%" class=Right colspan="3">		<td width="85%" class=Right colspan="3">
	[[:Category:Befehle für Arbeitsmappen\|Verwandte Befehle]],		[[:Category:Befehle für Arbeitsmappen\|Verwandte Befehle]],
	[[~~AFAbmRead~~#\|~~AFAbmRead~~()]],		[[AfAbmRead#\|AfAbmRead()]],
	[[~~AFAbmReadByPath~~#\|~~AFAbmReadByPath~~()]],		[[AfAbmReadByPath#\|AfAbmReadByPath()]],
	[[~~AFAbmReadByDescr~~#\|~~AFAbmReadByDescr~~()]]		[[AfAbmReadByDescr#\|AfAbmReadByDescr()]]
	</td>		</td>
	</tr>		</tr>

Jens: Jens verschob die Seite AFAbmReadByName nach AfAbmReadByName, ohne dabei eine Weiterleitung anzulegen

2024-10-18T09:16:00Z

Jens verschob die Seite AFAbmReadByName nach AfAbmReadByName, ohne dabei eine Weiterleitung anzulegen

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

Jens: Stand 4.1.08 Buchstaben Kategorie entfernt

2023-11-21T13:58:24Z

Stand 4.1.08 Buchstaben Kategorie entfernt

← Nächstältere Version		Version vom 21. November 2023, 13:58 Uhr
Zeile 276:		Zeile 276:
	</translate>		</translate>
	[[Category:Befehle für Arbeitsmappen]]		[[Category:Befehle für Arbeitsmappen]]
	~~[[Category:ListeAllerApiBefehleA]]~~

Jens: Stand 4.1.08

2023-11-06T08:00:32Z

Stand 4.1.08

← Nächstältere Version		Version vom 6. November 2023, 08:00 Uhr
Zeile 102:		Zeile 102:
	<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 Arbeitsmappen#\|Verwandte Befehle]],		[[:Category:Befehle für Arbeitsmappen\|Verwandte Befehle]],
	[[AFAbmRead#\|AFAbmRead()]],		[[AFAbmRead#\|AFAbmRead()]],
	[[AFAbmReadByPath#\|AFAbmReadByPath()]],		[[AFAbmReadByPath#\|AFAbmReadByPath()]],

AfWikiBot: Die Seite wurde neu angelegt: „
2020-08-19T14:44:15Z
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"> AFAbmReadByName(alpha1, int2, int3) : 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">Arbeitsmappe über Namen 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>Arbeitsmappen-Name</td>
</tr>

<tr class="ProcParameterItem">
<td valign=top width="15%" class=Left>int2</td>
<td colspan="3" width="85%" class=Right>ID der zu durchsuchenden Arbeitsmappe</td>
</tr>

<tr class="ProcParameterItem">
<td valign=top width="15%" class=Left>int3</td>
<td colspan="3" width="85%" class=Right>Optionen</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>gAfAbmId</td>
<td valign=top>int</td>
<td valign=top>Id</td>
</tr>
<tr>
<td valign=top>gAfAbmName</td>
<td valign=top>alpha(250)</td>
<td valign=top>Name der Arbeitsmappe</td>
</tr>
<tr>
<td valign=top>gAfAbmParentId</td>
<td valign=top>int</td>
<td valign=top>Nummer der Eltern-Arbeitsmappe</td>
</tr>
<tr>
<td valign=top>gAfAbmDescr</td>
<td valign=top>alpha(250)</td>
<td valign=top>Beschreibung</td>
</tr>
<tr>
<td valign=top>gAfAbmCloseDate</td>
<td valign=top>date</td>
<td valign=top>Abschlussvorgabe</td>
</tr>
<tr>
<td valign=top>gAfAbmPartitioning</td>
<td valign=top>int</td>
<td valign=top>Mappenunterteilung</td>
</tr>
<tr>
<td valign=top>gAfAbmType</td>
<td valign=top>int</td>
<td valign=top>Typ der Arbeitsmappe</td>
</tr>
<tr>
<td valign=top>gAfAbmFldGrpId</td>
<td valign=top>int</td>
<td valign=top>Id der Mappenfeldgruppe</td>
</tr>
<tr>
<td valign=top>gAfAbmTemplateId</td>
<td valign=top>int</td>
<td valign=top>Id der Vorlagemappe</td>
</tr>
<tr>
<td valign=top>gAfAbmIcon</td>
<td valign=top>int</td>
<td valign=top>Id des Symbols der Arbeitsmappe</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 Arbeitsmappen#|Verwandte Befehle]],
[[AFAbmRead#|AFAbmRead()]],
[[AFAbmReadByPath#|AFAbmReadByPath()]],
[[AFAbmReadByDescr#|AFAbmReadByDescr()]]
</td>
</tr>

</table>
</td>
</tr>
</table>
<div class="BigLang">
Mit der Funktion kann eine Arbeitsmappe über ihren Namen gelesen werden.

Der Name der Arbeitsmappe muss im Parameter (alpha1) übergeben werden. Über den zweiten Parameter wird die ID der Arbeitsmappe definiert, in der nach dem übergebenen Namen gesucht werden soll.

Als Optionen (int3) muss eine der folgenden Konstanten übergeben werden:

<table class=lang>
<tr>
<td valign=top>'''Konstante'''</td>
<td valign=top>'''Wert'''</td>
<td valign=top>'''Bedeutung'''</td>
</tr>
<tr>
<td valign=top>sAfAbmSearchParent</td>
<td valign=top><center>0</center></td>
<td valign=top>Es wird nur in der in (int2) übergebenen Mappe gesucht.</td>
</tr>
<tr>
<td valign=top>sAfAbmSearchSub</td>
<td valign=top><center>1</center></td>
<td valign=top>Es wird ebenfalls in allen Untermappen gesucht.</td>
</tr>
<tr>
<td valign=top>sAfAbmSearchUnique</td>
<td valign=top><center>4</center></td>
<td valign=top>Es werden alle Arbeitsmappen durchsucht.</td>
</tr>
</table>

Nach erfolgreicher Ausführung der Anweisung, stehen in den Feldpuffern die Werte der ermittelten Arbeitsmappe. Der Wert in gAfAbmPartitioning kann dabei mit folgenden Konstanten verglichen werden:

<table class=lang>
<tr>
<td valign=top>'''Konstante'''</td>
<td valign=top>'''Wert'''</td>
<td valign=top>'''Bedeutung'''</td>
</tr>
<tr>
<td valign=top>sAfAbmPartNone</td>
<td valign=top><center>0</center></td>
<td valign=top>keine virtuelle Unterteilung</td>
</tr>
<tr>
<td valign=top>sAfAbmPartYear</td>
<td valign=top><center>1</center></td>
<td valign=top>virtuelle Jahres-Unterteilung unter der Arbeitsmappe</td>
</tr>
<tr>
<td valign=top>sAfAbmPartYearMonth</td>
<td valign=top><center>2</center></td>
<td valign=top>virtuelle Jahres- und Monats-Unterteilung unter der Arbeitsmappe</td>
</tr>
<tr>
<td valign=top>sAfAbmPartYearMonthDay</td>
<td valign=top><center>3</center></td>
<td valign=top>virtuelle Jahres-, Monats- und Tages-Unterteilung unter der Arbeitsmappe</td>
</tr>
<tr>
<td valign=top>sAfAbmPartScript</td>
<td valign=top><center>4</center></td>
<td valign=top>virtuelle Unterteilung über ein Skript</td>
</tr>
</table>

In gAfAbmType wird der Arbeitsmappentyp zurückgegeben. Der Wert kann mit folgende Konstanten verglichen werden:

<table class=lang>
<tr>
<td valign=top>'''Konstante'''</td>
<td valign=top>'''Wert'''</td>
<td valign=top>'''Bedeutung'''</td>
</tr>
<tr>
<td valign=top>sAfAbmTypeNormal</td>
<td valign=top><center>0</center></td>
<td valign=top>Normale Arbeitsmappe</td>
</tr>
<tr>
<td valign=top>sAfAbmTypeTemplate</td>
<td valign=top><center>1</center></td>
<td valign=top>Vorlagemappe</td>
</tr>
</table>

Steht in gAfAbmCloseDate ein leeres Datum (0.0.0), hat die Arbeitsmappe kein Abschlussdatum.

Ist keine Arbeitsmappe mit dem übergebenen Namen vorhanden, wird der Wert der Konstanten sAfErrNoRecAbm zurückgeliefert. In den Feldpuffern stehen nach Aufruf der Funktion die Werte der nächsten gelesenen Arbeitsmappe.

Bei erfolgreicher Durchführung der Funktion wird der Wert _ErrOk zurückgegeben.

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

<table class=lang>
<tr>
<td valign=top>/Name</td>
<td valign=top>Name der Arbeitsmappe</td>
</tr>
<tr>
<td valign=top>/Parent</td>
<td valign=top>ID der übergeordneten Arbeitsmappe</td>
</tr>
<tr>
<td valign=top>/Option</td>
<td valign=top>Optionen (siehe Text)</td>
</tr>
<tr>
<td valign=top>/RsltPath</td>
<td valign=top>Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird.</td>
</tr>
</table>

Zum Beispiel: 
/user=admin /password=troja /action=fnc /fnc=AFAbmReadByName /Name=Rechnungen /Parent=600448 /Option=1 /RsltPath=c:\temp\AFAPIRES.TXT

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 wird die Nummer der Arbeitsmappe, der Name der Arbeitsmappe, die
Nummer der Elternmappe, Beschreibung, Abschlussvorgabe, die Mappenunterteilung und
der Mappentyp gespeichert.


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>sAfErrInvalidArgValue</td>
<td align=center valign=top>-20013</td>
<td>Ungültiger Wert eines Parameters</td>
</tr>

<tr class="ProcErrorItem">
<td class=source valign=top>sAfErrNoRecAbm</td>
<td align=center valign=top>-20026</td>
<td>Die in (int1) übergebene Arbeitsmappe existiert nicht</td>
</tr>

</table>

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

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

file:DE_Schriftzug.gif