XML_GET_ATTRIBUTE

Script-Funktion: Liefert den Attributwert eines Elementes.

Syntax

XML_GET_ATTRIBUTE (Referenz, @Attribut)

Syntax	Beschreibung/Format
Referenz	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
Der Inhalt des Attributs. " " - Das Attribut hat keinen Wert oder das Element hat keine Attribute.

Mit dieser Script-Funktion kann der Attributwert eines Elements in einem XML-Dokument gelesen werden. Strukturierte Dokumentation unterscheidet zwischen Text- und Listing-Attributtypen, die beide mit XML_GET_ATTRIBUTE gelesen werden können. Für den zurückgelieferten Wert gibt es keine Beschränkung.

Hinweis: Sie müssen ein Handle für die Script-Funktion angeben, um auf das Element zugreifen zu können. Verwenden Sie eine Script-Funktion, die die Position innerhalb des XML-Dokuments übernimmt, um das Handle bereitzustellen. Im Folgenden finden Sie Beispiele für Script-Elemente, die Sie für diesen Zweck verwenden können:

• XML_GET_FIRST_CHILD
• XML_GET_NEXTSIBLING
• XML_SELECT_NODE

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 2012" werden im Aktivierungsreport 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 "Attributwert: &NAME#"
:  SET &TITLE# = XML_GET_ATTRIBUTE(&HND#, "@Title")
:  PRINT "Attributwert: &TITLE#"

:XML_CLOSE

Siehe auch: