LECTURE DIF

version 5

LECTURE DIF ({laTable; }document)

La commande LECTURE DIF lit les données de document (document DIF Windows ou Mac OS) et les écrit dans la table laTable en créant de nouveaux enregistrements.

L'opération d'import s'effectue par l'intermédiaire du formulaire entrée courant. Les champs et les variables sont lus en fonction du plan où ils se trouvent dans le formulaire entrée. Soyez donc attentif à ce qui se trouve au premier ou au deuxième plan en matière d'objets (champs et variables) dans le formulaire. Le premier objet dans lequel des données sont importées doit être à l'arrière-plan du formulaire. Si le nombre de champs et de variables dans le formulaire ne correspond pas au nombre de champs à importer, les champs supplémentaires sont ignorés. Un formulaire entrée utilisé pour l'import ne peut contenir de boutons. Les objets de sous-formulaire sont ignorés.

Note : Un moyen de s'assurer que les données sont importées dans les bons objets est de sélectionner l'objet dans lequel sera importé le premier champ. Cet objet doit être au premier plan. Pour l'import dans le deuxième champ, placer ce champ devant le premier et ainsi de suite, pour tous les champs et variables. Le champ qui se trouve au premier plan est donc celui dans lequel sont placées les dernières données du document à importer.

L'événement Sur validation est envoyé à la méthode du formulaire pour chaque enregistrement importé. Utilisez cet événement pour copier les données des variables vers les champs, si vous utilisez des variables dans le formulaire d'import.

Le paramètre document peut contenir un chemin d'accès aux noms de volumes et de dossiers. Si vous passez une chaine vide, la boîte de dialogue standard d'ouverture de fichiers est affichée. Si l'utilisateur annule le dialogue, l'opération d'import est annulée et la variable système OK est mise à 0.

Un thermomètre de progression est affiché pendant l'import. L'utilisateur peut annuler l'opération en cliquant sur le bouton Stop. Les enregistrements déjà importés le resteront. Si l'import 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'import utilise la table ASCII de la plate-forme de laquelle est effectué l'import, sauf si la commande UTILISER FILTRE a été préalablement utilisée.

Lors de l'utilisation de LECTURE DIF, le délimiteur de champs par défaut est le caractère de tabulation (code 9). Le délimiteur d'enregistrements par défaut est le retour chariot (code 13). Vous pouvez modifier ces valeurs par défaut en assignant de nouvelles valeurs aux variables système FldDelimit et RecDelimit. L'utilisateur peut modifier ces valeurs par défaut dans la boîte de dialogue d'import 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 à importer.

Cet exemple importe des données d'un document DIF. Cette méthode commence par le choix du formulaire, puis effectue l'import :

   FORMULAIRE ENTREE([Personnes]; "Import")
   LECTURE DIF([Personnes];"Nouvelles Personnes.dif") ` Import du document "Nouvelles Personnes.dif" 

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

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