|
|
|
|
|
|
|
|
|
|
- Mode d'importation
- Rubriques de type tableau
- Format du XML attendu
HImporteXML (Fonction) En anglais : HImportXML
  Disponible uniquement avec ces types de connexion
Importe un fichier XML dans un fichier de données au format HFSQL Classic ou Client/Serveur (fichier de données décrit sous l'éditeur d'analyses ou déclaré par les fonctions HDéclare, HDéclareExterne ou HDécritFichier). Syntaxe
<Résultat> = HImporteXML(<Fichier de données> [, <Chemin du fichier XML> , <Rubriques destination> [, <Attributs XML à  importer>]] [, <Options> [, <Jauge> [, <Noeud racine>]]])
<Résultat> : Booléen - Vrai si l'opération a été réalisée,
- Faux en cas d'erreur. La fonction HErreur permet d'identifier le problème rencontré.
<Fichier de données> : Chaîne de caractères Nom du fichier de données au format HFSQL dans lequel l'importation doit être réalisée. <Chemin du fichier XML> : Chaîne de caractères optionnelle Chemin d'accès complet au fichier XML à importer. <Rubriques destination> : Chaîne de caractères optionnelle Liste des noms des rubriques du fichier de données dans lequel l'importation est effectuée. Les noms peuvent être délimités par des simples quotes et sont séparés par des virgules ou RC. Les noms des rubriques de type clé composée, mémo binaire et de type binaire sont ignorés.
Les rubriques non importées seront initialisées avec leur valeur par défaut décrite dans l'analyse.
Si ce paramètre n'est pas précisé ou correspond à une chaîne vide, toutes les rubriques sont importées (sauf les clés composées, les rubriques binaire et mémos binaire) dans l'ordre physique de description. <Attributs XML à importer> : Chaîne de caractères optionnelle Liste des noms des rubriques du fichier XML à importer.
Si ce paramètre n'est pas précisé ou correspond à une chaîne vide, tous les noeuds du fichier XML sont importés. <Options> : Constante ou combinaison de constantes de type Entier (optionnelle) Paramètre le type d'importation à effectuer : | | | hImpCréation | Si le fichier de données d'importation existe, il est écrasé. | | hImpInterruptible | L'importation peut être interrompue par la touche Echap du clavier.
Si l'importation est interrompue, les enregistrements importés sont conservés dans le fichier de données. | hImpNormal
(valeur par défaut) | Si le fichier de données d'importation existe déjà , il est complété avec les données importées, sinon le fichier de données est créé. |
<Jauge> : Nom de champ ou de fenêtre optionnel - Nom de la fenêtre dans laquelle la jauge doit être affichée
- Nom du champ de type Jauge affichant la progression.
<Noeud racine> : Chaîne de caractères optionnelle Noeud du fichier XML à partir duquel l'importation doit être réalisée. Permet d'importer dans le fichier de données HFSQL uniquement une partie du fichier XML. Ce paramètre est du type "racine/clients". Remarques Rubriques de type tableau La fonction HImporteXML permet également d'importer des rubriques de type tableau. Pour cela, il est nécessaire que les éléments du tableau soit contenus dans des balises filles. Exemple : Le fichier de données décrit dans l'analyse contient les rubriques suivantes : RUB1, RUB2, RUBTABLEAU. La rubrique RUBTABLEAU est une rubrique tableau. La liste des rubriques données étant "RUB1+RUB2+RUBTABLEAU" et le fichier XML ayant la structure ci-dessous :
<FICHIER>
<RUB1>Donnée1</RUB1>
<RUB2>Donnée2</RUB2>
<RUBTABLEAU>
<!-- balises filles -->
<RUBTABLEAU_1>TabDonnée1</RUBTABLEAU_1>
<RUBTABLEAU_2>TabDonnée2</RUBTABLEAU_2>
</RUBTABLEAU>
</FICHIER>
... 'Données1' sera affectée 'RUB1', 'Données2' sera affectée 'RUB2', 'TabDonnée1' sera affectée à 'RUBTABLEAU[1]', 'TabDonnée2' sera affectée à 'RUBTABLEAU[2]'. Format du XML attendu La fonction HImporteXML attend un fichier XML utilisant une structure précise. Exemple :
<racine><?xml:namespace prefix = o ns = "urn:schemas-microsoft-com:office:office" />
<record>
<rub1>val</rub1>
<rub2>val</rub2>
</record>
<record>
<rub1>val</rub1>
<rub2>val</rub2>
</record>
</racine> Ce format est également utilisé par la fonction HExporteXML. Si votre fichier XML n'utilise pas cette structure, l'importation pourra ne pas être correctement réalisée. Vous obtiendrez par exemple un enregistrement par rubrique. Classification Métier / UI : Code métier
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|