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

XML_TO_STRING

Script-Funktion: Liefert das XML eines bestimmten Elements als Text zurück.

Syntax

XML_TO_STRING(reference)

Syntaxteil

Beschreibung/Format

Verweis

Verweis auf das Element.
Format: Script-Literal oder Script-Variable


 

Rückgabewert

XML des angegebenen Verweises, in Form einer Zeichenkette.

Hinweise

Das Sprachmittel wandelt die XML-Struktur eines bestimmten Elementes in eine Zeichenkette um, die dann beipielsweise in eine Script-Variable gespeichert und zur weiteren Verarbeitung werden kann. Anzugeben ist dabei der Verweis auf das entsprechende XML-Element. Dabei werden auch alle Sub-Elemente des angegebenen Elements berücksichtigt.

Der Verweis muss auf ein XML-Element referenzieren und kann über XML-Sprachmittel (wie beispielsweise XML_GET_FIRST_CHILD oder XML_SELECT_NODE) ermittelt werden.

Möglich ist es auch das komplette XML-Dokument anzugeben, welches mit XML_OPEN ermittelt wird.

Beispiel

Folgendes Beispiel öffnet die strukturierte Dokumentations-Registerkarte als XML-Dokument. Anschließend wird das komplette XML-Dokument in eine Zeichenkette umgewandelt und diese in eine Script-Variable gespeichert. In dieser Script-Variable wird weiters die Zeichenkette "test" durch "prod" ausgetauscht.
Das neue XML in der Script-Variable wird nun erneut als XML-Dokument geöffnet, nachdem das alte XML-Dokument geschlossen wurde, und deren Elemente (auf erster Ebene) in einer Schleife in das Aktivierungsprotokoll geschrieben.

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

:IF &XMLDOCU# <>
""
 

:SET &XMLSTRING# = XML_TO_STRING(&XMLDOCU#)
:SET &XMLSTRINGNEW# = STR_SUB(&XMLSTRING#,"test","prod")


:ENDIF
:XML_CLOSE &XMLDOCU#

:SET &XMLDOCU#=XML_OPEN(STRING,&XMLSTRINGNEW#)

:SET &ELEMENT# = XML_GET_FIRST_CHILD(&XMLDOCU#)
:WHILE &ELEMENT# <> ""
: SET &NAME# = XML_GET_NODE_NAME(&ELEMENT#)
: P 'Element: &NAME#'
: SET &ELEMENT# = XML_GET_NEXTSIBLING(&ELEMENT#)
:ENDWHILE


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