PC SOFT

DOCUMENTATION EN LIGNE
DE WINDEV, WEBDEV ET WINDEV MOBILE

  • 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
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
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éé.
Versions 18 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Nouveauté 18
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Windows Store apps.
Versions 21 et supérieures
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Nouveauté 21
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
WINDEVWINDEV MobileUniversal Windows 10 App Cette fonction est désormais disponible en mode Universal Windows 10 App.
Remarque : A partir de la version 19, HFSQL est le nouveau nom de HyperFileSQL.
Versions 22 et supérieures
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
Nouveauté 22
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
WINDEV MobileiPhone/iPad Cette fonction est désormais disponible pour les applications iPhone/iPad.
WINDEV MobileWidget Android Cette fonction est désormais disponible en mode Widget Android.
WINDEV MobileAndroid Cette fonction est désormais disponible pour les applications Android.
WINDEVJava Cette fonction est désormais disponible pour les applications Java.
Exemple
// Importe le nom, l'adresse et le logo (mémo binaire) des clients.
// On réinitialise les autres rubriques.
// Une ligne du fichier d'importation 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(<Nom du fichier> , <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é.
<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.
<Chemin complet du fichier texte> : Chaîne de caractères (avec guillemets)
Chemin d'accès complet au fichier texte à importer.
<Liste des rubriques> : Chaîne de caractères (avec guillemets)
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ées 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 (avec guillemets)
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 d'importation existe, il est écrasé.
Versions 20 et supérieures
hImpIgnorePremièreLigne
Nouveauté 20
hImpIgnorePremièreLigne
hImpIgnorePremièreLigne
La 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 si 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 ESC/ECHAP (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 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 délimiteurs de chaînes sont utilisés.
Les identifiants automatiques sont recalculés.
OLE DBAccès Natifs La gestion de l'intégrité et des doublons est toujours activée.
hImpOEMVersANSILes 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 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 HImporteTexte 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 ou nom du champ de type Jauge utilisé pour afficher la progression.
WEBDEV - Code Serveur Ce paramètre n'est pas disponible.
Remarques
WINDEVWEBDEV - Code ServeurUniversal Windows 10 AppAjaxHFSQLHFSQL 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 ligne> ou des <séparateur de colonne>. Le texte à importer ne peut pas contenir de <délimiteur de chaîne>.
  • Constante hImpSansDelimiteur précisée :
    Le texte à importer ne peut pas contenir des <séparateur de ligne> ou des < séparateur de colonne> sinon ils seront pris en compte en tant que tels. Le texte à importer peut contenir des <délimiteur de chaîne>.
WINDEVWEBDEV - Code ServeurAndroidWidget AndroidUniversal Windows 10 AppJavaAjaxHFSQLHFSQL 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. C'est une chaîne de caractères (65535 caractères maximum. Si plus grand, la chaîne est tronquée).
Structure du fichier texte à importer :
Soit les rubriques suivantes à importer :
  • <NOM> : rubrique texte
  • <AGE> : rubrique numérique
  • <PRENOM> : rubrique texte
  • <COMMENTAIRE> : mémo texte
  • <PHOTO> : mémo binaire image
Soit les délimiteurs suivants utilisés :
  • <délimiteur de chaîne> : "
  • <séparateur de colonne> : ,
  • <séparateur de ligne> : RC
Si la constante hImpSansDelimiteur est non précisée : "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 : 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.
WINDEVWEBDEV - Code ServeurAndroidWidget AndroidUniversal Windows 10 AppJavaAjaxHFSQLHFSQL 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.
WINDEVWEBDEV - Code ServeurAndroidWidget AndroidUniversal Windows 10 AppJavaAjaxHFSQLHFSQL 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
Composantes
WINDEVWEBDEV - Code Serveur wd220hf.dll
Java wd220java.jar
Linux wd220hf.so
Android wd220android.jar
Version minimum requise
  • Version 9
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire