IMPORTER DONNEES

4D - Documentation   Français   English   German   Español   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant

version 2003 (Modifiée)


IMPORTER DONNEES (nomFichier{; projet{; *}})

ParamètreTypeDescription
nomFichierAlphaChemin d'accès et nom du fichier à importer
projetBLOBContenu du projet d'import
Nouveau contenu du projet d'import (si le
paramètre * a été passé)
**Affichage de la boîte de dialogue d'import
et mise à jour du projet

Description

La commande IMPORTER DONNEES permet d'importer des données depuis le fichier nomFichier. 4D peut importer des données au format Texte, Texte de longueur fixe, XML, SYLK, DIF, DBF (dBase), et 4D.

Si vous passez une chaîne vide dans le nomFichier, IMPORTER DONNEES provoque l'affichage d'une boîte de dialogue standard d'ouverture de fichiers, permettant à l'utilisateur de sélectionner le fichier d'import. Une fois la boîte de dialogue validée, la variable système Document contient le chemin d'accès et le nom du fichier d'import. Si l'utilisateur clique sur le bouton Annuler, l'exécution est stoppée et la variable système OK prend la valeur 0.

Si vous ne passez pas le paramètre optionnel projet, la boîte de dialogue de paramétrage d'import s'affiche. L'utilisateur peut définir ses paramètres d'import ou charger un projet existant.

Note : Un projet d'import contient tous les paramètres de l'import, tels que les tables et champs d'arrivée, les délimiteurs, etc. Vous définissez ces paramètres dans la boîte de dialogue d'import. Un projet peut être sauvegardé sur disque et chargé. Pour plus d'informations sur cette boîte de dialogue, reportez-vous au manuel Mode Développement.

Si vous passez dans le paramètre projet un BLOB contenant un projet d'import valide, l'import s'effectue directement, sans intervention de l'utilisateur.

Dans ce cas, le projet doit avoir été préalablement défini dans la boîte de dialogue de paramétrage d'import, puis conservé. Pour cela, vous disposez de deux solutions :

- le sauvegarder sur disque, puis le charger à l'aide de la commande DOCUMENT VERS BLOB dans le champ ou la variable BLOB que vous passez dans le paramètre projet.

- utiliser la commande IMPORTER DONNEES avec un paramètre projet vide et le paramètre optionnel *, puis stocker le paramètre projet dans un champ BLOB (cf. ci-dessous). Cette solution permet, d'une part, de le conserver avec le fichier de données, et d'autre part d'éviter la phase de chargement dans un BLOB depuis le disque.

Note : Reportez-vous à la commande EXPORTER DONNEES pour un exemple de définition de projet vide.

Le paramètre optionnel *, s'il est est spécifié, provoque l'affichage de la boîte de dialogue de paramétrage d'import avec les paramétrages définis dans le projet. Ce fonctionnement permet d'utiliser un projet prédéfini, tout en ayant la possibilité de modifier un ou plusieurs paramètres. En outre, le paramètre projet contient, après la fermeture de la boîte de dialogue d'import, les paramètres du "nouveau" projet. Vous pouvez alors le stocker dans un champ BLOB, sur disque, etc.

Si l'import se déroule correctement, la variable système OK prend la valeur 1.

Référence

EXPORTER DONNEES, IMPORTER TEXTE, LECTURE DIF, LECTURE SYLK.

Variables et ensembles système

Si l'utilisateur clique sur Annuler dans une des boîtes de dialogue (de sélection de projet ou de paramétrage d'import), la variable système OK prend la valeur 0. Si l'import se déroule correctement, la variable système OK prend la valeur 1.


4D - Documentation   Français   English   German   Español   4D v11 SQL, Commandes par thèmes   4D v11 SQL, Liste alphabétique des commandes   4D v11 SQL, Constantes par thèmes   Retour   Précédent   Suivant