version 2003 (Modifiée)
EXPORTER DONNEES (nomFichier{; projet{; *}})
Paramètre | Type | Description | |
nomFichier | Alpha | Chemin d'accès et nom du fichier d'export | |
projet | BLOB | Contenu du projet d'export | |
Nouveau contenu du projet d'export (si le | |||
paramètre * a été passé) | |||
* | * | Affichage de la boîte de dialogue d'export et | |
mise à jour du projet |
Description
La commande EXPORTER DONNEES permet d'exporter des données dans le fichier nomFichier. 4D peut exporter 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, EXPORTER DONNEES provoque l'affichage d'une boîte de dialogue standard d'enregistrement de fichiers, permettant à l'utilisateur de définir le nom, le type et l'emplacement du fichier d'export. Une fois la boîte de dialogue validée, la variable système Document contient le chemin d'accès et le nom de ce fichier. 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'export s'affiche alors. L'utilisateur peut définir ses paramètres d'export ou charger un projet d'export existant.
Note : Un projet d'export contient tous les paramètres de l'export, tels que les tables et champs exportés, les délimiteurs, etc. Vous définissez ces paramètres dans la boîte de dialogue d'export. 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'export valide, l'export 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'export, 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 EXPORTER 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.
Le paramètre optionnel *, s'il est est spécifié, provoque l'affichage de la boîte de dialogue de paramétrage d'export 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'export, les paramètres du "nouveau" projet. Vous pouvez alors le stocker dans un champ BLOB, sur disque, etc.
Si l'export se déroule correctement, la variable système OK prend la valeur 1.
Exemple
Cet exemple crée un projet vide et y stockera les paramètres définis par l'utilisateur dans la boîte de dialogue d'export :
C_BLOB($exportParams) FIXER TAILLE BLOB($exportParams;0) `Initialisation du BLOB EXPORTER DONNEES("DocExport.txt";$exportParams;*) ` Affichage de la boîte de dialogue d'export
Référence
ECRITURE DIF, ECRITURE SYLK, EXPORTER TEXTE, IMPORTER DONNEES.
Variables et ensembles système
Si l'utilisateur clique sur Annuler dans une des boîtes de dialogue (d'enregistrement de projet ou de paramétrage d'export), la variable système OK prend la valeur 0. Si l'export se déroule correctement, la variable système OK prend la valeur 1.