AfAbmRmtLinkGet

AfAbmRmtLinkGet(int1, var alpha2[, logic3[,int4]]) : int
Link zur Positionierung auf eine Arbeitsmappe über das Remote Control
int1 Nummer der Arbeitsmappe alpha2 Link zur Arbeitsmappe logic3 Link als HTML- oder Remote Control-Aufruf (optional) int4 Zusätzliche Parameter für Aufruf über das Remote Control (optional) Resultat int Fehlerwert Siehe Verwandte Befehle, AfArcRmtLinkGet(), AfArcFileRmtLinkGet()

Mit dieser Anweisung wird eine Zeichenkette ermittelt, die zur Positionierung auf eine Arbeitsmappe über unterschiedliche Verknüpfungen benötigt wird. In (int1) wird die Nummer der Arbeitsmappe angegeben. In (alpha2) muss eine Zeichenkette übergeben werden, die nach erfolgreicher Ausführung die Verknüpfung enthält. Mit dem Parameter (logic3) wird bestimmt, ob die Verknüpfung für einen Hyperlink (false) oder für das Remote Control zurückgegeben werden soll. Im Parameter (int4) können zusätzliche Optionen angegeben werden.

Bei einem Aufruf mit logic3=false kann die zurückgegebene Zeichenkette in <a href="...">Link zur Arbeitsmappe</a> eingebettet werden. Der Text kann dann in einer HTML-Seite oder einer Mail vom Typ HTML eingebunden werden. Damit die entsprechende Verknüpfung funktioniert, müssen auf dem Arbeitsplatz die Archivlinks eingerichtet sein.

Wird logic3=true übergeben, gibt die Anweisung eine Zeichenkette zurück, die an (siehe CONZEPT 16 Hilfe) übergeben werden kann.

In (int4) können folgende Konstanten (auch in Kombination) übergeben werden:

sAfRmtCtrlFlagAbmShowAsRoot	1	Es wird nur ein Teil des Arbeitsmappenbaumes angezeigt. Die angegeben Arbeitsmappe ist die erste angezeigte Mappe des Baumes.
sAfRmtCtrlFlagAbmNodeExpand	2	Alle untergeordneten Arbeitsmappen werden aufgeklappt.
sAfRmtCtrlFlagAppFocus	64	Der ArcFlow-Client wird im Vordergrund angezeigt.

Beispiele:

tResult # AfAbmRmtLinkGet(gAfAbmId,var tLink); // af-10.0.0.1-arcflow://123456::0:0:0:0
tResult # AfAbmRmtLinkGet(gAfAbmId,var tLink,false,sAfRmtCtrlFlagAbmShowAsRoot | sAFRmtCtrlFlagAppFocus); // af-10.0.0.1-arcflow://123456::0:0:65:0
tResult # AfAbmRmtLinkGet(gAfAbmId,var tLink,true,sAfRmtCtrlFlagAbmShowAsRoot); // \10.0.0.1\Client\Lib\Af_RmtControl\AF_RmtControl.exe /ACTION=OPEN_DIALOG /FNC=AFAbmPos /ABMNR=123456 /FLAGS=1

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

Konstante	Wert	Bedeutung
_ErrOk	0	kein Fehler
sAFErrNoRecAbm	-20026	Die in (int1) übergebene Arbeitsmappe existiert nicht.

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