Lorsqu'on lance un processus d'import de données, les données à intégrer sont lues par groupes logiques de lignes de types différents (par exemple un en-tête, des lignes de détail qui lui sont associées, un sous-détail des lignes de détail...). Chaque groupe logique de lignes forme un enregistrement.

La structure de l'enregistrement est définie dans le modèle d'import-export (via le tableau des indicateurs). Si aucune ligne n'est définie dans ce tableau, chaque ligne constitue un enregistrement.

Lors de l'import, chaque enregistrement est testé du point de vue du format des données, mais aussi en utilisant des règles plus générales de cohérence (les règles métier). Si des erreurs sont détectées à ce stade, l'enregistrement n'est pas intégré (mais les enregistrements suivants peuvent l'être).

Le sas d'import-export permet de stocker le détail des données rejetées pour un fichier importé donné : dans un lot, on trouve chaque enregistrement rejeté sous la forme de 1 à N lignes, et dans chaque ligne, on retrouve la description de la structure de la ligne, et les valeurs des champs lues dans le fichier. Lorsque des erreurs ont été détectées sur un champ donné, elles sont mises en évidence par un style prédéfini.

A partir de là, l'utilisateur peut :

  • modifier les valeurs qui sont erronées
  • ajouter des lignes le cas échéant
  • ré-extraire les données d'un ensemble de lots dans un fichier, afin de pouvoir le réimporter à nouveau après correction.
  • rajouter des enregistrements dans un lot donné.

Il est aussi possible d'importer directement un fichier dans le sas d'import/export sans chercher à l'importer en réel. Dans ce cas, seuls les contrôles de de cohérence des formats de données seront faits, et tous les groupes seront mis dans le sas.

Pré-requis

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre

Gestion de l'écran

La gestion du sas se fait dans un objet organisé en deux onglets, les listes de gauche permettent, outre les deux volets classiques (liste gauche présentant une ligne par lot,  et derniers lus), de faire apparaître :

  • les numéros avec le détail des lignes, de façon hiérarchique (Sas import/export par Lot)
  • une hiérarchie numéro de lot / numéro de ligne / champ pour les lignes sur lesquelles une erreur est signalée (Sas import/export par erreur).

En-tête

L'en-tête identifie le lot et la ligne courante dans le lot.

Bloc numéro 1

No de lot (champ NUMLOT)

Attribué à partir d'un compteur, le numéro de lot, identifie un groupe cohérent de données importé dans le sas.
Modèle (champ EXT)

Définit le modèle d'import/export qui a été utilisé lors de l'alimentation du sas.

Ce code modèle peut être utilisé dans la numérotation des lots, si le compteur intègre un segment de type Complément.
Nbre lignes (champ NBRLIG)

Permet d'afficher le nombre de lignes du lot courant.
Fichier (champ FILEXT)

Ce champ définit le chemin du fichier de données par défaut, suggéré au lancement du processus d'export ou d'import. Ce fichier de données est utilisé en mode automatique dans le cas d'un enchaînement d'imports ou d'exports. Ce chemin peut être relatif. Dans ce cas, le répertoire de base de données est le répertoire d'installation du logiciel.

Ce chemin peut inclure le caractère #. Dans ce cas, la gestion des numéros séquentiels (chronos) s'applique :

  • En import : Tous les fichiers dont le modèle correspond au chemin sont parcourus, et # représente 5 chiffres. Les fichiers sont intégrés dans l'ordre croissant, selon leur numéro.
  • En export : Un fichier est créé avec la valeur formatée du chrono [C]EXPORT sur 5 chiffres. Cela implique que la case à cocher Gestion chrono soit sélectionnée lors du lancement de la fonction d'export.

Par exemple, si le chrono d'export est égal à 156, /u/tmp/fic# permet de générer le fichier /u/tmp/fic00156.

Bloc numéro 2

champ LIGFIR

Ces boutons magnétophone permettent de naviguer dans les lignes du lot courant, respectivement en revenant à la première ligne, à la ligne précédente, en passant à la ligne suivante, à la dernière ligne.
champ LIGPRE
champ LIGNEX
champ LIGLST
No de ligne (champ NUMLIG)
Indicateur (champ LEVCOD)

Définit le code de l'indicateur correspondant à la ligne traitée. Par exemple, si un modèle d'import gère des lignes d'en-tête identifiées par un E, des lignes de détail identifiées par un L, et des lignes de sous-détail identifiées par un S, on trouvera l'un de ces 3 caractères dans ce champ.
Enregistrement (champ ENR)

Indique le numéro de ligne courant et le nombre de lignes du lot.

Onglet Lignes

Cet onglet permet de faire apparaître les champs du modèle tels qu'ils doivent être intégrés pour le type de lignes courant (identifié par l'indicateur). En regard, on retrouve les valeurs trouvées dans le fichier d'import (avec une mise en forme particulière si une erreur a été détectée sur le champ).

Tableau

champ NBLIG
Table (champ FLDATB)

Champ affiché qui identifie la table dans laquelle l'information est supposée être intégrée lors de l'import (on la retrouve sur le modèle d'import/export).
Champ (champ FLDNAM)

Champ affiché qui identifie le champ dans lequel l'information est supposée être intégrée lors de l'import (on la retrouve sur le modèle d'import/export).
Intitulé (champ FLDINTIT)

Intitulé associé au code précédent
Type (champ FLDATY)

Champ affiché qui définit le type de données attaché au champ à intégrer. En fonction de ce type, certains contrôles de cohérence peuvent être réalisés. En cas de saisie de la valeur du champ, une fenêtre de sélection dépendant précisément du type peut être activée.
Valeur (champ FLDVAL)

Définit la valeur du champ à intégrer.

Par défaut, on trouve la valeur qui a été trouvée lors de l'import, mise en valeur par un style particulier si elle est considérée comme incorrecte. Mais elle peut être modifiée par le biais de cette fonction.

Il est à noter que, lors de la saisie :

  • on a accès à des fonctions de sélection (via clic droit) dans des tables liées ou sur une liste de menus locaux (le numéro du choix fait étant renvoyé dans ce cas).
  • on ne réalise pas les contrôles d'existence dans la table liée ou dans le menu local (on considère que la table en question peut être mise à jour par un autre import préliminaire : c'est seulement au moment où on fera réellement la mise à jour que le contrôle sera fait).

Un champ erroné est remis dans le style par défaut dès lors qu'une saisie conforme aux contraintes de formats de champs a été faite sur la ligne. La ligne en question disparaît également de la liste des erreurs (elle existe toujours dans la table des erreurs, mais avec un indicateur signalant qu'elle est corrigée).

Onglet Clob

Lorsqu'un champ de type clob (chaîne de caractères longue) est défini dans le modèle, cet onglet permet de visualiser sa valeur, et de la modifier si nécessaire, en appuyant sur le bouton correspondant.

Bloc numéro 1

Clob (champ CLBINTIT)

Définit le code du clob.
Modification (champ CLBEXE)

Ce bouton permet de passer en mode modification sur le texte (de type clob) présenté ci-dessous.

Bloc numéro 2

champ WA
champ FLDCLB

Champ de type clob tel qu'il a été intégré dans le sas d'import/export. Il est modifiable via le bouton situé en haut de l'onglet.

Etats

Par défaut, les états suivants sont associés à la fonction :

  PRTSCR : Impression écran

Mais ceci peut être modifié par paramétrage.

Boutons spécifiques

Ajout

Permet d'ajouter une ligne dans le groupe en décalant toutes les lignes suivantes de l'enregistrement de 1. La ligne ajoutée est proposée par défaut avec les valeurs de la précédente ligne, mais il est possible de la modifier. En cas d'abandon, la ligne ajoutée est supprimée, et les lignes décalées sont renumérotées pour revenir à leur position d'origine.

Permet de réexporter le lot courant vers un fichier, dont le nom est saisi.

Fichier

Type de destination (champ TYPEXP)
Fichier de données (champ NOMEXP)

Permet de définir le chemin d'un fichier de données dans lequel l'export est lancé. Si le chemin fichier est relatif,  le répertoire de base est supposé être le répertoire de base d'installation du progiciel.

Il est possible de placer le méta-caractère # dans un nom de fichier à exporter. Dans ce cas, ce caractère est remplacé par le numéro de chrono export courant, sur 5 chiffres (précédé le cas échéant de zéros), sous réserve que l'on ait lancé un export chronologique.

Permet d'importer dans le sas le contenu d'un fichier. Contrairement à l'import standard, qui ne met dans le sas que les enregistrements pour lesquels des erreurs ont été trouvées, cette fonction importe tous les enregistrements du fichier dans le sas. Elle crée un nouveau lot.

Bloc numéro 1

Modèle (champ EXT)

Utilisez ce champ pour définir le modèle à utiliser pour extraire les données du fichier structuré vers un format exploitable par Sage X3. Chaque modèle est défini via la fonction Modèles d'import/export (Paramétrage > Exploitation > Imports/Exports).

Les données importées sont converties au format adéquat pour alimenter les détails de la table de base de données correspondante dans Sage X3.

Emplacement

Type de destination (champ TYPEXP)
Fichier de données (champ NOMIMP)

Permet de définir le chemin d'un fichier de données depuis lequel l'import est lancé. Si le chemin fichier est relatif,  le répertoire de base est supposé être le répertoire de base d'installation du progiciel.

Il est possible de placer le méta-caractère # dans un nom de fichier à importer. Dans ce cas, l’import de tous les fichiers correspondant au nom de fichier avec des chiffres au lieu du # 4 sera réalisé en séquence, l’ordre d’import étant l’ordre croissant des chiffres. Ceci permet d’importer automatiquement des fichiers créés par la fonction d’export chronologique, en important les données dans l’ordre dans lequel elles ont été extraites.