PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

  • Présentation
  • Importer un fichier XSD dans un projet
  • Utiliser une description importé dans le projet
  • Exemple : Création complète d'un fichier se basant sur la description XSD donnée en exemple :
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
Présentation
WINDEV, WINDEV Mobile et WEBDEV mettent à votre disposition des fonctions permettant de manipuler du code XML. Le code XML manipulé doit être strictement conforme à la norme XML. Pour plus de détails, consultez une documentation spécifique sur XML. Pour plus de détails sur les fonctions WLangage, consultez la page d'aide XML.
Versions 15 et supérieures
WINDEV, WEBDEV et WINDEV Mobile permettent d'importer des fichiers au format XSD. Un fichier XSD contient la description du fichier XML de même nom. En effet, la connaissance de la structure d'un document XML permet notamment de vérifier la validité de ce document. Le langage de description de contenu d'un document XSD est aussi au format XML.
Un exemple de fichier XSD :
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<xsd:element name="personne">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="nom" type="xsd:string"/>
<xsd:element name="prenom" type="xsd:string"/>
<xsd:element name="date_naissance" type="xsd:date"/>
<xsd:element name="email" type="xsd:string" minOccurs="0" maxOccurs="unbounded" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
Suivi d'un fichier XML valide :
<?xml version="1.0" encoding="UTF-8"?>
<personne xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="personne.xsd">
<nom>de Latour</nom>
<prenom>Jean</prenom>
<date_naissance>1967-08-13</date_naissance>
<email>test@free.fr</email>
</personne>
Nouveauté 15
WINDEV, WEBDEV et WINDEV Mobile permettent d'importer des fichiers au format XSD. Un fichier XSD contient la description du fichier XML de même nom. En effet, la connaissance de la structure d'un document XML permet notamment de vérifier la validité de ce document. Le langage de description de contenu d'un document XSD est aussi au format XML.
Un exemple de fichier XSD :
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<xsd:element name="personne">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="nom" type="xsd:string"/>
<xsd:element name="prenom" type="xsd:string"/>
<xsd:element name="date_naissance" type="xsd:date"/>
<xsd:element name="email" type="xsd:string" minOccurs="0" maxOccurs="unbounded" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
Suivi d'un fichier XML valide :
<?xml version="1.0" encoding="UTF-8"?>
<personne xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="personne.xsd">
<nom>de Latour</nom>
<prenom>Jean</prenom>
<date_naissance>1967-08-13</date_naissance>
<email>test@free.fr</email>
</personne>
WINDEV, WEBDEV et WINDEV Mobile permettent d'importer des fichiers au format XSD. Un fichier XSD contient la description du fichier XML de même nom. En effet, la connaissance de la structure d'un document XML permet notamment de vérifier la validité de ce document. Le langage de description de contenu d'un document XSD est aussi au format XML.
Un exemple de fichier XSD :
<?xml version="1.0" encoding="UTF-8"?>
<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
<xsd:element name="personne">
<xsd:complexType>
<xsd:sequence>
<xsd:element name="nom" type="xsd:string"/>
<xsd:element name="prenom" type="xsd:string"/>
<xsd:element name="date_naissance" type="xsd:date"/>
<xsd:element name="email" type="xsd:string" minOccurs="0" maxOccurs="unbounded" />
</xsd:sequence>
</xsd:complexType>
</xsd:element>
</xsd:schema>
Suivi d'un fichier XML valide :
<?xml version="1.0" encoding="UTF-8"?>
<personne xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:noNamespaceSchemaLocation="personne.xsd">
<nom>de Latour</nom>
<prenom>Jean</prenom>
<date_naissance>1967-08-13</date_naissance>
<email>test@free.fr</email>
</personne>
Importer un fichier XSD dans un projet
Pour importer un fichier XSD dans un projet :
  1. Dans le volet "Explorateur de projet", sélectionnez "Descriptions XML".
  2. Faites un clic droit et sélectionnez l'option "Importer un fichier de description XML".
  3. Sélectionnez le fichier XSD de la description à importer.
  4. Validez. Le XSD est automatiquement ajouté dans l'explorateur de projet (dans la branche "Description XML"). Il est prêt à être utilisé.
Attention : Pour fonctionner en exécution, le fichier XSD ne doit pas être présent dans un sous-répertoire du projet ou dans un sous-répertoire de l'exécutable.
Utiliser une description importé dans le projet
Pour utiliser la description du document XML, il suffit d'utiliser les variables générées automatiquement par l'importation.
  1. Déclarez un document XML au format de la description qui a été importée. Par exemple, si la description importée se nomme 'personne' :
    cMonDoc est un xmlDocument <description="personne">

    Remarque : Il est possible d'indiquer l'extension du fichier lors de la déclaration. Par exemple :
    cMonDoc est un xmlDocument <description="personne.xsd">
  2. Initialisez les différentes variables composant la description du document XML. Par exemple, si le document est composé du nom et du prénom de la personne :
    cMonDoc.personne.nom = "DUPONT"
    cMonDoc.personne.prenom = "JEAN"

    Remarques :
    • Chaque élément est séparé par un point ..
    • Une assistance est proposée lors de la saisie des noms des variables.
    • Si le nom d'un élément contient un caractère spécial (tiret par exemple), il doit être entouré d'apostrophes (simples quotes) :
      cMonDoc.personne.'id-personne' = "ValeurId"
  3. Plusieurs fonctions permettent d'utiliser le fichier XSD pour valider la description du fichier XML :
    Versions 15 et supérieures
    XMLDocumentValide
    Nouveauté 15
    XMLDocumentValide
    XMLDocumentValide
    Valide un document XML à partir d’un schéma XSD.
    Versions 15 et supérieures
    XMLNoeudValide
    Nouveauté 15
    XMLNoeudValide
    XMLNoeudValide
    Valide un noeud XML, ses fils et ses attributs à partir de sa description dans le schéma XSD lié au document XML.
    Versions 15 et supérieures
    XMLSauve
    Nouveauté 15
    XMLSauve
    XMLSauve
    Sauvegarde un document XML dans un fichier.

Exemple : Création complète d'un fichier se basant sur la description XSD donnée en exemple :

cMonDoc est un xmlDocument <description="personne.xsd">

cMonDoc.personne.nom = "Dupont"
cMonDoc.personne.prenom = "Jean"
cMonDoc.personne.date_naissance = "19710211"
cMonDoc.personne.email[1] = "jean.dupont@mondomaine.com"
cMonDoc.personne.email[2] = "jean.dupont@autredomaine.com"

XMLSauve(cMonDoc, fRepExe() + ["\"] + "test.xml")

// Ou avec une vérification intermédiaire :
SI XMLDocumentValide(cMonDoc) = Vrai ALORS
        XMLSauve(cMonDoc, fRepExe() + ["\"] + "test.xml")
        SI ErreurDétectée = Vrai ALORS
                Erreur("Impossible de sauvegarder le document XML", ErreurInfo())
        SINON
                Info("OK", fRepExe() + ["\"] + "test.xml")
        FIN
SINON
        Erreur("Le document XML est invalide", ErreurInfo())
FIN
Version minimum requise
  • Version 15
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire