|
|
|
|
|
HImporteXLS (Fonction) En anglais : HImportXLS
 Disponible uniquement avec ces types de connexion
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
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.
<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: | | hCopieIDAuto | L'identifiant automatique est recopié. Il n'est pas recalculé. | hImpCréation | Si la table dans laquelle les données doivent être importées existe, elle est écrasée. | hImpIgnorePremièreLigne | La première ligne du fichier XLS importé est ignorée. | hImpIgnoreRubriqueVide | Si 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.
| hImpInterruptible | L'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.
| hImpTestDoublon | Active 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).
| 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 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.
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|