AfAbmLstGetByAbmFld - Versionsgeschichte

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

2025-12-18T14:48:02Z

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

@@ Zeile 8: / Zeile 8: @@
      <td class="title">&nbsp;AfAbmLstGetByAbmFld(alpha1, alpha2, handle3[, logic4]) : 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]]
+[[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>
    </tr>
@@ Zeile 155: / Zeile 155: @@
 <p>{{Info|Ist die Suche mit Wildcards aktiviert, kann nicht mehr nach Mappenfeldinhalten mit "?" und "*" gesucht werden, da diese Zeichen als Platzhalter für ein oder mehrere Zeichen interpretiert werden.}}</p>
-<b>Beispiel:</b>{{Marker}}
+== Beispiel ==
 <pre class=source>
 local
@@ Zeile 187: / Zeile 188: @@
 tCteList-&gt;AfCteCloseAll();
 ...
-</pre></p>
+</pre>
 <p>

Jens: Stand 4.1.09

2025-01-20T09:22:09Z

Stand 4.1.09

← Nächstältere Version		Version vom 20. Januar 2025, 09:22 Uhr
Zeile 54:		Zeile 54:
	[[AfAbmLstGetByAbmFldLst#\|AfAbmLstGetByAbmFldLst()]],		[[AfAbmLstGetByAbmFldLst#\|AfAbmLstGetByAbmFldLst()]],
	[[AfAbmLstGet#\|AfAbmLstGet()]],		[[AfAbmLstGet#\|AfAbmLstGet()]],
	[[AfAbmLstGetByDescr#\|AfAbmLstGetByDescr]]		[[AfAbmLstGetByDescr#\|AfAbmLstGetByDescr()]],
			[[AfAbmLstGetByTemplate\|AfAbmLstGetByTemplate()]]
	</td>		</td>
	</tr>		</tr>

Jens: Stand 4.1.09

2024-10-17T11:58:50Z

Stand 4.1.09

← Nächstältere Version		Version vom 17. Oktober 2024, 11:58 Uhr
Zeile 6:		Zeile 6:
	</tr>		</tr>
	<tr class="ProcSyntax">		<tr class="ProcSyntax">
	<td class="title"> ~~AFAbmLstGetByAbmFld~~(alpha1, alpha2, handle3[, logic4]) : int</td>		<td class="title"> AfAbmLstGetByAbmFld(alpha1, alpha2, handle3[, logic4]) : 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 52:		Zeile 52:
	<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]],
	[[~~AFAbmLstGetByAbmFldLst~~#\|~~AFAbmLstGetByAbmFldLst~~()]],		[[AfAbmLstGetByAbmFldLst#\|AfAbmLstGetByAbmFldLst()]],
	[[~~AFAbmLstGet~~#\|~~AFAbmLstGet~~()]],		[[AfAbmLstGet#\|AfAbmLstGet()]],
	[[~~AFAbmLstGetByDescr~~#\|AfAbmLstGetByDescr]]		[[AfAbmLstGetByDescr#\|AfAbmLstGetByDescr]]
	</td>		</td>
	</tr>		</tr>
Zeile 64:		Zeile 64:
	</table>		</table>
	<div class="BigLang">		<div class="BigLang">
	<p><p>Mit der Funktion lassen sich alle Arbeitsmappen ermitteln, die in dem angegebenen Mappenfeld (alpha1) den Wert (alpha2) besitzen. Es werden alle Arbeitsmappen durchsucht. Im Parameter (handle3) 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 Arbeitsmappen ermitteln, die in dem angegebenen Mappenfeld (alpha1) den Wert (alpha2) besitzen. Es werden alle Arbeitsmappen durchsucht. Im Parameter (handle3) 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 für jede Mappe ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen werden und über die Eigenschaften "Name", "Id" und "Custom" die Mappen-Informationen ausgelesen werden.</p>		<p>Nach dem Aufruf der Funktion ist für jede Mappe ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen werden und über die Eigenschaften "Name", "Id" und "Custom" die Mappen-Informationen ausgelesen werden.</p>

Jens: Jens verschob die Seite AFAbmLstGetByAbmFld nach AfAbmLstGetByAbmFld, ohne dabei eine Weiterleitung anzulegen

2024-10-17T11:24:02Z

Jens verschob die Seite AFAbmLstGetByAbmFld nach AfAbmLstGetByAbmFld, ohne dabei eine Weiterleitung anzulegen

← Nächstältere Version	Version vom 17. Oktober 2024, 11:24 Uhr
(kein Unterschied)

Jens: Stand 4.1.08 Buchstaben Kategorie entfernt

2023-11-21T13:50:05Z

Stand 4.1.08 Buchstaben Kategorie entfernt

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

Jens: Stand 4.1.08

2023-11-06T07:46:34Z

Stand 4.1.08

← Nächstältere Version		Version vom 6. November 2023, 07:46 Uhr
Zeile 51:		Zeile 51:
	<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 Arbeitsmappen\|Verwandte Befehle]],
	[[AFAbmLstGetByAbmFldLst#\|AFAbmLstGetByAbmFldLst()]],		[[AFAbmLstGetByAbmFldLst#\|AFAbmLstGetByAbmFldLst()]],
	[[AFAbmLstGet#\|AFAbmLstGet()]],		[[AFAbmLstGet#\|AFAbmLstGet()]],

Jens am 25. Oktober 2023 um 06:46 Uhr

2023-10-25T06:46:04Z

← Nächstältere Version		Version vom 25. Oktober 2023, 06:46 Uhr
Zeile 51:		Zeile 51:
	<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]],~~
	[[AFAbmLstGetByAbmFldLst#\|AFAbmLstGetByAbmFldLst()]],		[[AFAbmLstGetByAbmFldLst#\|AFAbmLstGetByAbmFldLst()]],
	[[AFAbmLstGet#\|AFAbmLstGet()]],		[[AFAbmLstGet#\|AFAbmLstGet()]],
	~~[[AFAbmLstGetAll#\|AFAbmLstGetAll()]],~~
	[[AFAbmLstGetByDescr#\|AfAbmLstGetByDescr]]		[[AFAbmLstGetByDescr#\|AfAbmLstGetByDescr]]
	</td>		</td>

AfWikiBot: Die Seite wurde neu angelegt: „
2020-08-19T14:44:07Z
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"> AFAbmLstGetByAbmFld(alpha1, alpha2, handle3[, logic4]) : 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">Liste der Arbeitsmappen anhand des Inhalts eines Mappenfeldes ermitteln</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 Mappenfeldes</td>
</tr>

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

<tr class="ProcParameterItem">
<td valign=top width="15%" class=Left>handle3</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>logic4</td>
<td colspan="3" width="85%" class=Right>Ähnlichkeitssuche verwenden (optional)</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]],
[[AFAbmLstGetByAbmFldLst#|AFAbmLstGetByAbmFldLst()]],
[[AFAbmLstGet#|AFAbmLstGet()]],
[[AFAbmLstGetAll#|AFAbmLstGetAll()]],
[[AFAbmLstGetByDescr#|AfAbmLstGetByDescr]]
</td>
</tr>

</table>
</td>
</tr>
</table>
<div class="BigLang">
Mit der Funktion lassen sich alle Arbeitsmappen ermitteln, die in dem angegebenen Mappenfeld (alpha1) den Wert (alpha2) besitzen. Es werden alle Arbeitsmappen durchsucht. Im Parameter (handle3) muss der Deskriptor einer leeren Cte-Liste übergeben werden, die vor dem Aufruf der Funktion über den Befehl [[AFCteOpen#|AfCteOpen()]] angelegt wurde.

Nach dem Aufruf der Funktion ist für jede Mappe ein Objekt in der Cte-Liste vorhanden. Die Objekte können geladen werden und über die Eigenschaften "Name", "Id" und "Custom" die Mappen-Informationen ausgelesen werden.

<table class=lang>
<tr>
<td valign=top>Name
</td>
<td valign=top>In der Eigenschaft "Name" wird die Nummer der Arbeitsmappe gespeichert
</td>
</tr>
<tr>
<td valign=top>Id
</td>
<td valign=top>Unterteilung in virtuelle Untermappen
</td>
</tr>
<tr>
<td valign=top>Custom
</td>
<td valign=top>In der Eigenschaft "Custom" wird ein Vorzeichen (+ oder -) gefolgt vom Namen der Arbeitsmappe gespeichert. 
Das Vorzeichen sagt aus, ob zu dieser Mappe weitere Untermappen vorhanden sind: "+", es sind Untermappen vorhanden, "-", es sind keine Untermappen vorhanden.
</td>
</tr>
</table>

Beispiel:{{Marker}}


Name = '14', Custom = '-Workfolder' - Die Arbeitsmappe 14 hat den Namen "Workfolder" und besitzt keine Untermappen.

Über die Eigenschaft "ID" des Items kann die Mappen-Unterteilung der Arbeitsmappe abgefragt werden. Folgende Konstanten können zurückgegeben 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>sAbmPartNone</td>
<td valign=top>0</td>
<td valign=top>keine virtuelle Unterteilung</td>
</tr>
<tr>
<td valign=top>sAbmPartYear</td>
<td valign=top>1</td>
<td valign=top>virtuelle Jahres-Unterteilung unter der Arbeitsmappe</td>
</tr>
<tr>
<td valign=top>sAbmPartYearMonth</td>
<td valign=top>2</td>
<td valign=top>virtuelle Jahres- und Monats-Unterteilung unter der Arbeitsmappe</td>
</tr>
<tr>
<td valign=top>sAbmPartYearMonthDay</td>
<td valign=top>3</td>
<td valign=top>virtuelle Jahres-, Monats- und Tages-Unterteilung unter der Arbeitsmappe</td>
</tr>

</table>

{{Info|Wird ein ungültiger Deskriptor in (handle3) übergeben, kommt es zu einem Laufzeitfehler.}}

In der Liste werden alle Arbeitsmappen eingetragen, die in dem angegebenen Mappenfeld den entsprechenden Wert besitzen. Der Wert in dem Mappenfeld darf sich nur in der Groß-/Kleinschreibung unterscheiden. Sollen Werte gesucht werden, die ähnlich sind, muss in (logic4) true übergeben werden. In dem Fall kann in (alpha2) ein Wert mit Platzhaltern (Wildcards) angegeben werden. Folgende Wildcards können verwendet werden:

<table class=lang>
<tr>
<td valign=top>'''Wildcard'''</td>
<td valign=top>'''Bedeutung'''</td>
<td valign=top>'''Suchwert'''</td>
<td valign=top>'''gefundene Feldinhalte'''</td>
</tr>
<tr>
<td valign=top>?</td>
<td valign=top>ein beliebiges Zeichen</td>
<td valign=top>www.arcflow.??</td>
<td valign=top>www.arcflow.ch www.arcflow.de</td>
</tr>
<tr>
<td valign=top></td>
<td valign=top>mehrere beliebige Zeichen</td>
<td valign=top>@arcflow.net</td>
<td valign=top>support@arcflow.net info@arcflow.net</td>
</tr>
</table>

{{Info|Ist die Suche mit Wildcards aktiviert, kann nicht mehr nach Mappenfeldinhalten mit "?" und "" gesucht werden, da diese Zeichen als Platzhalter für ein oder mehrere Zeichen interpretiert werden.}}

Beispiel:{{Marker}}


<pre class=source>
local
{
tResult : int;
tCteList : handle;
}

...
tCteList # AfCteOpen(_CteList);
tResult # AfAbmLstGetByAbmFld('CustomerName','ArcFlow GmbH',tCteList);
// or
// tResult # AfAbmLstGetByAbmFld('CustomerName','ArcFlow ',tCteList,true);
switch (tCteList->CteInfo(_CteCount))
{
case 0 : // no customer with that name
{
...
}
case 1 : // customer found
{
...
}
default : // more than one customer with that name
{
...
}
}
tCteList->AfCteCloseAll();
...
</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>sAfErrNoRecAbmFld</td>
<td align=center valign=top>-20037</td>
<td>Das in (alpha1) angegebene Mappenfeld ist nicht vorhanden.</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