Exploitation > Imports/Exports > Exports 

Cette fonction permet d’extraire des données de la base vers un fichier de type ascii en longueur fixe ou variable avec séparateurs, dont la structure est décrite par un modèle d’import/export. Cet export peut être total ou chronologique, c’est-à-dire en n’exportant que les données modifiées depuis le dernier export de ce type.

SEEINFO Les données exportées, si elles sont traduites, le seront dans la langue de connexion dudossier.

Pré-requis

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre

Gestion de l'écran

La fonction d'export s'appuie sur des modèles. Utilisez un modèle d'export qui correspond aux caractéristiques de la table de base de données Sage X3 à exporter.

Ecran de saisie

Présentation

Au lancement de la fonction, un écran permet de saisir les paramètres relatifs à l'export à lancer.

 

Champs

Les champs suivants sont présents dans cet onglet :

Bloc numéro 1

Correspond au modèle d'import-export mis en oeuvre.

  • Gestion chrono (champ CHRONO)

Si cette case à cocher est activée, l’export se fait uniquement sur les enregistrements modifiés depuis le dernier export. Le principe de fonctionnement de ce mode d’export est le suivant :

  • Un compteur (variable numérique commune à un moment donné pour tous les postes d’un dossier, stockée dans la base de données, dont le nom est [C]EXPORT), constitue une base de temps (il s’incrémente à chaque fois qu’un export avec gestion de chrono est lancé).
  • La valeur courante du compteur [C]EXPORT est reportée dans les enregistrements de la base de données lorsqu’une création ou une mise à jour est faite. Ce mécanisme est valable pour toutes les tables permettant de réaliser un export chronologique (toutes les tables de base et les en-têtes de mouvement incluent ce champ : ceci représente près de la moitié des tables de la base de données). Le champ correspondant s’appelle EXPNUM.
  • Lors de l’export chronologique, on stocke la valeur courante du compteur EXPORT dans le modèle d’import/export, puis on l’incrémente, et on n’exporte que les enregistrements de la base pour lequel la valeur du champ EXPNUM est inférieure ou égale à la valeur du champ EXPORT avant incrémentation, et supérieure strictement à la dernière valeur précédemment stockée dans le modèle.

Lorsqu’on fait un export avec une gestion de chrono, il est possible d’utiliser le méta-caractère # dans le nom du fichier à exporter ; ce caractère est alors remplacé par la valeur courante du compteur EXPORT formaté sur 4 caractères. Ainsi, le nom de fichier donnees#.asc sera remplacé par donnees00001.asc, donnees00023.asc, etc. … selon la valeur du compteur.

Bien entendu, pour que ce type d'export existe, la zone EXPNUM doit exister dans la table liée à l'objet exporté. Si elle existe, elle est automatiquement renseignée par la gestion d'objet, et peut donc être utilisée pour des exports de ce type.

La valeur courante du compteur [C]EXPORT est modifiable dans les paramètres d'import-export.

Génération du fichier

  • champ TYPEXP

 

  • Fichier de données (champ VOLFIL)

 

Tableau Bornes

  • Zone (champ BNOM)

Ce champ définit le nom du champ pour lequel une borne peut être saisie.

  • Début (champ BDEB)

Permet de renseigner des bornes inférieures et supérieures sur un ensemble de champs du modèle, afin de limiter les données à exporter. Si ces bornes ne sont pas renseignées, aucun filtrage n'est fait sur le champ concerné.

  • Fin (champ BFIN)

 

Tableau Critères

Les tables mises en œuvre dans le modèle d'import / export sont listées ici, afin de permettre de définir un filtrage éventuel des données exportées.

  • Critère sélection (champ CRITERE)

Permet de définir des critères supplémentaires de filtrage des données à exporter pour la table concernée, sous la forme d'expressions logiques qui doivent être vérifiées et qui peuvent utiliser les champs de la table. 

 

Tâche batch

Cette fonction peut être lancée en batch. La tâche standard EXPORT est prévue à cet effet.

Boutons spécifiques

Les champs suivants sont présents dans la fenêtre ouverte par ce bouton :

Tableau

  • champ LIGNE

Lignes incluses dans le traitement.

Provoque l’affichage du traitement de décodage des données, issu du modèle, qui va être exécuté (ce traitement est nommé WWE#####, où ##### est un numéro attribué automatiquement).

Une fenêtre s'ouvre alors, permettant de visualiser voire de modifier ce traitement, avant de lancer l’exécution par le bouton correspondant, ou au contraire d’abandonner le lancement de l’import.

Messages d'erreur

Outre les messages génériques, les messages d'erreur suivants peuvent apparaître lors de la saisie :

Fichier destination existant, effacement (Oui/Non)

Le fichier à exporter existe déjà : si on confirme, le précédent fichier sera écrasé par le résultat de l’export.

Répertoire inexistant

Le répertoire dans lequel on veut écrire le fichier à exporter n’existe pas.

Export impossible sur ce modèle

Le modèle n’est pas utilisable en export.

Tables mises en oeuvre

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre