PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • 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
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
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.
Versions 17 et supérieures
iPhone/iPad Ce type de variable est désormais disponible pour les applications iPhone/iPad.
WINDEVJava Ce type de variable est désormais disponible pour les applications Java.
Android Ce type de variable est désormais disponible pour les applications Android.
Android Ce type de variable est désormais disponible à partir de Android version 2.2.
Nouveauté 17
iPhone/iPad Ce type de variable est désormais disponible pour les applications iPhone/iPad.
WINDEVJava Ce type de variable est désormais disponible pour les applications Java.
Android Ce type de variable est désormais disponible pour les applications Android.
Android Ce type de variable est désormais disponible à partir de Android version 2.2.
iPhone/iPad Ce type de variable est désormais disponible pour les applications iPhone/iPad.
WINDEVJava Ce type de variable est désormais disponible pour les applications Java.
Android Ce type de variable est désormais disponible pour les applications Android.
Android Ce type de variable est désormais disponible à partir de Android version 2.2.
Versions 21 et supérieures
Universal Windows 10 App Ce type de variable est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
Universal Windows 10 App Ce type de variable est désormais disponible en mode Universal Windows 10 App.
Universal Windows 10 App Ce type de variable est désormais disponible en mode Universal Windows 10 App.
Exemple
// 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 :
  1. Ajoutez le document XML dans le projet grâce à une des méthodes suivantes :
    • sélectionnez l'option "Projet .. Liste des éléments du projet" puis cliquez sur le bouton "Ajouter".sous le volet "Projet", dans le groupe "Projet", cliquez sur . La liste des éléments du projet s'affiche. Cliquez sur le bouton "Ajouter" et sélectionnez le document XML. 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 XML" du volet "Explorateur de projet".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 XML", puis l'option "Importer un fichier de description XML" du menu contextuel. dans le volet "Explorateur de projet", sélectionnez le dossier "Descriptions XML et XSD", puis l'option "Importer un XML dans ce projet" du menu contextuel. 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.
  2. Le document XML apparaît sous le dossier "Descriptions XML" de l'explorateur de projet. Il est possible de visualiser sa structure.Le document XML apparaît sous le dossier "Descriptions XML et XSD" de l'explorateur de projet. Il est possible de visualiser sa structure.Le document XML apparaît sous le dossier "Descriptions externes" de l'explorateur de projet. Il est possible de visualiser sa structure.
  3. 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 l'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>)
  4. 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 :
NomType manipuléEffet
EncodageChaîne de caractèresEncodage 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.
NoeudRacineTableau de xmlNoeudTableau 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.
VersionChaîne de caractèresVersion du format XML. Cette propriété vaut généralement "1.0".
Remarque : Ces propriétés peuvent être utilisées avec une des deux syntaxes suivantes :
  • <Nom de la variable>..<Nom de la propriété>
  • <Nom de la variable>.<Nom de la propriété>
AndroidJava Attention : L'ordre d'itération n'est pas nécessairement l'ordre de déclaration des attributs dans le document (généralement les attributs sont listés dans l'ordre alphabétique).

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îneRécupère et met en forme le contenu d'un document XML (créé avec la fonction XMLDocument et modifié grâce aux fonctions XML).
XMLDocumentValideValide un document XML à partir d’un schéma XSD.
XMLOuvreCharge un document XML à partir d'un fichier, d'une URL ou d'une chaîne dans une variable de type xmlDocument.
XMLSauveSauvegarde 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.
Version minimum requise
  • Version 15
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire