XML_GET_ATTRIBUTE

Verwenden Sie die Script-Funktion XML_GET_ATTRIBUTE, um den Attributwert eines Elements in einem XML-Dokument zu lesen. Strukturierte Dokumentation unterscheidet zwischen Text- und Listen-Attributtypen, die beide mit der Script-Funktion XML_GET_ATTRIBUTE gelesen werden können. Für den zurückgelieferten Wert gibt es keine Obergrenzen.

Syntax

XML_GET_ATTRIBUTE (Referenz, @Attribut)

Script-Funktion und Parameter

• XML_GET_ATTRIBUTE
  Ruft den Wert des Attributs eines Elements ab.

• Referenz
  Verweis auf das Element, dessen Attributwert ermittelt werden soll
  Format: Script-Literal oder Script-Variable
  Tipps: Mit Referenzen oder Handles können Sie eine Position innerhalb des XML-Dokuments identifizieren und bearbeiten. Sie können die folgenden Script-Funktionen verwenden, um Handles abzurufen:

  • XML_GET_FIRST_CHILD
  • XML_GET_NEXTSIBLING
  • XML_SELECT_NODE

• Attribut
  Name des Attributs mit einem vorangestellten @-Zeichen
  Format: Script-Literal oder Script-Variable

Rückgabewerte

Diese Script-Funktion gibt den Inhalt des Attributs zurück und " ", wenn das Attribut keinen Wert hat oder das Element keine Attribute hat.

Beispiele

Das folgende Beispiel ruft die Werte der beiden Textattribute "Name" und "Title" ab.

: SET   &XMLDOCU# = XML_OPEN (DOCU, "ON_CALL_SERVICES" , "@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

Im Aktivierungsreport wird der Inhalt (die Attributwerte) von "Name" und "Title" angezeigt:

Siehe auch: