ECRITURE DIF

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 5


ECRITURE DIF ({laTable; }document)

ParamètreTypeDescription
laTableTableTable de laquelle effectuer l'export ou
Table par défaut si ce paramètre est omis
documentAlphaDocument DIF à exporter

Description

La commande ECRITURE DIF écrit dans document (document DIF Windows ou Mac OS) les données des enregistrements de la sélection courante de la table laTable du process courant.

L'opération d'export s'effectue par l'intermédiaire du formulaire sortie courant. L'opération d'export écrit les champs et les variables en fonction de l'ordre de saisie dans le formulaire sortie. C'est pourquoi vous devez veiller à utiliser un formulaire sortie ne contenant que les champs ou objets saisissables que vous voulez exporter. Ne placez pas de boutons ou autres objets sur le formulaire sortie. Les objets de sous-formulaire sont ignorés.

L'événement Sur chargement est envoyé à la méthode du formulaire pour chaque enregistrement exporté. Utilisez cet événement pour définir les variables utilisées dans le formulaire d'export.

Le paramètre document peut créer un nouveau document ou désigner un document existant. Si le document a le même nom qu'un document existant, ce dernier est remplacé. Le document peut contenir un chemin d'accès de volume et/ou de dossiers. Si vous passez une chaîne vide, la boîte de dialogue standard de sauvegarde de fichiers est affichée. Si l'utilisateur annule ce dialogue, l'opération d'export est annulée et la variable système OK est mise à 0.

Un thermomètre de progression est affiché pendant l'export. L'utilisateur peut annuler l'opération en cliquant sur le bouton Stop. Si l'export s'est correctement déroulé, la variable système OK est mise à 1. En cas d'erreur ou d'interruption de l'opération, la variable système OK est mise à 0. Vous pouvez cacher le thermomètre au moyen de la commande SUPPRIMER MESSAGES.

En mode Unicode (mode standard), la commande utilise par défaut le jeu de caractères UTF-8. Vous pouvez utiliser la commande UTILISER FILTRE pour modifier ce jeu de caractères.

En mode compatibilité ASCII, l'opération d'export utilise la table ASCII de la plate-forme de laquelle est effectué l'export, sauf si la commande UTILISER FILTRE a été préalablement utilisée.

Lors de l'utilisation de ECRITURE DIF, le délimiteur de champs par défaut est le caractère de tabulation (code 9). Le délimiteur d'enregistrement est par défaut le retour chariot (code 13). Vous pouvez modifier ces valeurs en assignant de nouvelles valeurs aux deux variables système FldDelimit et RecDelimit. L'utilisateur peut modifier ces valeurs par défaut dans le dialogue d'export du mode Développement. Comme les champs Texte peuvent contenir des retours chariot, soyez prudent si vous utilisez le retour chariot comme délimiteur entre les champs à exporter.

Exemple

Cet exemple exporte des données vers un document DIF. Cette méthode commence par le choix du formulaire sortie, puis effectue l'export :

   FORMULAIRE SORTIE([Personnes];"Export")
   ECRITURE DIF([Personnes];"Nouvelles Personnes.dif") ` Export vers le document "Nouvelles Personnes.dif"

Référence

ECRITURE SYLK, EXPORTER TEXTE, LECTURE DIF, UTILISER FILTRE.

Variables et ensembles Système

OK prend la valeur 1 si l'export s'est correctement déroulé, sinon elle prend la valeur 0.


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