|
|
|
|
|
- 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
HImporteTexte (Fonction) En anglais : HImportText
Non 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éé.
SI HImporteTexte("CLIENT","C:\UnExemple\Client.txt", "NOM,ADRESSE,LOGO", hValDéfaut, "Jauge1") = Faux ALORS
Erreur("Importation impossible")
SINON
FIN
sCheminFichierTexte est une chaîne = "ImportJoueur.txt"
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 : | | hCopieIDAuto | L'identifiant automatique est recopié. Il n'est pas recalculé. | hImpCréation | Si le fichier de données dans lequel l'importation est effectuée existe, il est écrasé. | hImpIgnorePremièreLigne | La première ligne du fichier importé est ignorée. | hImpIgnoreLigneInvalide | Les 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. | hImpIgnoreRubriqueVide | Si 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.
| hImpInterruptible | L'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.
| hImpOEM2ANSI | Les chaînes importées sont automatiquement converties d'OEM vers ANSI. | hImpSansDélimiteur | Les séparateurs de chaînes, s'ils existent, font partie de la rubrique. | 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 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.
Classification Métier / UI : Code métier
Documentation également disponible pour…
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|