DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

PV

Aide / WLangage / Gestion des bases de données / HFSQL / Fonctions HFSQL
  • Importation d'une rubrique de type mémo texte
  • Importation d'une rubrique de type mémo binaire
  • Importation d'une rubrique indicée
  • Importation d'une rubrique de type Heure
  • Versions précédentes
WINDEV
WindowsLinuxJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac Catalyst
Autres
Procédures stockées
HImporteTexte (Fonction)
En anglais : HImportText
ODBCNon disponible avec ce type de connexion
Importe un fichier Texte 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).
Remarque : Si le fichier de données HFSQL manipulé n'existe pas physiquement, ce fichier de données est automatiquement créé.
Exemple
// Importe le nom, l'adresse et le logo (mémo binaire) des clients.
// On réinitialise les autres rubriques.
// Une ligne du fichier txt contient donc 3 ou 5 colonnes :
// - Nom, - Adresse, - Nom du fichier pour le logo
// (si le nom du fichier pour le logo est différent
// de chaîne vide, 2 colonnes supplémentaires)
// - Le type du mémo (IMG), - Un commentaire
SI HImporteTexte("CLIENT","C:\UnExemple\Client.txt", "NOM,ADRESSE,LOGO", hValDéfaut, "Jauge1") = Faux ALORS
	Erreur("Importation impossible")
SINON
	// Traitement
FIN
// Ce fichier sera importé
sCheminFichierTexte est une chaîne = "ImportJoueur.txt"

// Contenu de ce fichier (2 lignes) :
// "JoueurImport1","19850618"
// "JoueurImport2","19900512"

// sNomJoueur et dDateNaissance sont 2 rubriques du fichier Joueur de type chaîne et Date

