Automation Engine Script-Leitfaden > Funktionelle Gliederung > Objekte lesen oder verändern > XML_SELECT_NODE

XML_SELECT_NODE

Script-Funktion: Ermittelt beliebiges Element.

Syntax

XML_SELECT_NODE(Reference, Element)

Syntax	Beschreibung/Format
Verweis	Verweis auf das Element, das als Ausgangspunkt dient. Format: Script-Literal oder Script-Variable
Element	Name des gesuchten Elementes mit Pfad ab Ausgangspunkt. Format: Script-Literal oder Script-Variable

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

Kommentare

Die Script-Funktion ermittelt ein beliebiges Element in dem XML-Dokument.

Der Script-Funktion muss ein Verweis übergeben werden, um zunächst auf ein Element zu positionieren. Dieses Element ist der Ausgangspunkt der Suche in der Struktur. Von dieser Stelle aus wird das Element gesucht, welches mit Pfad angegeben wurde.

Verweise werden von speziellen Script-Sprachmitteln genutzt, um sich innerhalb des XML-Dokumentes zu positionieren und diese zu bearbeiten. Der allererste Verweis ist jener, der XML_OPEN zurückgibt. Es verweist auf das Root-Element. Es kann von XML_SELECT_NODE verwendet werden, um direkt von dort aus ein Element zu ermitteln. Die Script-Funktion kann den Verweis allerdings auch von XML_GET_FIRST_CHILD oder XML_GET_NEXTSIBLING erhalten. Daraus ergeben sich flexible Möglichkeiten, um auf Elemente in stark verzweigten Strukturen zuzugreifen.

Beachten Sie, dass nur Elemente gefunden werden, die ein Subelement des Ausgangspunktes sind.

Beispiel

Das Beispiel ermittelt ein Element direkt ab dem Root-Element "Content". Der Text des Elementes "Objekte" wird im Aktivierungsprotokoll 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 of the element: &TEXT#"

:XML_CLOSE

Siehe auch:

Script-Sprachmittel - Objekte lesen oder verändern

Strukturierte Dokumentation

www.w3c.org/TR/xmlbase

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel - Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support