|
|
|
|
|
|
|
|
|
|
- Déclaration d'une variable de type xmlDocument
- Propriétés spécifiques à la description des variables de type xmlDocument
- Utiliser l'indirection sur les chemins dans un document XML
- Fonctions utilisant les variables de type xmlDocument
xmlDocument (Type de variable) En anglais : xmlDocument (Type of variable)
Le type xmlDocument permet de manipuler simplement un fichier XML. Les caractéristiques de ce fichier peuvent être définies et modifiées à l'aide de différentes propriétés WLangage. Remarque : Pour plus de détails sur la déclaration de ce type de variable et l'utilisation des propriétés WLangage, consultez Déclaration d'une variable.
// Exemple utilisant le fichier XML suivant : piece_theatre.xml
// <?xml version="1.0"?>
// <PLAY>
// <TITLE>Titre de la piece</TITLE>
//
// <PERSONAE>
// <PERSONA>Un personnage</PERSONA>
// </PERSONAE>
//
// <ACT>
// <SCENE>
// <SPEAKER></SPEAKER>
// <LINE></LINE>
// </SCENE>
// </ACT>
// </PLAY>
Â
// Déclaration d'une variable xmlDocument utilisant un modèle de document
RomeoEtJuliette est un xmlDocument, description = "piece_theatre.xml"
Â
// Chargement d'un document XML depuis un fichier
RomeoEtJuliette = XMLOuvre("romeo_et_juliette.xml", depuisFichier)
Â
// Affichage du numéro de version du XML
Trace(RomeoEtJuliette..Version)
Â
// Affichage du titre de la pièce en accédant directement aux noeuds
Trace(RomeoEtJuliette.PLAY.TITLE)
Remarques Déclaration d'une variable de type xmlDocument Les variables de type xmlDocument peuvent être déclarées en indiquant un document exemple (un fichier XML) ou un document modèle (un fichier XSD). La structure de ce document sera lue par WINDEV, WEBDEV et WINDEV Mobile. Il sera ainsi possible de disposer de la complétion automatique sur les noms des noeuds directement dans l'éditeur de code. Pour déclarer une variable de type xmlDocument avec un document exemple : - Ajoutez le document XML dans le projet grâce à une des méthodes suivantes :
- sous le volet "Projet", dans le groupe "Projet", déroulez "
 Liste des éléments" et cliquez sur "Liste des éléments du projet". La liste des éléments du projet s'affiche. Cliquez sur le bouton "Ajouter" et sélectionnez le document XML. - réalisez un "Drag and Drop" du fichier vers le dossier "Descriptions externes" du volet "Explorateur de projet".
- dans le volet "Explorateur de projet", sélectionnez le dossier "Descriptions externes", puis sélectionnez :
- soit l'option "Importer un XML ou un JSON dans ce projet" du menu contextuel.
- soit l'option "Importer un XSD dans ce projet" du menu contextuel.
- Le document XML apparaît sous le dossier "Descriptions externes" de l'explorateur de projet. Il est possible de visualiser sa structure.
- Déclarez la variable de la façon suivante :
<Nom de la variable> est un xmlDocument , description = <Nom du document>
<Nom du document> peut correspondre au nom du document exemple (avec ou sans son extension) ou au nom du document modèle (avec ou sans son extension).
Remarques : - Cette déclaration peut être obtenue automatiquement en "droppant" le nom du document XML directement depuis le volet "Explorateur de projet".
- Dans le cas de l'utilisation d'un document exemple, il est également possible d'utiliser la syntaxe suivante :
<Nom de la variable> est un xmlDocument
<Nom de la variable> = XMLOuvre(<Nom du document>)
- Vous pouvez maintenant accéder directement aux noeuds de la variable par leurs noms. Ces noms sont proposés automatiquement par le mécanisme de complétion automatique de l'éditeur de code.
Remarque : La fonction XMLSauve permet de sauvegarder le document XML. Si un fichier XSD a été utilisé, il sera automatiquement pris en compte. Propriétés spécifiques à la description des variables de type xmlDocument Les propriétés suivantes peuvent être utilisées pour manipuler une variable de type xmlDocument : | | | | Nom | Type manipulé | Effet |
|---|
| Encodage | Chaîne de caractères | Encodage utilisé pour les chaînes de caractères du document XML. Si cette propriété n'est pas spécifiée ou vaut "" (chaîne vide), l'encodage UTF-8 est utilisé. C'est notamment le cas par exemple lors d'une conversion en chaîne avec la fonction XMLConstruitChaîne. | | NoeudRacine | Tableau de xmlNoeud | Tableau des noeuds racines du document XML.
Un document XML valide doit avoir un noeud racine unique. Toutefois, il est possible pendant la construction du document d'avoir plusieurs noeuds à la racine. | | Version | Chaîne de caractères | Version du format XML. Cette propriété vaut généralement "1.0". |
Utiliser l'indirection sur les chemins dans un document XML Il est possible d'utiliser les opérateurs d'indirection pour construire le chemin d'un élément dans un document XML. Exemple :
sDocXML est une chaîne = [
<?xml version="1.0" encoding="UTF-8"?>
<Document>
<InfoVersion>
<Version>21</Version>
<Millesime>2016</Millesime>
</InfoVersion>
</Document>
]
Â
xmlExemple est un xmlDocument = XMLOuvre(sDocXML, depuisChaîne)
Â
sParam est une chaîne = "WinDev_Param"
Â
// Lecture directe d'une information ...
Trace(xmlExemple.Document.InfoVersion.Version)
Â
// Lecture avec une partie du chemin XML contenu dans une variable
// (idem si rubrique d'un fichier, paramètre d'une fenêtre, méthode, ...)
sParamètre est une chaîne = "InfoVersion"
Trace ({"xmlExemple.Document." + sParamètre + ".Version"}) Fonctions utilisant les variables de type xmlDocument | | | XMLConstruitChaîne | Récupère et met en forme le contenu d'un document XML (créé avec la fonction XMLDocument et modifié grâce aux fonctions XML). | | XMLDocumentValide | Valide un document XML à partir d'un schéma XSD. | | XMLOuvre | Charge un document XML à partir d'un fichier, d'une URL ou d'une chaîne dans une variable de type xmlDocument. | | XMLSauve | Sauvegarde un document XML dans un fichier. |
Note : Le parcours d'une variable XMLDocument doit être effectué en utilisant la syntaxe POUR TOUT. La fonction XMLLit ne doit pas être utilisée.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|