XML_SELECT_NODE

Script-Funktion: Identifiziert ein beliebiges Element

Syntax

XML_SELECT_NODE (Referenz, Element)

Syntax	Beschreibung/Format
Referenz	Verweis auf das Element, das als Startpunkt dient Format: Script-Literal oder Script-Variable
Element	Name des Elements mit dem Pfad ab dem Startpunkt Format: Script-Literal oder Script-Variable

Rückgabewerte
Verweis auf das gesuchte Element " " - Das gesuchte Element ist nicht vorhanden.

Die Scriptfunktion identifiziert jedes Element im XML-Dokument. Geben Sie einen Verweis (Handle) an, der ein Element identifiziert, das als Ausgangspunkt der Suche verwendet werden soll.

Mit Handles können Sie eine Position im XML-Dokument identifizieren und bearbeiten. Verwenden Sie die folgenden Script-Funktionen, um Handles anzugeben:

• 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 die Nummer des nächsten Elements auf derselben Ebene im XML-Dokument zurück
  

Hinweis: Es werden nur Elemente gefunden, die Unterelemente des Startpunkts sind.

Tipp:Für viele Automation Engine scripting language-Elemente müssen Sie ein Handle angeben, damit sie für XML funktionieren. Verwenden Sie XML_SELECT_NODE oder die in diesem Thema aufgeführten Script-Funktionen, um Handles anzugeben.

Beispiel

Das Beispiel identifiziert ein Element direkt aus dem Root-Element "Inhalt" der strukturierten Dokumentation. Der Text des Elements "Objekte" wird im Aktivierungslog ausgegeben.

: SET   &XMLDOCU# = XML_OPEN (DOCU, "ON_CALL" , "@Details" )

: SET &HND# = XML_SELECT_NODE ( &XMLDOCU# , "Description/Objects" )
: SET   &TEXT# = XML_GET_NODE_TEXT ( &HND# )
: PRINT   "Text des Elements: &TEXT#"

: XML_CLOSE

Siehe auch: