XML_PRINTINTOFILE

Fonction de script : Ecrit la structure des éléments dans un fichier XML

Syntaxe

XML_PRINTINTOFILE (File, Reference)

La fonction de script écrit la structure d'un élément et de tous ses sous-éléments dans un fichier XML donné.

Une référence doit être transmise à la fonction de script pour qu'elle puisse accéder à l'élément. Cette référence est fournie par des éléments de script qui peuvent être placés dans le document XML, tel que XML_GET_FIRST_CHILD, XML_GET_NEXTSIBLING ou XML_SELECT_NODE. La fonction de script écrit cet élément, ses sous-éléments et les attributs correspondants dans un fichier.

La référence retournée par XML_OPEN peut aussi être utilisée pour écrire toute la structure.

Les informations sur la structure de l'élément sont écrites les unes à la suite des autres (sans retour à la ligne) dans le fichier indiqué. Si vous ouvrez ce fichier avec un éditeur de texte tel que le Bloc-notes, l'information est inintelligible. Vous pouvez appliquer XML_BEAUTIFY avant d'utiliser la fonction de script pour formater le contenu du fichier de façon à ce qu'il soit plus lisible. Le fichier peut également être affiché dans Microsoft Internet Explorer. La structure de l'élément apparaît alors clairement.

Notez que si un fichier existe déjà, il est remplacé sans message de confirmation.

Exemple

La structure complète de la documentation est tout d'abord éditée afin d'être plus lisible, puis écrite dans le fichier "Docu.xml".

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

:SET &RET1# = XML_BEAUTIFY(&XMLDOCU#)
:SET &RET2# = XML_PRINTINTOFILE("C:\AUTOMIC\XML_Documentation\Docu.xml",&XMLDOCU#)

:XML_CLOSE

Le second exemple montre comment les éléments "Description" et "Objets" ainsi que leurs attributs peuvent être écrits dans un fichier.

:SET &XMLDOCU# = XML_OPEN(DOCU,"ON_CALL","@Details")

:SET &HND# = XML_GET_FIRST_CHILD(&XMLDOCU#)
:SET &RET1# = XML_BEAUTIFY(&HND#)
:SET &RET2# = XML_PRINTINTOFILE("C:\AUTOMIC\XML_Documentation\Docu.xml",&HND#)

:XML_CLOSE

Voir aussi :