PC SOFT - Documentation en ligne
Version : 18.0
Communauté : 0 annotation | Annoter Flux RSS
Cette page est également disponible pour : WINDEV, WEBDEV
Version affichée :
HImporteHF55 (Fonction)
En anglais : HImportHF55

 
WinDev WebDev - Code Serveur WebDev - Code Navigateur WinDev Mobile Etats et Requêtes   Windows Linux Windows Mobile Windows Phone Android Widget Android iPhone/iPad Windows Store apps   Java PHP Ajax Code Utilisateur (MCU) Langage Externe   HyperFileSQL HyperFileSQL Client/Serveur Procédures stockées Hyper File 5.5 OLE DB ODBC Accès Natifs

Importe un fichier de données Hyper File 5.5 dans un fichier de données au format HyperFileSQL 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 HyperFileSQL Classic doit être décrit sous l'éditeur d'analyses ou être déclaré par les fonctions HDéclare, HDéclareExterne ou HDécritFichier.

Remarque : Les deux fichiers de données peuvent avoir des structures différentes.

 
// 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,ADDR", ...
        hValDéfaut + hImpConversion) ALORS
                  Erreur("Importation impossible")
SINON
        // Traitement
        ...
FIN

Masquer les détails

Importation dans un fichier de données de même structure

<Résultat> = HImporteHF55(<Nom du fichier HyperFileSQL Classic> , <Nom du 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é.
<Nom du fichier HyperFileSQL Classic> : Chaîne de caractères
Nom logique du fichier de données au format HyperFileSQL Classic dans lequel l'importation doit être réalisée.
<Nom du 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)
Paramètre le type d'importation à effectuer :

hCopieIdAutoL'identifiant automatique est recopié. Il n'est pas recalculé.
Si le fichier de données HyperFileSQL 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 HyperFileSQL Classic.
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 HyperFileSQL 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 (HyperFileSQL 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.
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 (HyperFileSQL Classic) existe, il est écrasé.
hImpIgnoreRubriqueLes rubriques du fichier de données d'importation (HyperFileSQL 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.
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 (HyperFileSQL Classic) sont réinitialisées avec leur valeur par défaut.
<Jauge> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Nom de la fenêtre dans laquelle la jauge doit être affichée, ou nom du champ de type Jauge.
Masquer les détails

Importation dans un fichier de structure différente

<Résultat> = HImporteHF55(<Nom du fichier HyperFileSQL Classic> , <Nom du 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é.
<Nom du fichier HyperFileSQL Classic> : Chaîne de caractères
Nom logique du fichier de données au format HyperFileSQL Classic dans lequel l'importation doit être réalisée.
<Nom du 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 HyperFileSQL 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)
Paramètre le type d'importation à effectuer :

hCopieIdAutoL'identifiant automatique est recopié. Il n'est pas recalculé.Si le fichier de données HyperFileSQL 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 HyperFileSQL Classic.
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 HyperFileSQL 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 (HyperFileSQL 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.
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 (HyperFileSQL Classic) existe, il est écrasé.
hImpIgnoreRubriqueLes rubriques du fichier de données d'importation (HyperFileSQL 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.
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 (HyperFileSQL Classic) sont réinitialisées avec leur valeur par défaut.
<Jauge> : Chaîne de caractères optionnelle (avec ou sans guillemets)
Nom de la fenêtre dans laquelle la jauge doit être affichée, ou nom du champ de type Jauge.

Fichier de données crypté

Si le fichier de données au format HyperFileSQL 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.

HyperFileSQL Client/Serveur

Si l'importation doit être effectuée dans un fichier de données HyperFileSQL 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, ...

 
Composantes :
WinDev WebDev - Code Serveur wd180hf.dll
Linux wd180hf.so
 
 
Version minimum requise : 9
Communauté : 0 annotation Flux RSS
Connectez-vous pour ajouter une annotation | Conditions Générales du service d'annotations