DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Exporter le contenu d'une requête
  • Exporter un seul enregistrement
  • Rubriques tableau
  • Divers
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
Exporte les enregistrements d'un fichier de données (HFSQL ou OLE DB), d'une vue ou d'une requête dans un fichier XML.
Remarque : Une feuille de styles (fichier ".XSL") est automatiquement générée lors de la création du fichier XML.
Exemple
// Exporte tous les clients
Client.ExporteXML("C:\TEMP\Client.xml", hExpCréation)
UneRequête est une Requête SQL =
[
SELECT * FROM FicTest
]
SI PAS UneRequête.ExécuteRequête() ALORS
Trace(HErreurInfo())
SINON
SI PAS UneRequête.ExporteXML("FicTest.xml", hExpCréation) ALORS
Trace(HErreurInfo())
FIN
FIN
Syntaxe
<Résultat> = <Source>.ExporteXML([<Chemin du fichier XML> [, <Rubriques à exporter>]] [, <Options> [, <Jauge>]])
<Résultat> : Booléen
  • Vrai si l'opération a été réalisée,
  • Faux en cas de problème. La fonction HErreur permet d'identifier l'erreur.
<Source> : Type correspondant à la source spécifiée
Nom du fichier de données, de la vue ou de la requête manipulé.
<Chemin du fichier XML> : Chaîne de caractères optionnelle
Chemin complet du fichier XML à générer.
Si ce paramètre n'est pas spécifié, un fichier <Source>.XML sera généré dans le répertoire courant.
<Rubriques à exporter> : Chaîne de caractères optionnelle
Liste des noms des rubriques à exporter. Les noms sont délimités par de simples quotes et séparés par des virgules ou des RC. Les noms des rubriques de type clé composée, binaire, mémo binaire sont ignorés.
Si ce paramètre correspond à une chaîne vide (""), toutes les rubriques du fichier de données (sauf celles de type clé composée, binaire et mémo binaire) sont exportées.
<Options> : Constante optionnelle de type Entier
Mode de création du fichier XML :
hExpCréationSi le fichier d'exportation XML existe, il est écrasé. Si cette option n'est pas précisée et que le fichier XML existe, une erreur est générée.
hExpInterruptibleL'exportation peut être interrompue par la touche Echap du clavier.
Si l'exportation est interrompue, le fichier XML est valide et contient uniquement les enregistrements exportés avant interruption.
hExpNormal
(valeur par défaut)
Fonctionnement normal.
hExpSansXSLLa feuille de styles (fichier ".XSL") n'est pas créée.
<Jauge> : Nom de champ ou nom de fenêtre optionnel
Nom du champ de type Jauge ou nom de la fenêtre permettant de visualiser la progression de la création du fichier XML.
Remarques

Exporter le contenu d'une requête

Pour exporter le contenu d'une requête, il est nécessaire d'initialiser la requête (fonction <Source>.ExécuteRequête) avant d'utiliser la fonction <Source>.ExporteXML.

Exporter un seul enregistrement

Pour exporter un seul enregistrement vers une chaîne XML, utilisez la fonction <Source>.EnregistrementVersXML.

Rubriques tableau

Si une des rubriques exportées est une rubrique de type tableau, chaque élément de la rubrique tableau est exporté dans un nouveau niveau :
<FICHIER>
<RUB1>donnée de la rubrique 1</RUB1>
<RUB2>donnée de la rubrique 2</RUB2>
<RUBTAB>
<RUBTAB_1>donnée de l'élément 1</RUBTAB_1>
<RUBTAB_2>donnée de l'élément 2</RUBTAB_2>
<RUBTAB_3>donnée de l'élément 3</RUBTAB_3>
</RUBTAB>
...
</FICHIER>

Rappel : Les rubriques de type clé composée, mémo binaire ou binaire sont ignorées.

Divers

L'entité document du fichier XML généré se nomme HF_DOCUMENT.
Composante : wd290hf.dll
Version minimum requise
  • Version 25
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 20/06/2023

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