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

XML_SET_NODE_TEXT

Script-Funktion: Ändert bzw. setzt den Wert eines XML-Elements.

Syntax

XML_SET_NODE_TEXT(element, value)

Syntaxteil

Beschreibung/Format

Element

Verweis auf das Element, dessen Wert geändert/gesetzt werden soll.
Format: Script-Literal oder Script-Variable

Wert Wert für das Element
Format: Script-Literal oder Script-Variable


 

Rückgabewert

'0' - Der Wert des Elements wurde erfolgreich gesetzt.

Hinweise

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.

Beispiel

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.

 


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

Copyright © 2016 Automic Software GmbH