6.8.43 DMcob_PathToID

Mit Hilfe dieser Funktion wird der Ihnen bekannte externe Name eines Objektes in die interne Bezeichnung umgewandelt. Diese interne Bezeichnung eines Objektes ist über einen Programmlauf hinweg konstant, sodass Sie den Identifikator eines oft benötigten Objektes nicht bei jedem Zugriff erfragen müssen.

01  DM-objectid  pic 9(9) binary value 0.
01  DM-rootid    pic 9(9) binary value 0.
01  DM-path      pic X(256).

call "DMcob_PathToID" using
            DM-StdArg
            DM-objectid
            DM-rootid
            DM-path.

Parameter

<- DM-objectid

0

Das Objekt wurde nicht gefunden oder sein Identifikator ist nicht eindeutig.

!= 0

Identifikator des gesuchten Objekts.

Mit dem so erhaltenen Identifikator können Sie nun auf die Attribute des benannten Objekts zugreifen.

-> DM-rootid

Mit Hilfe dieses Parameters können Sie steuern, ab welchem Objekt der Dialog Manager die Suche nach dem von Ihnen gewünschten Objekt beginnt. Dabei gibt es folgende Möglichkeiten:

  • rootid = 0

    Der Dialog Manager sucht in der gesamten Dialogdefinition nach dem angegebenen Objekt. Dies ist der Normalfall. Auf diese Art können auch die Identifikatoren von Regeln, Funktionen, Variablen und Ressourcen erfragt werden.

  • rootid != 0

    Der Dialog Manager soll ab dem angegebenen Objekt auf der nächsttieferen Hierarchiestufe suchen.

    Diese Vorgehensweise ist nur dann angebracht, wenn in einem Dialog ein Objektname mehr als einmal auftritt!

    Regeln, Funktionen, Variablen und Ressourcen können auf diese Weise nicht erfragt werden!

-> DM-path

Mit Hilfe dieses Pfades wird das gesuchte Objekt beschrieben. Dieser Pfad muss eindeutig ein Objekt beschreiben. Existiert der Objektname nur einmal innerhalb des Dialoges, so reicht die Angabe des Namens, um die gewünschte Referenz zu erhalten. Ist der Objektname nicht eindeutig, muss das Objekt über einen Pfad von Objektnamen, getrennt durch einen Punkt beschrieben werden.

Der Pfad sollte mit einem Low-Value oder dem Separator-Zeichen beendet werden, ansonsten werden maximal 256 Zeichen gelesen.

COBOL-Schnittstelle für Micro Focus Visual COBOL

Der Parameter kann auch als National Character (PIC N) übergeben werden, wenn mit Unicode-Texten (UTF-16) gearbeitet wird.

Rückgabewert

DM-status of DM-StdArgs

DM-error

Das gesuchte Objekt wurde nicht gefunden oder der Name ist nicht eindeutig.

DM-success

Identifikator des gesuchten Objektes wird zurückgegeben.

Anmerkung

Mit Hilfe dieser Funktion können Sie den internen Namen aller Objekte, Ressourcen, Variablen, Funktionen und Regeln erfragen!

Beispiel

    Call "DMcob_PathToID" using DM-StdArgs DM-object

            DM-rootID By content "ObjectToAccess".