Manuel des Scripts Automation Engine > Organisation fonctionnelle > Lecture ou modification d'objets > XML_TO_STRING

XML_TO_STRING

Fonction de script : Renvoie le XML d'un élément spécifique sous forme de texte.

Syntaxe

XML_TO_STRING(reference)

Elément de syntaxe

Description / format

Référence

Référence à l'élément.
Format : littéral de script ou variable de script


 

Code retour

XML de la référence saisie, sous forme de chaîne de caractères.

Remarques

L'élément de script convertit la structure XML d'un élément spécifié en chaîne de caractères qui est ensuite enregistrée dans une variable de script, par exemple, pour pouvoir être traitée ultérieurement. La référence à l'élément XML correspondant doit également être spécifiée. Tous les sous-éléments de l'élément spécifié seront également pris en compte.

La référence doit référencer un élément XML et peut être déterminée à l'aide d'un élément de script XML (tel que XML_GET_FIRST_CHILD ou XML_SELECT_NODE.

Il est également possible de modifier l'ensemble du document XML capturé via XML_OPEN.

Exemple

Dans l'exemple suivant, l'onglet Documentation structurée est ouvert sous forme de document XML. L'ensemble du document XML est ensuite converti en chaîne de caractères qui sera enregistrée dans une variable de script. La chaîne de caractères "test" sera remplacée par "prod" dans la variable de script.
Le nouveau document XML de la variable de script sera réouvert sous forme de document XML après fermeture du document XML et écriture de ses éléments (sur le premier niveau) dans une boucle du rapport d'activation.

: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


Rubriques connexes :

Elément de script Description
XML_OPEN Ouvre un document XML en vue du traitement
:XML_CLOSE Ferme un document XML