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

XML_GET_ATTRIBUTE

Script-Funktion: Liefert den Attributwert eines Elementes.

Syntax

XML_GET_ATTRIBUTE (Reference, @Attribute)

Syntax	Beschreibung/Format
Verweis	Verweis auf ein Element, dessen Attributwert bestimmt werden soll. Format: Script-Literal oder Script-Variable
Attribut	Name des Attributes mit vorangestelltem "@". Format: Script-Literal oder Script-Variable

Rückgabewerte
Inhalt des Attributes. " " - Das Attribut besitzt keinen Wert bzw. das Element hat keine Attribute.

Kommentare

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

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

In der strukturierten Dokumentation wird zwischen den Attributarten "Text" und "Aufzählung" unterschieden, die gleichermaßen von XML_GET_ATTRIBUTE gelesen werden können.

Für den zurückgelieferten Wert gibt es keine Beschränkung.

Beispiele

Im folgenden Beispiel wird der Wert des Attributes "Name" (Typ Aufzählung) und der des Attributes "Titel" (Typ Text) ermittelt. Die Inhalte "Meier" und "Rufbereitschaft 2005" werden im Aktivierungsprotokoll ausgegeben.

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

: SET &HND# = XML_GET_FIRST_CHILD(&XMLDOCU#)
: SET &HND# = XML_GET_NEXTSIBLING(&HND#)
: SET &NAME# = XML_GET_ATTRIBUTE(&HND#, "@Name")
: PRINT "attribute value: &NAME#"
: SET &TITLE# = XML_GET_ATTRIBUTE(&HND#, "@Title")
: PRINT "attribute value: &TITLE#"

: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