DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
Importe un fichier XLS ou XLSX dans une table au format HFSQL Classic ou Client/Serveur (table décrite sous l'éditeur de schémas des données ou déclarée par les fonctions HDéclare, HDéclareExterne ou HDécritTable).
Nouveauté 2025
Java Cette fonction est désormais disponible pour les applications Java.
Exemple
// Importation de la table "C:\MesFichiers\Client.xls" dans la table Client. 
// Si la table Client existe, cette table sera écrasée (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(<Table> , <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é.
<Table> : Chaîne de caractères
Nom de la table au format HFSQL dans laquelle l'importation doit être réalisée.
Remarque: Si la table HFSQL manipulée n'existe pas physiquement, cette table est automatiquement créée.
<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 de la table dans laquelle 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 le schéma des données.
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 la table dans laquelle les données doivent être importées existe, elle est écrasée.
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 la table.
hImpNormal
(valeur par défaut)
Si la table dans laquelle les données doivent être importées existe déjà, elle est complétée avec les données importées, sinon la table est créée.
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.
Composante: wd300hf.dll
Version minimum requise
  • Version 20
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 07/12/2024

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