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: