Fonction de script : Renvoie le XML d'un élément spécifique sous forme de texte.
XML_TO_STRING(reference)
Elément de syntaxe |
Description / format |
---|---|
Référence |
Référence à l'élément. |
Code retour |
---|
XML de la référence saisie, sous forme de chaîne de caractères. |
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.
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 |
Élément de script – Lecture ou modification d'objets
Exemples
Détermination du message et du numéro de l'erreur
Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle