DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Fichier de données crypté
  • HFSQL Client/Serveur
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
HImporteHF55 (Fonction)
En anglais : HImportHF55
HFSQL ClassicHFSQL Client/ServeurDisponible uniquement avec ces types de connexion
Importe un fichier de données Hyper File 5.5 dans un fichier de données au format HFSQL Classic.
  • Le fichier de données au format Hyper File 5.5 doit être décrit sous l'éditeur d'analyses.
  • Le fichier de données au format HFSQL Classic doit être décrit sous l'éditeur d'analyses ou être déclaré par les fonctions HDéclare, HDéclareExterne ou HDécritFichier.
Remarques :
  • Les deux fichiers de données peuvent avoir des structures différentes.
  • Cette fonction n'est pas disponible lors de l'utilisation d'un exécutable autonome.
Exemple
// Importe le nom et l'adresse des clients,
// on ignore les autres rubriques
SI PAS HImporteHF55("CLIENT", "CLIENT", "C:\UnExemple\CLIENT.FIC", ...
			"", "C:\UnExemple\UnExemple.wdd", "", "NOMCOMPLET,ADRESSE", ...
			"NOM,ADR", hValDéfaut + hImpConversion) ALORS
		  Erreur("Importation impossible")
SINON
	// Traitement
	...
FIN
Syntaxe

Importation dans un fichier de données de même structure Masquer les détails

<Résultat> = HImporteHF55(<Fichier HFSQL Classic> , <Fichier HF55> , <Chemin complet du fichier HF55> , <Mot de passe du fichier HF55> , <Chemin complet du fichier WDD 55> , <Mot de passe du fichier WDD 55> [, <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 HFSQL Classic> : Chaîne de caractères
Nom logique du fichier de données au format HFSQL Classic dans lequel l'importation doit être réalisée.
<Fichier HF55> : Chaîne de caractères
Nom logique du fichier de données au format Hyper File 5.5, décrit dans l'analyse WINDEV 5.5 (fichier .WDD) et contenant les données à importer.
<Chemin complet du fichier HF55> : Chaîne de caractères
Chemin d'accès complet au fichier de données Hyper File 5.5 à importer.
<Mot de passe du fichier HF55> : Chaîne de caractères
Mot de passe associé au fichier de données à importer. Ce mot de passe sera utilisé pour décrypter les données du fichier de données. Si aucun mot de passe n'a été défini, utilisez une chaîne vide ("").
<Chemin complet du fichier WDD 55> : Chaîne de caractères
Chemin d'accès au fichier .WDD de l'analyse au format Hyper File 5.5. Cette analyse contient la description (ou structure) du fichier de données à importer. Tous les formats d'analyse reconnus par Hyper File 5.5 peuvent être utilisés (WINDEV 5.5B, 5.5, 5.0 et 4.1).
<Mot de passe du fichier WDD 55> : Chaîne de caractères
Mot de passe associé à l'analyse contenant le fichier de données à importer. Si aucun mot de passe n'a été défini, utilisez une chaîne vide ("").
<Options> : Constante ou combinaison de constantes de type Entier (optionnel)
Type d'importation à effectuer :
hCopieIDAutoL'identifiant automatique est recopié. Il n'est pas recalculé.
Si le fichier de données HFSQL Classic contient un identifiant automatique alors que le fichier de données Hyper File 5.5 n'en contient pas, l'identifiant automatique est mis à 0 dans le fichier de données HFSQL Classic.
hImpConversionLes rubriques associées n'ont pas le même type ou la même taille : les données extraites du fichier de données importé sont automatiquement converties ou tronquées.
hImpCréationSi le fichier de données d'importation (HFSQL Classic) existe, il est écrasé.
hImpIgnoreRubriqueLes rubriques du fichier de données d'importation (HFSQL Classic) n'ayant pas de rubriques associées dans le fichier de données importé (Hyper File 5.5) sont remplies avec leur valeur par défaut.
Les rubriques du fichier de données importé (Hyper File 5.5) n'ayant pas de correspondance dans le fichier de données d'importation sont ignorées.
hImpInterruptibleL'importation peut être interrompue avec la touche Echap du clavier. Si l'importation est interrompue, les enregistrements importés sont conservés dans le fichier de données. Une ré-indexation (non interruptible) est automatiquement réalisée si nécessaire.
hImpNormal
(valeur par défaut)
Ce mode d'importation évite tout risque de perte de données. L'importation n'est pas effectuée et une erreur est générée dans les cas suivants :
  • rubriques présentes dans le fichier de données Hyper File 5.5 sans correspondance dans le fichier de données HFSQL Classic.
  • rubriques associées dans les deux fichiers de données avec une taille et/ou un format différent.
Si le fichier de données d'importation (HFSQL Classic) existe déjà, il est complété avec les données importées, sinon le fichier de données est créé.
Pas de gestion d'intégrité ni de gestion de doublons.
Les rubriques non importées prennent la valeur de l'enregistrement en cours.
Les identifiants automatiques sont recalculés.
hImpSansEspaceLes espaces en fin de chaîne sont automatiquement supprimés pendant l'importation.
hImpTestDoublonTeste les doublons lors de l'importation
hImpTestIntégritéTeste l'intégrité lors de l'importation
hValDéfautPour les rubriques non importées, les valeurs de l'enregistrement en cours (HFSQL Classic) sont réinitialisées avec leur valeur par défaut.
<Jauge> : Nom de champ ou nom de fenêtre optionnel
  • Nom de la fenêtre dans laquelle la progression de l'importation doit être affichée.
  • Nom du champ de type Jauge dans lequel la progression de l'importation doit être affichée.

Importation dans un fichier de structure différente Masquer les détails

<Résultat> = HImporteHF55(<Fichier HFSQL Classic> , <Fichier HF55> , <Chemin complet du fichier HF55> , <Mot de passe du fichier HF55> , <Chemin complet du fichier WDD 55> , <Mot de passe du fichier WDD 55> , <Liste des rubriques destination> , <Liste des rubriques source> [, <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 HFSQL Classic> : Chaîne de caractères
Nom logique du fichier de données au format HFSQL Classic dans lequel l'importation doit être réalisée.
<Fichier HF55> : Chaîne de caractères
Nom logique du fichier de données au format Hyper File 5.5, décrit dans l'analyse WINDEV 5.5 (fichier .WDD) et contenant les données à importer.
<Chemin complet du fichier HF55> : Chaîne de caractères
Chemin d'accès complet au fichier de données Hyper File 5.5 à importer.
<Mot de passe du fichier HF55> : Chaîne de caractères
Mot de passe associé au fichier de données à importer. Ce mot de passe sera utilisé pour décrypter les données du fichier de données. Si aucun mot de passe n'a été défini, utilisez une chaîne vide ("").
<Chemin complet du fichier WDD 55> : Chaîne de caractères
Chemin d'accès au fichier .WDD de l'analyse au format Hyper File 5.5. Cette analyse contient la description (ou structure) du fichier de données à importer. Tous les formats d'analyse reconnus par Hyper File 5.5 peuvent être utilisés (WINDEV 5.5B, 5.5, 5.0 et 4.1).
<Mot de passe du fichier WDD 55> : Chaîne de caractères
Mot de passe associé à l'analyse contenant le fichier de données à importer. Si aucun mot de passe n'a été défini, utilisez une chaîne vide ("").
<Liste des rubriques destination> : Chaîne de caractères
Liste des noms des rubriques du fichier de données HFSQL Classic. Les noms peuvent être délimités par des simples quotes et sont séparés par des virgules ou RC.
Remarque : les noms correspondant à des clés composées sont interdits : les valeurs des clés composées seront re-calculées automatiquement lors de l'ajout de l'enregistrement dans le fichier de données.
<Liste des rubriques source> : Chaîne de caractères
Liste des noms des rubriques du fichier de données Hyper File 5.5. Les noms peuvent être délimités par des simples quotes et sont séparés par des virgules ou RC.
Remarque : les noms correspondant à des clés composées sont autorisés. Le nombre de rubriques doit correspondre au nombre de rubriques spécifié dans le paramètre <Liste des rubriques Destination>.
<Options> : Constante ou combinaison de constantes de type Entier (optionnel)
Type d'importation à effectuer :
hCopieIDAutoL'identifiant automatique est recopié. Il n'est pas recalculé.
Si le fichier de données HFSQL Classic contient un identifiant automatique alors que le fichier de données Hyper File 5.5 n'en contient pas, l'identifiant automatique est mis à 0 dans le fichier de données HFSQL Classic.
hImpConversionLes rubriques associées n'ont pas le même type ou la même taille : les données extraites du fichier de données importé sont automatiquement converties ou tronquées.
hImpCréationSi le fichier de données d'importation (HFSQL Classic) existe, il est écrasé.
hImpIgnoreRubriqueLes rubriques du fichier de données d'importation (HFSQL Classic) n'ayant pas de rubriques associées dans le fichier de données importé (Hyper File 5.5) sont remplies avec leur valeur par défaut.
Les rubriques du fichier de données importé (Hyper File 5.5) n'ayant pas de correspondance dans le fichier de données d'importation sont ignorées.
hImpInterruptibleL'importation peut être interrompue avec la touche ESC/ECHAP. Si l'importation est interrompue, les enregistrements importés sont conservés dans le fichier de données. Une ré-indexation (non interruptible) est automatiquement réalisée si nécessaire.
hImpNormal
(valeur par défaut)
Ce mode d'importation évite tout risque de perte de données. L'importation n'est pas effectuée et une erreur est générée dans les cas suivants :
  • rubriques présentes dans le fichier de données Hyper File 5.5 sans correspondance dans le fichier de données HFSQL Classic.
  • rubriques associées dans les deux fichiers de données avec une taille et/ou un format différent.
Si le fichier de données d'importation (HFSQL Classic) existe déjà, il est complété avec les données importées, sinon le fichier de données est créé.
Pas de gestion d'intégrité ni de gestion de doublons.
Les rubriques non importées prennent la valeur de l'enregistrement en cours.
Les identifiants automatiques sont recalculés.
hImpSansEspaceLes espaces en fin de chaîne sont automatiquement supprimés pendant l'importation.
hImpTestDoublonTeste les doublons lors de l'importation.
hImpTestIntégritéTeste l'intégrité lors de l'importation.
hValDéfautPour les rubriques non importées, les valeurs de l'enregistrement en cours (HFSQL Classic) sont réinitialisées avec leur valeur par défaut.
<Jauge> : Nom de champ ou nom de fenêtre optionnel
  • Nom de la fenêtre dans laquelle la progression de l'importation doit être affichée.
  • Nom du champ de type Jauge dans lequel la progression de l'importation doit être affichée.
Remarques

Fichier de données crypté

Si le fichier de données au format HFSQL Classic dans lequel l'importation doit être effectuée est crypté, il est nécessaire de préciser le mot de passe avant l'utilisation de la fonction HImporteHF55 : utilisez la fonction HPasse.

HFSQL Client/Serveur

Si l'importation doit être effectuée dans un fichier de données HFSQL Client/Serveur, il est nécessaire de préciser la connexion avant d'utiliser la fonction HImporteHF55. Par exemple :
HChangeConnexion(MonFichierCS, cnxHFCS)
HImporteHF55(MonFichierCS, MonFichier55, ...)
Composante : wd300hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 04/06/2024

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