DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Mode d'importation
  • Encodage
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
<Source>.JSONVersEnregistrement (Fonction)
En anglais : <Source>.JSONToRecord
HFSQL ClassicHFSQL Client/ServeurDisponible uniquement avec ces types de connexion
Importe des données JSON vers l'enregistrement courant.
Exemple
soit sChaîne1 = "{ ""Nom"":""Tintin"", ""Prenom"":[""Milou"", ""IDEFIX""] }"
soit b1 = Client.JSONVersEnregistrement(sChaîne1)
SI ErreurDétectée = Vrai ALORS
// Message complet de l'erreur principale
Trace(HErreurInfo())
// Parcours des sous-erreurs (s'il y en a)
POUR i = 1 _À_ ErreurInfo(errNombreSousErreur)
// Message complet de chaque sous-erreur
Trace("Sous-erreur " + i + " : " + ErreurInfo(errMessage, i))
FIN
FIN
Client.Ajoute()
Syntaxe
<Résultat> = <Fichier de données>.JSONVersEnregistrement(<Données JSON> [, <Liste des rubriques à importer> [, <Liste des "items" à importer>]])
<Résultat> : Booléen
  • Vrai si aucun problème n'a été rencontré pendant l'importation,
  • Faux dans le cas contraire. La fonction HErreurInfo permet d'obtenir plus d'informations sur le problème rencontré.
<Fichier de données> : Chaîne de caractères optionnelle
Nom du fichier de données HFSQL manipulé. Les données JSON sont importées dans l'enregistrement courant.
<Données JSON> : Chaîne de caractères ou variable de type JSON
Données JSON à convertir vers l'enregistrement. Ces données peuvent correspondre à une chaîne de caractères au format JSON ou à une variable de type JSON.
<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 JSON à importer. Si ce paramètre n'est pas précisé ou correspond à une chaîne vide (""), tous les items JSON sont importés.
Si une rubrique est manquante, une erreur non fatale est renvoyée.
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.

Encodage

L'encodage utilisé correspond au standard JSON :
  • utilisation d'un encodage en ASCII 7 bits, soit les 128 premiers caractères, les caractères non accentués,
  • utilisation d'un encodage JSON des autres caractères : "\u" suivit du code du caractère en hexadécimal sur 4.
Exemple : pour "é" (code ASCII 233, code hexadécimal E9), l'encodage correspond à "\u00E9".
Composante : wd290hf.dll
Version minimum requise
  • Version 26
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