AfAbmReadByPath
 |
|||||||||||||||||||||||||
| AFAbmReadByPath(alpha1, alpha2, alpha3, logic4) : int |
|
||||||||||||||||||||||||
| Arbeitsmappe über Pfad lesen | |||||||||||||||||||||||||
|
|||||||||||||||||||||||||
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. |
Zum Beispiel:
/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.
