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

XML_PRINTINTOFILE

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

Syntaxe

XML_PRINTINTOFILE (File, Reference)

Syntaxe

Description / format

Fichier

Nom et chemin du fichier XML
Format : littéral de script ou variable de script

Référence

Référence à l'élément dont vous souhaitez afficher la structure
Format : littéral de script ou variable de script


Code retour

"0" - La structure a bien été écrite dans le fichier.

Commentaires

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.

Exemple

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

XML_BEAUTIFY

Préparation du style d'affichage de la structure d'un élément.

Eléments de script - Lecture ou modification d'objets

Documentation structurée

www.w3c.org/TR/xmlbase

Généralités sur les scripts
Eléments de script - Liste alphabétique

Eléments de script - Répartition fonctionnelle