DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Mode d'importation
  • Rubriques de type tableau
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
Importe un fichier JSON dans un fichier de données au format HFSQL Classic (fichier de données décrit sous l'éditeur d'analyses ou déclaré par les fonctions HDéclare, HDéclareExterne ou HDécritFichier).
Exemple
// Importation du fichier "C:\MesFichiers\Client.json" dans le fichier de données Client. 
// Si le fichier de données Client existe, ce fichier de données sera écrasé (constante hImpCréation)
// Une jauge de progression sera affichée dans le champ JAUGE_Jauge1
HImporteJSON(Client, "C:\MesFichiers\Client.json", "", "", hImpCréation, JAUGE_Jauge1)
Syntaxe
<Résultat> = HImporteJSON(<Fichier de données> , <Chemin du fichier JSON> [, <Liste des rubriques à importer> [, <Liste des "items" à importer> [, <Options> [, <Jauge>]]]])
<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 Classic dans lequel l'importation doit être réalisée. Si ce fichier n'existe pas physiquement, il est automatiquement créé.
<Chemin du fichier JSON> : Chaîne de caractères
Chemin d'accès complet au fichier JSON à importer.
<Liste des rubriques à importer> : 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 (Retour-Chariot). 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.
<Liste des "items" à importer> : Chaîne de caractères optionnelle
Liste des noms des items du fichier JSON à importer. Si ce paramètre n'est pas précisé ou correspond à une chaîne vide, tous les items du fichier JSON sont importés.
<Options> : Constante ou combinaison de constantes de type Entier (optionnelle)
Type d'importation à effectuer :
hImpCréationSi le fichier de données d'importation existe, il est écrasé.
hImpInterruptibleL'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 nom 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.
WEBDEV - Code Serveur Ce paramètre n'est pas disponible.
Remarques

Mode d'importation

Si la liste des items est précisée : l'importation recherchera des "items JSON" ayant le même nom que les rubriques.
Exemple : Le fichier de données décrit dans l'analyse contient les rubriques suivantes RUB1, RUB2, ... Le fichier JSON devra donc avoir une structure du type ci-dessous :
{"Fichier":
{
"Rubrique1":Donnée de la rubrique 1,
"Rubrique2":Donnée de la rubrique 2,
...
}
}
Les noms des items du fichier JSON qui n'existent pas dans l'analyse ou ne sont pas donnés dans la liste des rubriques seront ignorés lors de l'importation.
Si la liste des items JSON n'est pas précisée, la valeur des items JSON est mise dans la rubrique du fichier de données HFSQL qui porte le même nom que l'item JSON.

Rubriques de type tableau

La fonction HImporteJSON permet également d'importer des rubriques de type tableau.
Classification Métier / UI : Code métier
Composante : wd300hf.dll
Version minimum requise
  • Version 21
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 03/06/2024

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