XML_SET_ATTRIBUTE

Script-Funktion: Fügt einem XML-Element ein neues Attribut hinzu oder ändert ein bestehendes Attribut.

Syntax

XML_SET_ATTRIBUTE (Element, Attribute, Value)

Syntaxteil	Beschreibung/Format
Element	Verweis auf das Element, dessen Attribut geändert wird oder dem das neue Attribut hinzugefügt wird. Format: Script-Literal oder Script-Variable
Attribute	Name des Attributs, dem das Zeichen '@' vorangestellt wird Format: Script-Literal oder Script-Variable
Value	Wert des Attributs Format: Script-Literal oder Script-Variable

Rückgabewert
"0" - Das Attribut wurde erfolgreich geändert bzw. hinzugefügt.

Hinweise:

Das Scriptelement ändert ein Attribut eines Elements, das sich im geöffneten XML-Dokument befindet (XML_OPEN). Sie müssen einen Verweis auf das Element sowie den Namen und Wert des Attributs angeben. Kann das von Ihnen eingegebene Attribut nicht gefunden werden, wird es erneut dem Element hinzugefügt.

Bitte beachten Sie, dass nur das im Speicher vorhandene Element geändert wird. Die Registerkarte Dokumentation ist davon nicht betroffen.

Ein Laufzeitfehler tritt auf, wenn vor dem Namen des Attributs kein '@'-Zeichen eingegeben wird.

Beispiel

Das folgende Beispiel öffnet die Registerkarte Strukturierte Dokumentation als XML-Dokument und wählt das "Kind"-Element aus. Das neue 'Attribute1'-Attribut wird dann dem Element hinzugefügt. Nach dem erfolgreichen Hinzufügen wird das gesetzte Attribut zur Prüfung erneut gelesen und der Wert in das Aktivierungsprotokoll 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