Cette fonction n'est utile qu'aux personnes désirant lire des fichiers issus du module d'import ADONIX ENTREPRISE V3™, ou au contraire d'écrire des fichiers destinés à ce même module ; les formats d'import/export utilisés par ce module différant de ceux utilisés par Sage X3, il s'agit donc d'une fonction de transcodage qui permet de décrire les correspondances entre un modèle d'import/export Sage X3 et un modèle V3, mais également de donner des valeurs par défaut pour renseigner des champs qui ne seraient pas présents dans le modèle d'origine.

L'organisation d'un modèle d'import/export ADONIX ENTREPRISE V3 est identique à celui d'Sage X3 lorsqu'un seul niveau d'information est présent dans le modèle, et dans ce cas, le paramétrage d'import sert essentiellement à définir des correspondances. Par contre, le modèle en-tête/ligne d'ADONIX ENTREPRISE V3 peut se décrire par l'organisation suivante :

Groupe de champs (table d'en-tête)

Groupe de champs des lignes (première  ligne)

Groupe de champs des lignes (2ème ligne)

...

Groupe de champs des lignes (Nième ligne)

SL

Séparateur Logique

SL

Groupe de champs (table d'en-tête)

...

Cette organisation se fonde sur le fait qu'un en-tête est suivi d'une répétition de lignes jusqu'à ce qu'un enregistrement de rupture, défini par un séparateur logique (fréquemment, il s'agit du groupe de caractères ***), permette de réécrire soit un nouvel enregistrement d'en-tête, soit un deuxième niveau de groupe de lignes de détail.

Dans un modèle Sage X3, au contraire, l'organisation des groupes de données est définie à l'aide d'identificateurs de groupes obligatoires dès que plus d'un niveau d'enregistrements existe :

Identificateur en-tête

Groupe de champs (table d'en-tête)

Identificateur ligne

Champs des lignes (1ère ligne)

...

Identificateur ligne

Champs des lignes (Nième ligne)

SL

Identificateur en-tête

Groupe de champs (table d'en-tête)

...

Par ailleurs, dans ADONIX ENTREPRISE, certains modèles (en particulier le modèle des écritures) n'avaient pas d'en-tête et uniquement des lignes (les informations d'en-tête étant répétées). Dans ce cas, il est nécessaire, pour que le modèle Sage X3 puisse être utilisé, de définir sur quelles zones se fait la rupture (en l'occurrence, le numéro de pièce : lorsqu'il change, on a changé d'écriture).

Le paramétrage import V3 permet ainsi de définir des transcodages entre modèles V3 et modèle X3. Ces transcodages permettent de lire un fichier de données créé avec un modèle V3, puis de le réécrire de telle façon qu'il puisse être lu par le modèle d'import X3.

La fonction d'import V3 permet ensuite de transcoder les fichiers en se basant sur un modèle de ce type.

Pré-requis

See also Reportez-vous à la documentation de Mise en oeuvre

Gestion de l'écran

En-tête

On définit en tête un code, un intitulé, et un indicateur Actif sous la forme d'une case à cocher.

Code (champ CODE)

Permet d'identifier les règles de conversion pour permettre l'import d'un fichier d'export généré sous Adonix ENTREPRISE v3.
Intitulé (champ INTIT)

Permet de définir un intitulé associé à chaque fiche.
Actif (champ ENAFLG)

Sélectionnez cette case à cocher pour activer la fiche courante.

Les enregistrements non sélectionnés conservent leur contenu et paramétrage, mais ne pourront pas être utilisés en rappelant leur code dans :

  • les autres enregistrements, comme les documents et paramètres,
  • les traitements en masse.

Les habilitations sur une fonction donnée peuvent interdire la création d'une fiche active. Dans ce cas, la case est désactivée par défaut. Elle est modifiable uniquement par un utilisateur autorisé, ou via un Workflow de signature.

Onglet Général

Cet onglet permet de définir les paramètres généraux du transfert et décrit la structure des groupes de données à transcoder.

Une fois le code du modèle d'import-export renseigné, on voit apparaître, dans le tableau Rupture, les différents groupes de données se trouvant dans le modèle d'import final.

Il est important de définir, associés à ces groupes, un numéro de zone de rupture (seul le dernier groupe n'en a pas besoin). Ceci permet en effet de décrire sur quelle zone se fait la rupture d'enregistrement, lorsque un seul enregistrement définit en entrée plusieurs niveaux de lignes. Ceci est par exemple le cas lorsqu'on reprend des écritures d'ADONIX FINANCE V3. En effet, dans les modèles d'écriture, les informations d'en-tête sont répétées sur toutes les lignes, et il est nécessaire, pour que le découpage puisse se faire entre les différentes pièces, que l'on signale à quel rang (1 à N) se trouve la zone numéro de pièce dans le fichier d'import. A partir de là, la répartition des informations d'en-tête et de ligne se définira simplement par leur rang, une rupture dans la zone ainsi identifiant définissant le passage à la pièce suivante.

Lorsqu'on a des informations organisées en en-tête et ligne de la même façon sur le modèle d'entrée V3 et le modèle de sortie, la zone de rupture peut être conventionnellement prise comme étant la première. On définira la rupture dans la deuxième page en mentionnant le séparateur de groupe utilisé dans le modèle V3 au niveau du séparateur '/' du modèle d'import.

Bloc numéro 1

Modèles import/export (champ MODELE)

Définit le code du modèle d'import/export qui devra lire le fichier. Le fichier v3 sera converti pour pouvoir être importé par ce modèle.

Fichier à convertir

champ TYPV3
Fichier à convertir (champ FILV3)

Permet d'indiquer le chemin du fichier v3 qui doit être converti au format x3.
Format fichier (champ CODDBA)

Fichier destination

champ TYPX3
Fichier destination (champ FILX3)

Permet d'indiquer le chemin du fichier converti au format x3 qui pourra être importé par le module d'import standard.

Tableau Rupture

Code (champ FLGREC)

Code identifiant le groupe courant dans le modèle d'import-export.
Niveau (champ FLGLEV)

Niveau d'imbrication du groupe courant dans le modèle d'import-export.
Table (champ FLGFIL)

Nom de la table correspondant au groupe de données courant du modèle d'import-export.
Zone de rupture (champ FLGV3)

Permet d'indiquer le numéro de la ligne du modèle v3 qui permet de faire la rupture dans le cas où un enregistrement v3 correspond à plusieurs niveaux x3.

Par exemple: dans Adonix Entreprise v3, le fichier ECRITURES contient à la fois des informations d'entête et de lignes. Dans Sage X3, le modèle d'import standard des écritures, distingue un niveau pour l'entête et un autre pour les lignes.

Il faudra donc indiquer le numéro de la zone PIECE du modèle v3 pour permettre de distinguer l'entête et le numéro de la zone NUMECT pour les lignes. Dans le cas de la conversion d'un modèle à plusieurs niveaux, le dernier niveau est considéré comme celui du détail et cette zone est vide. Sous Sage X3, ce niveau est généralement marqué par "***".

Onglet Lignes

Dans cet onglet, on fait apparaître, en regard des champs du modèle X3, le numéro de la zone du modèle V3 qui doit être mis en correspondance, en sachant que :

Les numéros commencent à 1 et se réfèrent au début du groupe de données.

  • Si une structure de type en-tête et lignes en V3 correspond à une structure identique sous X3, on définit les caractères composant le séparateur de groupe de données (en général, c'est "***") en regard du caractère "/" placé en tête de groupe, et on recommence la numérotation à partir de 1.
  • Il est possible de rendre conditionnel le fait qu'un champ soit pris en compte. Ceci se fait grâce à la colonne condition, qui permet, si elle est vérifiée, de provoquer le transfert de la zone source vers la zone cible. On remarquera que la valeur du champ courant se trouve dans la variable nommée VALEUR, qui est toujours de type alphanumérique.
  • Il est aussi possible de définir une valeur par défaut pour le champ, dans la colonne idoine. Cette valeur peut faire référence au champ en cours d'import (variable VALEUR). Par exemple, si la zone VALEUR contient au départ un nombre avec deux décimales, mais sans séparateurs, il est possible de transcoder ce montant en le divisant par 100, ce par la formule d'initialisation val(VALEUR)/100.

Ainsi, par exemple, imaginons que le modèle d'export V3 soit composé d'un en-tête et de lignes séparés par les 3 caractères ***, et que le modèle X3 soit composé d'un groupe nommé E, de niveau 1, et d'un groupe L, de niveau 2. Imaginons enfin que les champs de l'entête du fichier V3, nommées A, B, C doivent être repris dans l'ordre B,C, suivis d'un champ figurant la date du jour, et enfin du champ A, et que les champs E, F, G des lignes soient repris dans l'ordre E, G, F, G devant lui-même être multiplié par 100. On obtiendrait, sur l'onglet Général, le tableau suivant :

Code

Niveau

Table

Zone de rupture

E

1

Table d'en-tête

1

L

2

Table des ligne

 

L'onglet Lignes présenterait quant à lui les données suivantes :

Code

Fichier

Champ

Commentaire

Zone V3

Condition

Initialisation

E

Table d'en-tête

/

 

 

 

 

E

Table d'en-tête

B

Champ B

2

 

 

E

Table d'en-tête

C

Champ C

3

 

 

E

Table d'en-tête

D

Champ D

 

 

date$

E

Table d'en-tête

A

Champ A

1

 

 

L

Table des lignes

/

 

***

 

 

L

Table des lignes

E

Champ E

1

 

 

L

Table des lignes

G

Champ G

3

 

val(VALEUR)*100

L

Table des lignes

F

Champ F

2

 

 

Tableau Champs

Code (champ TYP)

Définit le code de groupe du modèle d'import X3.
Fichier (champ FIL)

Définit la table concernée par l'import X3.
Champ (champ FLD)

Définit le champ concerné par l'import X3.
Commentaire (champ COM)

Intitulé associé au code précédent
No de zone (champ ZON)
Condition (champ COND)

Si la condition n'est pas vérifiée, la zone sera vide.
Initialisation (champ INIT)

Indiquer une valeur ou une expression qui forcera la valeur de cette zone.
Zone obligatoire (champ OBLIG)
Numéro de table (champ NUMTAB)

Boutons spécifiques

Exécution

Permet d'exécuter un transcodage d'import V3.

Ce bouton permet de recopier la définition de la fiche depuis ou vers un autre dossier.

Bloc numéro 1

champ OBJET
champ CLES

Bloc numéro 2

Depuis le dossier (champ DOSORG)

Indiquez le dossier à partir duquel la fiche va être copiée. Les syntaxes possibles sont décrites dans l'annexe dédiée.
Tous dossiers (champ TOUDOS)

Cette option permet de copier la fiche vers tous les dossiers définis dans le dictionnaire (table ADOSSIER de la solution courante).
Vers le dossier (champ DOSDES)

Indiquez le dossier dans lequel la fiche va être copiée. Les syntaxes possibles sont décrites dans l'annexe dédiée.