XML_SET_ATTRIBUTE

Verwenden Sie die Script-Funktion XML_SET_ATTRIBUTE, um einem XML-Element ein Attribut hinzuzufügen oder ein vorhandenes Attribut eines Elements zu ändern, das sich im geöffneten XML-Dokument befindet. Sie müssen einen Verweis auf das Element sowie den Namen und Wert des Attributs angeben. Wenn das Attribut, das Sie angeben, nicht gefunden werden kann, wird es zum Element hinzugefügt. Nur das im Speicher verfügbare Element wird geändert. Eine Dokumentationsseite beispielsweise wird nicht geändert.

Tipp: Verwenden Sie die Script-Funktion XML_OPEN, um das XML-Dokument zu öffnen. Weitere Informationen finden Sie unter XML_OPEN.

Syntax

XML_SET_ATTRIBUTE (Element, Attribut, Wert)

Script-Funktion und Parameter

• XML_SET_ATTRIBUTE
  Fügt einem XML-Element ein neues Attribut hinzu oder ändert ein vorhandenes.

• Element
  Verweis auf das Element, dessen Attribut geändert wird oder dem das neue Attribut hinzugefügt wird
  Format: Script-Literal oder Script-Variable

• Attribut
  Name des Attributs mit einem @-Zeichen am Anfang
  Format: Script-Literal oder Script-Variable
  Wichtig! Ein Laufzeitfehler tritt auf, wenn Sie kein @-Zeichen am Anfang hinzufügen.

• Wert
  Wert des Attributs
  Format: Script-Literal oder Script-Variable

Rückgabewert

• 0
  Das Attribut wurde erfolgreich geändert bzw. hinzugefügt.
  

Beispiel

Das folgende Beispiel öffnet die strukturierte Dokumentationsseite "@Details" als XML-Dokument und wählt das Element "Child" aus. Das neue Attribut "Attribute1" wird dem Element hinzugefügt. Wird es erfolgreich hinzugefügt, wird die Script-Funktion XML_SET_ATTRIBUTE zur Verifizierung noch einmal gelesen und der Wert wird in den Aktivierungsreport geschrieben.

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

: IF &XMLDOCU# <> ""
:SET &ELEMENT# = XML_SELECT_NODE(&XMLDOCU#,"Child")

:SET &RET# = XML_SET_ATTRIBUTE(&ELEMENT#,"@Attribute1","Value1")
:IF &RET# = 0
:SET &ATT# = XML_GET_ATTRIBUTE(&ELEMENT#,"@Attribute1")
:P &ATT#
:ENDIF

:ENDIF

:XML_CLOSE &XMLDOCU#

Siehe auch: