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

XML_GET_NODE_NAME

Script-Funktion: Liefert den Namen eines Elementes.

Syntax

XML_GET_NODE_NAME (Reference)

Syntax	Beschreibung/Format
Verweis	Verweis auf ein Element, dessen Name bestimmt werden soll. Format: Script-Literal oder Script-Variable

Rückgabewert
Name des Elementes

Anmerkungen

Mit dieser Script-Funktion kann der Name eines Elementes in einem XML-Dokument gelesen werden.

Der Script-Funktion muss eine Verweis auf das Element übergeben werden. Dieser wird von Script-Sprachmitteln bereitgestellt, die innerhalb des XML-Dokumentes positionieren können, beispielsweise XML_GET_FIRST_CHILD, XML_GET_NEXTSIBLING oder XML_SELECT_NODE.

XML_OPEN liefert einen Verweis auf das erste Element.

Bitte beachten Sie, dass die Script-Funktion nicht mehr als 1024 Zeichen verarbeiten kann und bei Überschreiten dieses Limits keinen Rückgabewert mehr liefert. Achten Sie deshalb auf die Länge des Elementnamens.

Beispiel

Das Beispiel ermittelt alle auf der gleichen Ebene liegende Elemente. Deren Namen "Beschreibung" und "Kontakte" werden im Aktivierungsprotokoll ausgegeben.

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

:SET &HND# = XML_GET_FIRST_CHILD(&XMLDOCU#)

:   WHILE &HND# <> ""
:      SET &NAME# = XML_GET_NODE_NAME(&HND#)
:      PRINT "element: &NAME#"
:      SET &HND# = XML_GET_NEXTSIBLING(&HND#)
:   ENDWHILE

:XML_CLOSE

Siehe auch:

Script-Sprachmittel	Beschreibung
XML_GET_NODE_TEXT	Liefert den Text eines Elementes.

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