DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
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 XLS ou XLSX dans un fichier de données au format HFSQL Classic ou Client/Serveur (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.xls" 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
HImporteXLS(Client, "C:\MesFichiers\Client.xls",  1, "", hImpCréation, JAUGE_Jauge1)
Syntaxe
<Résultat> = HImporteXLS(<Fichier de données> , <Chemin du fichier XLS ou XLSX> [, <Numéro de feuille> [, <Liste des rubriques destination> [, <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 dans lequel l'importation doit être réalisée.
Remarque : Si le fichier de données HFSQL manipulé n'existe pas physiquement, ce fichier de données est automatiquement créé.
<Chemin du fichier XLS ou XLSX> : Chaîne de caractères
Chemin d'accès complet au fichier XLS ou XLSX à importer.
Linux Seuls les fichiers XLSX peuvent être manipulés.
<Numéro de feuille> : Entier optionnel
Numéro de la feuille du fichier XLS ou XLSX à importer.
Si ce paramètre n'est pas précisé, la première feuille du fichier XLS ou XLSX est importée.
<Liste des rubriques destination> : 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.
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 binaires et mémos binaires) dans l'ordre physique de description.
<Options> : Constante ou combinaison de constantes de type Entier (optionnelle)
Paramètre le type d'importation à effectuer :
hCopieIDAutoL'identifiant automatique est recopié. Il n'est pas recalculé.
hImpCréationSi le fichier de données d'importation existe, il est écrasé.
hImpIgnorePremièreLigneLa première ligne du fichier XLS importé est ignorée.
hImpIgnoreRubriqueVideSi une ou plusieurs rubriques ne sont pas renseignées dans le fichier XLS, les lignes correspondantes sont quand même importées.
Les rubriques manquantes contiennent :
  • soit la valeur par défaut des rubriques si la constante hValDéfaut est spécifiée.
  • soit la valeur des rubriques dans l'enregistrement en cours avant l'appel de la fonction HImporteXLS.
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éé.
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.
OLE DBConnecteurs Natifs (Accès Natifs) La gestion de l'intégrité et des doublons est toujours activée.
hImpTestDoublonActive la gestion des doublons sur les clés uniques lors de l'importation (la gestion des doublons est activée uniquement sur les clés uniques et non sur l'enregistrement complet).
OLE DBConnecteurs Natifs (Accès Natifs) La gestion des doublons est toujours activée.
hImpTestIntégritéTeste l'intégrité lors de l'importation.
OLE DBConnecteurs Natifs (Accès Natifs) La gestion de l'intégrité est toujours activée.
hValDéfautPour les rubriques non importées, les valeurs de l'enregistrement en cours sont réinitialisées :
  • soit avec leur valeur par défaut si la constante hValDéfaut est spécifiée.
  • soit avec la valeur des rubriques correspondantes dans l'enregistrement en cours avant l'appel de la fonction HImporteXLS si la constante hValDéfaut n'est pas spécifiée.
<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 utilisé pour afficher la progression.
WEBDEV - Code Serveur Ce paramètre n'est pas disponible.
Composante : wd300hf.dll
Version minimum requise
  • Version 20
Documentation également disponible pour…
Commentaires
Problème de mémoire sur les fichiers volumineux ?
Lorsque je tente d'importer par cette fonction, après l'importation de la dernière ligne, j'ai un crash de l'application, non récupérable. L'importation est bien effectuée, mais je dois relancer l'aplication.
Taille en cause > 25.000 lignes
Arbos
29 juil. 2017

Dernière modification : 25/05/2022

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