DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion des fichiers XML
  • Cas particuliers
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Renvoie la valeur d'un élément XML ou la valeur de l'attribut d'un élément XML.
Exemple
MonDoc est une chaîne = fChargeTexte("exemple.xml")
XMLDocument("DOM", MonDoc)
sNomFonction est une chaîne = XMLLit("DOM","/Exemple/Aide/Fonction")
sTypeFonction est une chaîne = XMLLit("DOM","Aide/Fonction/@type")
sNomFonction2 est une chaîne = XMLLit("DOM","Aide/Fonction[2]")
sImage est une chaîne = XMLLit("DOM","Aide[2]/@image")
sTypeImage est une chaîne = XMLLit("DOM","/Exemple/Aide[@image=""trait.jpg""]/@format", "NonDefini")
XMLTermine("DOM")
// S'applique au document XML suivant:
// <Exemple>
// <Aide>
// <Fonction type="1">Lire</Fonction>
// <Fonction>Ecrire</Fonction>
// </Aide>
// <Aide image="trait.jpg" format="jpg" />
// </Exemple>
Syntaxe
<Résultat> = XMLLit(<Document XML> , <Chemin de l'élément à lire> [, <Non trouvé>])
<Résultat> : Chaîne de caractères
  • Valeur de l'élément ou de l'attribut,
  • Chaîne vide ("") ou la valeur du paramètre <Non trouvé> dans les cas suivants :
    • si l'élément n'a pas été trouvé.
    • si l'élément n'a pas de valeur
    • si la requête XPath n'est pas une requête de sélection d'enregistrements.
      Dans ce cas, la variable ErreurDétectée est à Vrai et la fonction ErreurInfo permet d'obtenir plus de détails sur l'erreur.
<Document XML> : Chaîne de caractères
Nom du document XML dans lequel la lecture doit être effectuée. Ce document contient le code XML à analyser et a été créé avec la fonction XMLDocument.
<Chemin de l'élément à lire> : Chaîne de caractères
Peut correspondre :
  • au chemin dans le XML de la valeur à lire. Attention : la casse utilisée est prise en compte (minuscules et majuscules). Pour lire la valeur d'un attribut, il suffit de faire précéder le nom de l'attribut par le caractère "@".
  • au texte d'une requête XPath à exécuter. La requête XPath doit être de type "sélection d'enregistrements". Si plusieurs éléments répondent à la sélection, le premier trouvé est utilisé.
Si ce chemin ne commence pas par "/", le nom du noeud racine est automatiquement ajouté. Si le document XML n'a pas de racine, <Résultat> correspond à <Non trouvé>.
<Non trouvé> : Chaîne de caractères optionnelle
Texte à renvoyer si l'élément n'a pas été trouvé. Par défaut, ce paramètre correspond à une chaîne vide ("").
Remarques

Cas particuliers

  • La fonction XMLLit ne modifie pas la position courante dans le document.
  • Il n'est pas possible d'imbriquer plusieurs requêtes XML de parcours.
  • La fonction XMLLit ne doit pas être utilisée avec une variable de type XMLDocument. Pour lire le contenu d'une variable de type XMLDocument, utilisez la syntaxe "POUR TOUT".
Classification Métier / UI : Code métier
Composante : wd290xml.dll
Version minimum requise
  • Version 12
Documentation également disponible pour…
Commentaires
CDATA
A noter : Si le contenu Xml est indiqué comme étant un CDATA :
<url><![CDATA[https://MonTest.fr?key=Test&_edit=123456]]></url>
La fonction XmlLit retourne vide, c'est normal
Pour récupérer le contenu, il faut utiliser XMLExtraitChaîne
Emmanuel LANGUEBIEN
26 mai 2023

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale