PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE


WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadApple WatchUniversal Windows 10 AppWindows Mobile
Autres
Procédures stockées
HImporteXLS (Fonction)
En anglais : HImportXLS
HFSQLHFSQL Client/ServeurDisponible uniquement avec ces types de connexion
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).
Versions 23 et supérieures
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
Nouveauté 23
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
WINDEVLinux Cette fonction est désormais disponible pour les applications WINDEV sous Linux.
WEBDEV - Code ServeurLinux Cette fonction est désormais disponible pour les sites WEBDEV sous Linux.
Exemple
// Importation du fichier "C:\MesFichiers\Client.xls" dans le fichier Client.
// Si le fichier Client existe, ce fichier 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(<Nom du fichier> , <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é.
<Nom du fichier> : Chaîne de caractères (avec ou sans guillemets)
Nom logique 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 avec guillemets
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 (avec guillemets) 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 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 ESC/ECHAP.
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 DBAccè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 DBAccès Natifs La gestion des doublons est toujours activée.
hImpTestIntégritéTeste l'intégrité lors de l'importation.
OLE DBAccè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> : Chaîne de caractères optionnelle (avec ou sans guillemets)
  • 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.
Composantes
WINDEVWEBDEV - Code Serveur wd230hf.dll
Linux wd230hf.so
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