Paramétrage > Exploitation > Imports/Exports > Paramétrage tableau/import 

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

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre

Gestion de l'écran

En-tête

Présentation

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

 

Champs

Les champs suivants sont présents dans cet onglet :

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.

 

Champs

Les champs suivants sont présents dans cet onglet :

Bloc numéro 1

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.

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

Présentation

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

 

 

 

Champs

Les champs suivants sont présents dans cet onglet :

Tableau Champs

  • Code (champ TYP)

Définit le code de groupe du modèle d'import X3.

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 quiforcera la valeur de cette zone.

  • Zone obligatoire (champ OBLIG)

 

 

 

Boutons spécifiques

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

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

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.

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

Cas particulier de l'interface comptable

Un cas particulier existe, fait pour gérer l'interface comptable avec les imputations analytiques issues de la version 3. En effet, lorsque le décodage des champs permet de renseigner une zone appelée CCE(i) (i compris entre 0 et 8), la condition i=j permet de conditionner l'affectation de la section j en fonction de la zone présente dans la ligne numéro i du modèle : cette zone représente le numéro de l'axe courant à affecter. Ceci suppose de disposer en version 3.9 des derniers patches faits sur la gestion des modèles d'import. Voici un exemple de modèle V3 fait pour transférer des écritures générales avec imputations analytiques sur les 3 axes qui se présente avec, dans l'ordre, les champs suivants :

No

Fichier

Zone

1

ECRITURES

CODJOU

2

ECRITURES

PIECE

3

ECRITURES

NUMECT

4

ECRITURES

DATECT

5

ECRITURES

CODETT

6

ECRITURES

CODCOL

7

ECRITURES

CODCPT

8

ECRITURES

LIBECT

9

ECRITURES

MNTECT

10

ECRITURES

SENS

11

ECRITURES

CODNAT

12

ECRANA

CODSEC

13

ECRANA

MONTANT

14

ECRANA

QTE

15

ECRANA

TYPSEC

16

ECRANA

NUMECT

17

ECRANA

NUMLIG

Le modèle X3 correspondant se présente quant à lui sous la forme suivante, pour la partie en-tête :

Code

Niveau

Table

Zone de rupture

G

1

GACCENTRY

2

D

2

GACCENTRYD

3

A

3

GACCENTRYA

 

L'onglet Lignes présente les données suivantes (on remarquera que dans cet exemple, on a fixé la devise et le type de pièce) :

No

Code

Fichier

Champ

Commentaire

Zone V3

Condition

Initialisation

1

G

GACCENTRY

/

 

 

 

 

2

G

GACCENTRY

TYP

Type pièce

 

 

"OD"

3

G

GACCENTRY

NUM

Pièce

 

 

 

4

G

GACCENTRY

FCY

Site

5

 

 

5

G

GACCENTRY

JOU

Journal

1

 

 

6

G

GACCENTRY

ACCDAT

Date compta

4

 

 

7

G

GACCENTRY

REF

Référence

2

 

 

8

G

GACCENTRY

CUR

Devise

 

 

"EUR"

9

D

GACCENTRYD

/

 

 

 

 

10

D

GACCENTRYD

LIG

No

 

 

 

11

D

GACCENTRYD

SAC

Coll

6

 

 

12

D

GACCENTRYD

ACC

Compte

7

 

 

13

D

GACCENTRYD

BPR

Tiers

 

 

 

14

D

GACCENTRYD

DES

Libellé

8

 

 

15

D

GACCENTRYD

SNS

Sens

10

 

 

16

D

GACCENTRYD

AMTCUR

Mt devise

9

 

 

17

D

GACCENTRYD

FCYLIN

Site

5

 

 

18

D

GACCENTRYD

CNA

Nature

11

 

 

19

A

GACCENTRYA

/

***

 

 

 

20

A

GACCENTRYA

ANALIG

No

 

 

 

21

A

GACCENTRYA

CCE(0)

Section

1

4=1

 

22

A

GACCENTRYA

CCE(1)

Section

1

4=2

 

23

A

GACCENTRYA

CCE(2)

Section

1

4=3

 

24

A

GACCENTRYA

CCE(3)

Section

 

 

 

25

A

GACCENTRYA

QTY

Quantité

3

 

 

26

A

GACCENTRYA

AMTCUR

Mt devise

2

 

 

Le point particulier à considérer dans ce modèle est la manière dont est faite la correspondance entre les axes analytiques extraits de la version 3. Dans la version 3, le 4ième champ du groupe de données analytique (fichier ECRANA) définit le numéro d'axe de la section avec le montant et la quantité correspondante, ce champ étant répété autant de fois que nécessaire avec le séparateur *** en fin de groupe.  Les conditions particulières 4=1, 4=2, 4=3, dédiées à ce type de modèle , permettent d'affecter CCE(0) avec la section présente dans le cas où le 4ième champ de l'interface (TYPSEC) vaut 1 (ce qui est décrit par 4=1), CCE(1) avec la section si TYPSEC vaut 2, CCE(2) avec la section si TYPSEC=3. La section CCE(3) n'est ici pas affectée. Cette syntaxe permet de définir une correspondance quelconque entre les 3 axes analytiques de la version 3 et ceux d'Sage X3.

Messages d'erreur

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

Les noms des fichiers doivent être différents

Les fichiers de départ et d'arrivée ne doivent pas être identiques

Fichier destination présent, effacement

Il s'agit davantage d'un avertissement : le fichier à écrire existe déjà et va être remplacé par le résultat de l'opération si on continue celle-ci.

Import impossible sur ce modèle

On a utilisé un modèle X3 qui ne permet pas l'import de données.

Type de fichier incorrect

Seuls les fichiers de type Ascii 2 ou Délimité sont autorisés

Tables mises en oeuvre

SEEREFERTTO Reportez-vous à la documentation de Mise en oeuvre