AfArcFilePos

AfArcFilePos(alpha1, int2[, int3]) : int
Auf eine Anhangdatei positionieren
alpha1 Nummer des Archives int2 Nummer der Anhangdatei int3 Nummer der Arbeitsmappe (optional) Resultat int Fehlerwert Siehe Verwandte Befehle, AfArcPos(), AfAbmPos()

Mit dieser Funktion wird in ArFlow auf eine bestimmte Anhangdatei positioniert. Die Nummer des Archivs und der Anhangdatei werden in (alpha1) bzw. (int2) übergeben. Sollte das Archiv in mehreren Arbeitsmappen enthalten sein, kann die Arbeitsmappe in (int3) angegeben werden.

Die Funktion kann nur mit der Application Remote Control verwendet werden. Die Parameter werden mit folgenden Namen übergeben:

/ArcNr	Nummer des Archivs
/ArcFileNr	Nummer der Anhangdatei
/AbmNr	Nummer der Arbeitsmappe
/RsltPath	Pfad und Name der externen Datei, in der das Ergebnis gespeichert wird.

Über den zusätzlichen Parameter /FLAGS kann das Verhalten der Applikation gesteuert werden:

Wert	Auswirkung
1	Die angegebene Arbeitsmappe wird als Root-Arbeitsmappe angezeigt.
2	Untergeordnete Arbeitsmappen werden aufgeklappt.
64	Die ArcFlow-Applikation wird im Vordergrund angezeigt.

Die Einzelnen Werte können miteinander kombiniert werden (/FLAGS=67 = Arbeitsmappe als Root, Untermappen aufgeklappt und Applikation im Vordergrund).

Zum Beispiel:
/user=admin /password=troja /action=open_dialog /fnc=AfArcFilePos /ArcNr=2008.0000012 /ArcFileNr=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.

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

Konstante	Wert	Bedeutung
_ErrOk	0	ok - kein Fehler aufgetreten
_rLocked	1	Ein anderer Benutzer hat das Archiv zur Zeit gesperrt.
_rNoRec	5	Das angegebene Archiv existiert nicht
sAfErrNoRights	-20029	Die Berechtigungen sind nicht ausreichend
sAfErrArcFileNotExists	-20031	Die Anhangdatei zu dem Archiv existiert nicht

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