Fonction de script : Ecrit la structure des éléments dans un fichier XML
XML_PRINTINTOFILE (File, Reference)
Syntaxe |
Description / format |
---|---|
Fichier |
Nom et chemin du fichier XML |
Référence |
Référence à l'élément dont vous souhaitez afficher la structure |
Code retour |
---|
"0" - La structure a bien été écrite dans le fichier. |
La fonction de script écrit la structure d'un élément et de tous ses sous-éléments dans un fichier XML donné.
Pour que la fonction de script accède à un élément, une référence doit lui être transmise. Cette référence est fournie par des éléments de script qui peuvent être placés dans le documentXML, tel que XML_GET_FIRST_CHILD, XML_GET_NEXTSIBLING ou XML_SELECT_NODE. La fonction de script affiche cet élément, ses sous-éléments et les attributs correspondants dans un fichier.
Vous pouvez également utiliser la référence retournée par XML_OPEN pour afficher l'intégralité de la structure.
Les informations de la structure de l'élément sont écrites les unes à la suite des autres (sans retour à la ligne) dans le fichier indiqué. Ce fichier est par conséquent difficilement lisible si vous l'ouvrez avec un éditeur de texte tel que le Bloc-notes. Avant d'appliquer la fonction de script, vous pouvez utiliser XML_BEAUTIFY pour présenter 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.
Attention : si un fichier existe déjà, il est remplacé sans qu'aucun message de demande de confirmation n'apparaisse.
L'intégralité de la structure de la documentation est tout d'abord préparée afin d'être plus lisible, puis affichée 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 affiche dans un fichier les éléments "Description" et "Objets", ainsi que leurs attributs.
: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
Rubriques connexes :
Elément de script | Description |
---|---|
Préparation du style d'affichage de la structure d'un élément. |
Eléments de script - Lecture ou modification d'objets
Généralités sur les scripts
Eléments de script - Liste alphabétique
Eléments de script - Répartition fonctionnelle