XML_SELECT_NODE

Verwenden Sie die Script-Funktion XML_SELECT_NODE, um ein beliebiges Element im XML-Dokument zu identifizieren. Geben Sie einen Verweis an, der ein Element identifiziert, das als Ausgangspunkt der Suche verwendet werden soll.

Syntax

XML_SELECT_NODE (Referenz, Element)

Script-Funktion und Parameter

• XML_SELECT_NODE
  Identifiziert ein Element.

• Referenz
  Verweis auf das Element, das als Ausgangspunkt dient
  Format: Script-Literal oder Script-Variable
  Tipps: Mit Verweisen oder Handles können Sie eine Position innerhalb des XML-Dokuments identifizieren und bearbeiten. Sie können die folgenden Script-Funktionen verwenden, um Handles abzurufen:

  • XML_OPEN 
    Gibt das erste Handle zurück, das sich auf das Root-Element bezieht
    Verwenden Sie XML_SELECT_NODE mit diesem Handle, um ein Element direkt zu identifizieren.
  • XML_GET_FIRST_CHILD
    Gibt die Nummer des ersten Unterelements eines Elements zurück
  • XML_GET_NEXTSIBLING
    Gibt das Handle des nächsten Elements auf derselben Ebene im XML-Dokument zurück.

• Element
  Name des Elements einschließlich des Pfads vom Ausgangspunkt
  Hinweis: Diese Script-Funktion kann nur Elemente finden, die Unterelemente des Ausgangspunkts sind.
  Format: Script-Literal oder Script-Variable

Rückgabewerte

Diese Script-Funktion gibt den Verweis auf das gesuchte Element zurück oder einen leeren String, wenn das gesuchte Element nicht existiert.

Beispiel

Das folgende Beispiel setzt voraus, dass das Kalenderobjekt ON_CALL_SERVICES eine Inhaltsstruktur hat, die das Element "Description" mit einem Unterelement namens "Objects" enthält. Das Script beabsichtigt, das erste Element direkt aus dem Root-Element "Content" der strukturierten Dokumentationsseite "@Details" abzurufen. Der Text, den das Unterelement "Objects" enthält, wird im Aktivierungsreport ausgegeben.

: SET   &XMLDOCU# = XML_OPEN (DOCU, "ON_CALL_SERVICES" , "@Details" )
: SET &HND# = XML_SELECT_NODE ( &XMLDOCU# , "Description/Objects" )
:SET &NODETEXT# = XML_SET_NODE_TEXT (&HND#,"Related Objects")
: SET   &TEXT# = XML_GET_NODE_TEXT ( &HND# )

: PRINT   "Text of the element: &TEXT#"

: XML_CLOSE

Im Aktivierungsreport wird der Text angezeigt, den das Unterlement "Objects" enthält:

Siehe auch: