|
|
|
|
|
- Fichier de données crypté
- HFSQL Client/Serveur
HImporteHF55 (Fonction) En anglais : HImportHF55
![HFSQL Classic HFSQL Classic](https://doc.pcsoft.fr/ext/images/fr/HF.png?-2134303037) Disponible 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.
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
...
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 :
| | hCopieIDAuto | L'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. | hImpConversion | Les 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éation | Si le fichier de données d'importation (HFSQL Classic) existe, il est écrasé. | hImpIgnoreRubrique | Les 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. | hImpInterruptible | L'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. | hImpSansEspace | Les espaces en fin de chaîne sont automatiquement supprimés pendant l'importation. | hImpTestDoublon | Teste les doublons lors de l'importation | hImpTestIntégrité | Teste l'intégrité lors de l'importation | hValDéfaut | Pour 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 : | | hCopieIDAuto | L'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. | hImpConversion | Les 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éation | Si le fichier de données d'importation (HFSQL Classic) existe, il est écrasé. | hImpIgnoreRubrique | Les 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. | hImpInterruptible | L'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. | hImpSansEspace | Les espaces en fin de chaîne sont automatiquement supprimés pendant l'importation. | hImpTestDoublon | Teste les doublons lors de l'importation. | hImpTestIntégrité | Teste l'intégrité lors de l'importation. | hValDéfaut | Pour 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, ...)
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|