Script-Funktion: Ändert bzw. setzt den Wert eines XML-Elements.
XML_SET_NODE_TEXT(element, value)
Syntaxteil |
Beschreibung/Format |
---|---|
Element |
Verweis auf das Element, dessen Wert geändert/gesetzt werden soll. |
Wert | Wert für das Element Format: Script-Literal oder Script-Variable |
Rückgabewert |
---|
'0' - Der Wert des Elements wurde erfolgreich gesetzt. |
Das Sprachmittel setzt den Wert eines bestimmten Elements, welches sich innerhalb des aktuell geöffneten XML-Dokuments befindet. Besitzt das Element bereits einen Wert, so wird dieser geändert. Anzugeben ist dabei der Verweis auf das Element und der neue Wert.
Durch die Script-Funktion wird das Element nur im Speicher verändert. Die Dokumentations-Registerkarte beispielsweise wird nicht beeinflusst.
Zeilenumbrüche sind im Wert des Elements ebenfalls erlaubt. Um Zeilenumbrüche einzufügen, verwenden Sie das Sprachmittel UC_CRLF.
Folgendes Beispiel öffnet die strukturierte Dokumentations-Registerkarte als XML-Dokument, ermittelt das erste Element und gibt deren Wert im Aktivierungsprotokoll aus. Anschließend wird der Wert des Elements verändert. Ist dies erfolgreich, so wird zur Kontrolle der neue Wert ermittelt und ebenfalls in den Aktivierungsreport geschrieben.
:SET &XMLDOCU#=XML_OPEN(DOCU,,"@Details")
:IF &XMLDOCU# <> ""
:SET &ELEMENT# = XML_GET_FIRST_CHILD(&XMLDOCU#)
:SET &VALUE# = XML_GET_NODE_TEXT(&ELEMENT#)
:P "Alter Wert: &VALUE#"
:SET &RET# = XML_SET_NODE_TEXT(&ELEMENT#,"New Node Text")
:IF &RET# = 0
:SET &VALUE# = XML_GET_NODE_TEXT(&ELEMENT#)
:P "New Value: &VALUE#"
:ENDIF
:ENDIF
:XML_CLOSE &XMLDOCU#
Beispielhafte Ausgabe im Aktivierungsprotokoll:
2013-08-14 13:32:27 – U0020408 Old Value: Old Node Text
2013-08-14 13:32:27 – U0020408 New Value: New Node Text
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
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 |
Copyright © 2016 Automic Software GmbH |