AfAbmLstGetByAbmFld

AfAbmLstGetByAbmFld(alpha1, alpha2, handle3[, logic4]) : int
Liste der Arbeitsmappen anhand des Inhalts eines Mappenfeldes ermitteln
alpha1 Name des Mappenfeldes alpha2 Inhalt des Mappenfeldes handle3 Deskriptor einer leeren Cte-Liste logic4 Ähnlichkeitssuche verwenden (optional) Resultat int Fehlerwert Siehe Verwandte Befehle, AfAbmLstGetByAbmFldLst(), AfAbmLstGet(), AfAbmLstGetByDescr(), AfAbmLstGetByTemplate()

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() 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.

Name	In der Eigenschaft "Name" wird die Nummer der Arbeitsmappe gespeichert
Id	Unterteilung in virtuelle Untermappen
Custom	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.

Beispiel:

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:

Konstante	Wert	Bedeutung
sAbmPartNone	0	keine virtuelle Unterteilung
sAbmPartYear	1	virtuelle Jahres-Unterteilung unter der Arbeitsmappe
sAbmPartYearMonth	2	virtuelle Jahres- und Monats-Unterteilung unter der Arbeitsmappe
sAbmPartYearMonthDay	3	virtuelle Jahres-, Monats- und Tages-Unterteilung unter der Arbeitsmappe

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:

Wildcard	Bedeutung	Suchwert	gefundene Feldinhalte
?	ein beliebiges Zeichen	www.arcflow.??	www.arcflow.ch www.arcflow.de
*	mehrere beliebige Zeichen	*@arcflow.net	support@arcflow.net info@arcflow.net

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:

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();
...

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

Konstante	Wert	Bedeutung
_ErrOk	0	ok - kein Fehler aufgetreten
sAfErrNoRecAbmFld	-20037	Das in (alpha1) angegebene Mappenfeld ist nicht vorhanden.

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