XML_SET_ATTRIBUTE

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

Syntax

XML_SET_ATTRIBUTE (Element, Attribut, Wert)

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
Attribut	Name des Attributs, dem das Zeichen '@' vorangestellt wird Format: Script-Literal oder Script-Variable Wichtig! Geben Sie immer das @-Zeichen vor dem Namen des Attributs an. Wenn Sie dieses Zeichen weglassen, tritt ein Laufzeitfehler auf.
Wert	Wert des Attributs Format: Script-Literal oder Script-Variable

 

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

Das Script-Element ändert ein Attribut eines Elements, das sich im geöffneten XML-Dokument befindet. Geben Sie einen Verweis auf das Element sowie den Namen und Wert des Attributs an.

Hinweise:

• Kann das von Ihnen eingegebene Attribut nicht gefunden werden, wird es erneut dem Element hinzugefügt.
• Das Element wird nur im Speicher geändert.  Das Script-Element hat keinen Einfluss auf die Registerkarte "Dokumentation".
• Verwenden Sie die Script-Funktion XML_OPEN, um das XML-Dokument zu öffnen.  Weitere Informationen finden Sie unter XML_OPEN.

Beispiel

Das folgende Beispiel öffnet die Registerkarte Strukturierte Dokumentation als XML-Dokument und wählt das "Child"-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 Aktivierungslog geschrieben.

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

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

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

:ENDIF

:XML_CLOSE &XMLDOCU#

Siehe auch: