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
HExporteXML(CLIENT, "C:\TEMP\Client.xml", hExpCréation)
UneRequête est une Requête SQL =
[
	SELECT * FROM FicTest
]
SI PAS HExécuteRequête(UneRequête) ALORS
	Trace(HErreurInfo())
SINON
	SI PAS HExporteXML(UneRequête, "FicTest.xml", hExpCréation) ALORS
		Trace(HErreurInfo())
	FIN
FIN
Syntaxe
<Résultat> = HExporteXML(<Fichier de données> [, <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.
<Fichier de données> : Chaîne de caractères
Nom du fichier de données, de la vue ou de la requête manipulé. Si ce nom n'est pas spécifié, la fonction HExporteXML va manipuler le dernier fichier de données utilisé par la dernière fonction de gestion HFSQL (fonction commençant par la lettre H).
<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 <Fichier de données>.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 HExécuteRequête) avant d'utiliser la fonction HExporteXML.

Exporter un seul enregistrement

Pour exporter un seul enregistrement vers une chaîne XML, utilisez la fonction HEnregistrementVersXML.

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 : wd300hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Variable de type Requête SQL
L'export ne s'occupe que du premier enregistrement.
Laurent
27 sep. 2022

Dernière modification : 03/06/2024

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