SI HImporteTexte(Joueur, sCheminFichierTexte, "sNomJoueur,dDateNaissance", ...
    "," + Caract(127) + """" + Caract(127) + RC + Caract(127) + ".") ALORS
	...
SINON
	...
FIN
Syntaxe
<Résultat> = HImporteTexte(<Fichier de données> , <Chemin complet du fichier texte> , <Liste des rubriques> , <Séparateurs> [, <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'obtenir plus d'informations sur 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.
<Chemin complet du fichier texte> : Chaîne de caractères
Chemin d'accès complet au fichier texte à importer.
<Liste des rubriques> : Chaîne de caractères
Liste des noms des rubriques du fichier texte. 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" sont ignoré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) dans l'ordre physique de description.
<Séparateurs> : Chaîne de caractères
Liste des séparateurs utilisés pour les colonnes, les chaînes, les lignes et les décimales.
Les différents séparateurs sont séparés par le caractères caract(127) (pour compatibilité avec WINDEV 5.5).
<Séparateur de colonnes> + Caract(127) + <Séparateur de chaînes> + Caract(127) +
<Séparateur de lignes> + Caract(127) +<Séparateur de décimales>
  • <Séparateur de colonnes> : Chaîne de caractères (par défaut ",").
  • <Séparateur de chaînes> : Caractère (par défaut ")
  • <Séparateur de lignes> : Chaîne de caractères (par défaut RC, c'est-à-dire Caract(13)+Caract(10))
  • <Séparateur de décimales> : Caractère (par défaut "." ou ",")
<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é.
hImpCréationSi le fichier de données dans lequel l'importation est effectuée existe, il est écrasé.
hImpIgnorePremièreLigneLa première ligne du fichier importé est ignorée.
hImpIgnoreLigneInvalideLes lignes dont la structure est invalide ne sont pas importées : l'importation continue sur les lignes suivantes.
La structure est invalide s'il manque des données pour une ou plusieurs rubriques, ou s'il manque des séparateurs de chaîne.
hImpIgnoreRubriqueVideSi une ou plusieurs rubriques ne sont pas renseignées dans le fichier texte, 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 HImporteTexte.
hImpInterruptibleL'importation peut être interrompue avec la touche Echap du clavier (paramètre non pris en compte sur des fichiers de données au format 5.5).
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.
hImpNormal
(valeur par défaut)
Si le fichier de données dans lequel l'importation est effectuée 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 délimiteurs de chaînes sont utilisés.
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.
hImpOEM2ANSILes chaînes importées sont automatiquement converties d'OEM vers ANSI.
hImpSansDélimiteurLes séparateurs de chaînes, s'ils existent, font partie de la rubrique.
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 HImporteTexte 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.
Remarques
WINDEVHFSQL ClassicHFSQL Client/ServeurProcédures stockéesHyper File 5.5

Importation d'une rubrique de type mémo texte

  • Constante hImpSansDelimiteur non précisée :
    Le texte à importer peut contenir des <Séparateur de lignes> ou des <Séparateur de colonnes>. Le texte à importer ne peut pas contenir de <Séparateur de chaînes>.
  • Constante hImpSansDelimiteur précisée :
    Le texte à importer ne peut pas contenir des <Séparateur de lignes> ou des < Séparateur de colonnes> sinon ils seront pris en compte en tant que tels. Le texte à importer peut contenir des <Séparateur de chaînes>.
WINDEVJavaHFSQL ClassicHFSQL Client/ServeurProcédures stockéesHyper File 5.5

Importation d'une rubrique de type mémo binaire

Pour un rubrique de type mémo binaire, 3 colonnes sont associées dans le fichier texte.
  • Colonne 1 : chemin complet du fichier binaire à ajouter au mémo. C'est une chaîne de caractères. Si cette chaîne est vide alors les deux colonnes suivantes ne doivent pas être précisées dans le fichier texte.
  • Colonne 2 : type du mémo. C'est une chaîne de caractères qui vaut :
    • "IMG" pour indiquer que le fichier est de type image.
    • "WAV" pour indiquer que le fichier est de type son.
    • "OLE" pour indiquer que le fichier est de type OLE.
    • "BIN" ou autre pour indiquer que le fichier est un fichier binaire quelconque.
  • Colonne 3 : message d'information, correspondant à une chaîne de caractères de 65535 caractères maximum. Si le nombre de caractères est plus important, la chaîne est tronquée.
Structure du fichier texte à importer
Considérons l'exemple suivant :
  • rubriques à importer :
    • <NOM> : rubrique texte
    • <AGE> : rubrique numérique
    • <PRENOM> : rubrique texte
    • <COMMENTAIRE> : mémo texte
    • <PHOTO> : mémo binaire image
  • délimiteurs utilisés :
    • <Séparateur de chaîne> : "
    • <Séparateur de colonne> : ,
    • <Séparateur de ligne> : RC
Dans cet exemple :
  • Si la constante hImpSansDelimiteur est non précisée, le fichier texte aura la structure suivante : "NOM", AGE, "PRENOM", "COMMENTAIRE", "fichier du mémo PHOTO", "type du fichier PHOTO", "info du mémo PHOTO"+RC
  • Si la constante hImpSansDelimiteur est précisée, le fichier texte aura la structure suivante : NOM, AGE, PRENOM, COMMENTAIRE, fichier du mémo PHOTO, type du mémo PHOTO, info du mémo PHOTO+RC
Chaque contenu peut être vide.
WINDEVJavaHFSQL ClassicHFSQL Client/ServeurProcédures stockéesHyper File 5.5

Importation d'une rubrique indicée

La fonction HImporteTexte ne permet pas d'importer des rubriques indicées.
WINDEVJavaHFSQL ClassicHFSQL Client/ServeurProcédures stockéesHyper File 5.5

Importation d'une rubrique de type Heure

La fonction HImporteTexte enregistre des heures non valides si les heures à importer ne sont pas dans un des formats disponibles dans l'analyse.
Rappel : les formats disponibles dans l'analyse sont :
  • HH
  • HHMM
  • HHMMSS
  • HHMMSSCC
WINDEV

Versions précédentes

Cette fonction remplace la fonction HImporteTexte_55, conservée par compatibilité avec WINDEV 5.5.
Classification Métier / UI : Code métier
Composante : wd300hf.dll
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 19/09/2024

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