Automation Engine Script-Leitfaden > Funktionelle Gliederung > Objekte lesen oder verändern > XML_SET_ATTRIBUTE

XML_SET_ATTRIBUTE

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

Syntax

XML_SET_ATTRIBUTE(Element, Attribute, Value)

Syntaxteil	Beschreibung/Format
Element	Verweis auf das Element, dessen Attribut geändert bzw. dem ein neues Attribut hinzugefügt werden soll. Format: Script-Literal oder Script-Variable
Attribut	Name des Attributs mit vorangestelltem Zeichen "@" Format: Script-Literal oder Script-Variable
Wert	Wert des Attributes. Format: Script-Literal oder Script-Variable

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

Hinweise

Das Sprachmittel ändert ein Attribut eines Elements, welches sich im aktuell geöffneten XML-Dokument (XML_OPEN) befindet. Anzugeben ist dabei der Verweis auf das Element und Name + Wert des Attributs. Wird das angegebene Attribut nicht gefunden, so wird es dem Element neu hinzugefügt.

Beachten Sie das nur das Element geändert wird, welches sich im Speicher befindet. Die Dokumentations-Registerkarte beispielsweise wird nicht beeinflusst.

Wird vor dem Attributnamen das Zeichen "@" nicht angegeben, so kommt es zu einem Laufzeitfehler.

Beispiel

In folgendem Beispiel wird die strukturierte Dokumentations-Registerkarte als XML-Dokument geöffnet und das Element "Child" selektiert. Anschließend wird dem Element das neue Attribut "Attribute1" hinzugefügt. War das Hinzufügen erfolgreich, so wird das gesetzte Attribut zur Kontrolle nochmals ausgelesen und der Wert ins 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

:XML_CLOSE &XMLDOCU#

Siehe auch:

Script-Sprachmittel	Beschreibung
XML_OPEN	Öffnet ein XML-Dokument für die Bearbeitung.
:XML_CLOSE	Schließt ein XML-Dokument.

Script-Sprachmittel - Objekte lesen oder verändern

Strukturierte Dokumentation

www.w3c.org/TR/xmlbase

Beispiele
Ermittlung der Fehlermeldung und -nummer

Allgemeines zum Script
Script-Sprachmittel - Alphabetische Auflistung
Script-Sprachmittel -Funktionelle Gliederung

Automic Documentation - Tutorials - Automic Blog - Resources - Training & Services - Automic YouTube Channel - Download Center - Support