AfAbmReadByPath

AfAbmReadByPath(alpha1, alpha2, alpha3, logic4) : int
Arbeitsmappe über Pfad lesen
alpha1 Arbeitsmappenpfad alpha2 Name der Arbeitsmappe alpha3 Beschreibung der Arbeitsmappe logic4 Arbeitsmappe anlegen Feldpuffer gAfAbmId int Id gAfAbmName alpha(250) Name der Arbeitsmappe gAfAbmParentId int Nummer der Eltern-Arbeitsmappe gAfAbmDescr alpha(250) Beschreibung gAfAbmCloseDate date Abschlussvorgabe gAfAbmPartitioning int Mappenunterteilung gAfAbmType int Typ der Arbeitsmappe gAfAbmTemplateId int Id der Vorlagemappe gAfAbmFldGrpId int Id der Mappenfeldgruppe gAfAbmIcon int Id des Symbols der Arbeitsmappe Resultat int Fehlerwert Siehe Verwandte Befehle, AfAbmRead(), AfAbmReadByName()

Mit dieser Funktion kann die Nummer einer Arbeitsmappe ermittelt werden, von der der Pfad bekannt ist. In (alpha1) wird der komplette Pfad zur gesuchten Arbeitsmappe angegeben. Die Namen der einzelnen Arbeitsmappen müssen mit \ getrennt sein. (alpha2) enthält noch einmal den Namen der Arbeitsmappe. Wird die Arbeitsmappe nicht gefunden und in (logic4) wurde true übergeben, wird die Arbeitsmappe mit dem entsprechenden Namen und der Beschreibung in (alpha3) angelegt.

Die Funktion kann nur über die Application Remote Control aufgerufen werden. Die Parameter werden mit folgenden Namen übergeben:

/Path	Pfad der Arbeitsmappe
/Name	Name der Arbeitsmappe
/Descr	Beschreibung der Arbeitsmappe
/Create	0 = anlegen, 1 = nicht anlegen
/RsltPath	Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird.

Beispiel

ArcFlowRemoteControl

af_rmtcontrol.exe /user=admin /password=troja /action=fnc /fnc=AfAbmReadByPath /Path=\ArFlow\Beispieldokumente\Analysen /Name=Analysen /Descr="Ordner mit Analyse-Dokumenten" /Create=0 /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 gefundenen oder neu angelegten Arbeitsmappe gespeichert.

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

Konstante	Wert	Bedeutung
_ErrOk	0	ok - kein Fehler aufgetreten
sAfErrInvalidArgValue	-20013	Ungültiger Wert eines Parameters
sAfErrNoRecAbm	-20026	Der in (alpha1) übergebene Pfad existiert nicht

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