Table des matières
Contents
1. MAPPER amp Receuair i a D se BL Automate Terminal Log station E uitter Manuel Utilisateur TX2 Version 1 4 08 Produits et Services a Mars 2006 C ncerr TX2 Concept Manuel de l utilisateur du Mapper Table des mati res G n ralit s Organisation des fichiers Cr er un format interne Les enregistrements Utilisation des structures Structure d un enregistrement Les variables 7 1 Utilisation des variables dans un format Applicatif vers EDI 7 2 Utilisation des variables dans un format EDI vers Applicatif 8 Constantes et expressions 8 1 Constantes 8 2 L op rateur 8 3 Les variables 8 4 Les fonctions pr d finies 8 5 La structure SWITCH instructions conditionnelles 9 Sauvegarder 10 Compiler 11 Tables de transcodifications 12 Particularit s des formats EDI EDI 13 Particularit s du standard GENCOD 13 1 Gestion des rubriques 177 13 2 Segments de service 14 Particularit s du standard TRADACOM 15 Particularit s du standard VDA Architecture de l environnement de d veloppement TX2 Annexe Gestion des tables de r f rences INHREF et MESSREF N U1 8 N TX2 Concept Manuel de l utilisateur du Mapper 1 GENERALITES Le gestionnaire de formats internes ou mapper permet de param trer des liens fichiers applicatifs lt gt messages EDI Il permet de param trer la fois la structure physique du fichier applicat2. La ligne courante appara t sur fond noir Pour s lectionner un bloc de cellules cliquer sur la premi re cellule puis pointer sur la derni re cellule du bloc en cliquant tout en maintenant la touche Shift ou Majuscule appuy e Une d finition d enregistrement est constitu e de cellules dont le type peut tre Mapping il s agit d une cellule permettant de mettre en correspondance une donn e du fichier interne avec une donn e du message EDI par exemple BGM 1001 dans l exemple ci dessus Les champs saisir sont Segment c est le segment mettre en correspondance Groupe si le segment appara t plusieurs fois dans le message il faut pr ciser le num ro de groupe El ment choisir l l ment de donn e mettre en correspondance Longueur longueur dans le fichier interne indiquer 0 pour une d claration de variable Cible Cocher si c est une donn e cible c est dire si vous souhaitez r p ter la valeur courante d une donn e d j mapp e par ailleurs Obligatoire Cocher si la donn e doit obligatoirement tre pr sente dans le fichier en fomat interne Ceci permet d introduire des contr les de pr sence suppl mentaires par rapport la norme R f rence zone libre dans laquelle vous pouvez une r f rence applicative Libell zone libre dans laquelle vous pouvez indiquer un commentaire Stocker dans Indiquer un nom de variable dans laquelle vous souhaitez stoc
3. Run time de traduction TX2 TX2 Concept Manuel de l utilisateur du Mapper Annexe Gestion des tables de r f rences INHREF et MESSREF Les tables de r f rence TX2 INHREF RDX TX2 MESSREF RDX et TX2 SUBSREF RDX sont des fichiers binaires dans lesquels sont stock s les liens Format lt gt Message Subset lt gt Identification UNH Ces tables sont mises jour automatiquement par l Atelier de conception et le Mapper lors de l enregistrement des messages et lors de l enregistrement et la compilation des formats internes Par ailleurs ces tables sont exploit es par le run time du traducteur TX2 en particulier pour retrouver quels formats internes utiliser pour les documents re us identifi s par l UNH le MHD etc selon le standard Lorsque l environnement de d veloppement et le traducteur sont install s sur le m me ordinateur la coh rence de ces tables est automatiquement assur e Par contre lorsqu on a besoin de transf rer des param trages d un poste un autre ou lorsqu on souhaite g rer plusieurs configurations utilisateurs il est n cessaire de maintenir correctement les tables de r f rence En particulier la proc dure d installation de la station TX2 permet de mettre jour_ automatiquement les tables de r f rence partir de fichiers de commande cr er sur la disquette d installation Cf documentation technique installation de param trages Cependant il existe un moyen
4. tre enregistr dans une cellule de type calcul Il est possible de g rer plusieurs piles dans un m me format interne et pour chaque pile il est possible de g rer plusieurs expressions ou variables dans plusieurs instructions STACK L utilisation bon escient du couple STACK SWRITE par la capacit qu il procure valuer des expressions r troactivement permet de r soudre la plupart des cas complexes de mises en correspondance de structures a priori incompatibles 8 5 L instruction SWITCH instructions conditionnelles Il est possible d enregistrer des groupes d instructions conditionnelles en utilisant l instruction SWITCH Ceci se fait sous forme de cellule Texte libre Voici un exemple de groupe d instructions SWITCH DATA 3 N MAPTO SKIP DATA 35 VN MAPTO SKIP SWITCH QN CASE DP CONSTANT DATA VAL vn MAPTO 3 1 CASE SU CONSTANT DATA VAL CASE BY CONSTANT DATA VAL vn MAPTO UNB 2 1 ELSE CONSTANT DATA VAL ZZ MAPTO UNB 2 1 vn MAPTO UNB 3 1 Cet exemple illustre bien la structure d un bloc SWITCH qui permet de conditionner des instructions sur la valeur d une variable ici la variable QN Dans cet exemple on alimente tel ou tel segment selon la valeur d un qualifiant Ainsi si QN vaut SU alors on alimente l adresse de l metteur avec le contenu de VN 9 SAUVEGARDER Lorsque vous d finissez un format interne sauvegardez l
5. finir galement le subset du message sortant le cas ch ant 2 Dans le mapper cr er un format interne et donner comme nom le nom du format g n r dans l tape 1 Ce format d fini automatiquement les enregistrements du fichier plat en nommant toutes les variables Il suffit alors d alimenter les donn es du message sortant en utilisant des instructions Auto g n r e On peut galement mapper directement mais en aucun cas il ne faut changer les tailles des enregistrements et des donn es 13 PARTICULARITES DU STANDARD GENCOD Les r gles g n rales d finies dans les pages qui pr c dent sont applicables au standard GENCOD TX2 Concept Manuel de l utilisateur du Mapper 13 1 Gestion des rubriques 177 Les rubriques 177 peuvent appara tre n importe o dans le message Il est possible de mapper une rubrique 177 en la r f ren ant par rapport la rubrique imm diatement pr c dente Par exemple si on s attend recevoir la s quence 290 141 177 177 290 141 on r f rencera les rubriques 177 de cette s quence en d clarant des mappings 141 TXT1 et 141 TXT2 Ceci indique au syst me que ces rubriques sont d pendantes du 141 13 2 Segments de service Le traducteur passe par un format interm diaire pseudo EDIFACT Pour cette raison le mappeur g n re dans le fichier DEF les lignes suivantes DATASET CONSTANT DATA VAL SDATE MAPTO UNB 4 1 CONSTANT DATA VAL TIME MAPTO UNB 4 2 DATA 0 MAPTO
6. Lorsque vous d finissez un format dans le sens Emission ou Emission r ception vous devez r f rencer dans ce format interne toutes les donn es obligatoires du message Lors de la compilation TX2 v rifie que votre format est coh rent En particulier si vous r f rencez une donn e d un segment non obligatoire alors seulement TX2 v rifie que les donn es obligatoires de ce segment sont r f renc es TX2 Concept Manuel de l utilisateur du Mapper Quoi qu il en soit dans un format Emission ou Emission R ception vous devez r f rencer les donn es de service suivantes Adresse metteur UNB 0004 Adresse destinataire UNB 0010 Date de l change UNB 0017 Heure de l change UNB 0019 N de message UNH 0062 Nous vous conseillons de fournir les donn es UNB 0017 UNB 0019 et UNB 0062 dans la partie d claration sous forme de donn es auto g n r es DATE TIME et 2 1 pour plus de d tails sur la g n ration de constantes ou expressions voir le paragraphe 7 Les autres donn es de service obligatoires sont fournies par le syst me Remarques En mission les donn es UNB S001 0001 identifiant de syntaxe et UNB S001 0002 num ro de version de syntaxe ne doivent pas tre mapp es car elles sont aliment es en fonction de param tres de traduction ou en fonction du destinataire du message Les donn es du composite UNB S009 sont galement automatiquement aliment es en mission La donn e UNB 0020 num ro
7. d entr e par exemple DELINS INH en mission et G GEIS R en r ception TX2 Concept Manuel de l utilisateur du Mapper ARG1 ARG16 Retourne la valeur du ni me param tre externe de la commande de traduction identifi par la cha ne ARGn pass sur la ligne de commande 2 en r ception et 1 en mission Exemples TX2RCV M ATLAS R 2 ARGI Argumentl ARG2 Argument2 0q TX2SND ORDERS INH ORDERS 1 Rb ARG1 Argumentl ARG2 Argument2 Les variables ARG1 et ARG2 valent respectivement Argument1 et Argument 2 les autres sont vides SNBMESS En r ception seulement retourne le nombre de messages dans la session de traduction Gestion de piles de donn es TX2 permet de g rer des piles de donn es Ceci est utile en r ception en g n ral lorque l on souhaite r f rencer dans un enregistrement mappant sur un segment de niveau n une ou plusieurs donn es mappant sur des niveaux n i ces segments tant mapp s par ailleurs La mise en uvre des fonctions de gestion de piles se fait en utilisant les fonctions pr d finies STACK et SWRITE STACK Identifiant de la pile EXPR Exemple STACK SCC1 S SUB 0 1 TYPPROG O01 SWRITE Identifiant de la pile Exemple SWRITE SCC1 Exemple d utilisation Consid rons le diagramme de branchement suivant On souhaite g n rer 2 type d enregistrements avec les caract ristiques suivantes L enregistrement A0900 mappe
8. de contr le d change est aliment e par un compteur interne par d faut Il est possible de forcer ce compteur en mappant la donn e dans le format interne Pour un format d fini en r ception uniquement aucun contr le de pr sence de donn e n est effectu 4 LES ENREGISTREMENTS E La fen tre principale du format interne celle dont le titre est le code format interne contient la liste des enregistrements d clar s pour ce format interne plus la partie D clarations Il peut galement appara tre des informations concernant la structure globale du fichier r p titions indentations existence d entit s STRUC et SEQ STRUC ces notions sont d taill es dans le chapitre 5 Utilisation des structures Cr er un enregistrement bouton Ins ou menu Enregistrements Nouveau Dans ce cas vous devez indiquer l tiquette de l enregistrement par exemple 002 Vous pouvez galement indiquer un libell explicatif ainsi qu un num ro de s quence voir page suivante La fen tre de l enregistrement s ouvre alors D truire un enregistrement bouton ciseaux ou menu Enregistrements D truire Renommer un enregistrement cela consiste attribuer une autre tiquette Dupliquer un enregistrement Editer et modifier la structure de l enregistrement Double click Note sur les num ros de s quence Il est galement possible de forcer un num ro de s quence pour l enregistrement Par d faut le syst me stock
9. fait en utilisant la gestion des applications et des autorisations par message de la station TX2 Si vous utilisez la station TX2 les fichiers en format applicatif traduire doivent s appeler lt Code format gt INH dans le r pertoire wSTA et les fichiers en format applicatif re us s appelleront lt Code format gt RCV dans le r pertoire wWSTA Mais ces contraintes peuvent tre vit es en utilisant des param tres de traduction personnalis s Ces param tres sont d crits dans la documentation TX2 Traducteur Documentation technique run time 3 CREER UN FORMAT INTERNE Pour cr er un format interne s lectionnez l option Fichier Nouveau format Le dialogue suivant appara t TX2 Concept Manuel de l utilisateur du Mapper Format interne Propri t s OI X Code tomat Aen Deseription O y A Recemtion EDI lt gt EDI 1 Message de base F _ Impression AVIEXP40 Message a IN OIC R Subset IN Y CARF Subset IN Y093AD Message _ Format d limit INVIGAE Message INVIGAE Message S parateur INVRPT93 Message FE FE Statut Text Rupture de message Etiquette d enregistrement Oo o Texte libre Position des tiquettes d enregistrements m __ Eliminer les tiquettes en r ception slt Marque de fin de message o o o Vous devez saisir les propri t s du format interne Code format interne c est un nom
10. le r craser d validez le bouton G n rer le fichier source Le bouton R f rences applicatives permet de stocker dans le fichier compil les libell s des donn es qui seront utiles pour la documentation du format Si la compilation s est bien pass e le syst me cr e un fichier TX2 lt Code format gt FDX C est ce fichier qui sera utilis par le traducteur Si la compilation s est mal pass e le fichier FDX n est pas cr En r gle g n rale les erreurs de compilation correspondent au fait que des donn es ou segments obligatoires n ont pas t r f renc s dans un format Emission ou Emission R ception ou des erreurs dans des expressions de constantes ou calculs 11 TABLES DE TRANSCODIFICATIONS Les tables de transcodifications sont cr es et maintenues au travers d un utilitaire Pour acc der cet utilitaire cliquer sur l ic ne Transcos dans le groupe TX2 Station EDI Pour plus de d tails consulter le manuel d utilisation de l utilitaire WTRANSCOS 12 PARTICULARITES DES FORMATS EDI gt EDI Pour traiter un format EDI gt EDI TX2 effectue de mani re automatique une mise en format plat tendu du message EDI entrant puis consid re ce fichier plat comme un fichier format interne classique Il y a donc 2 tapes pour d finir un format EDI gt EDI 1 D finir le subset du message entrant Atelier de conception et g n rer le format standard EDI gt EDI Atelier de conception D
11. que vous donnez au format cr er Lorsque le traducteur est utilis au sein de TX2 Station le code format conditionne le nom du fichier traduire en mission lt Code format gt INH et le nom du fichier traduit en r ception lt Code format gt RCV Description description succincte du format Message de base vous devez s lectionner dans la liste le message ou le subset auquel ce format interne se rapporte Emission R ception Impression EDI gt EDI c est la direction pour laquelle ce format sera utilis Emission signifie que ce format sera utilis pour aller du format applicatif vers le format EDI R ception signifie que ce format sera utilis pour aller du format EDI vers le format applicatif et Impression signifie que ce format sera utilis pour obtenir une sortie imprimable du message EDI En dehors du cas des formats pivots standards en particulier les formats g n r s automatiquement par l atelier de conception il est conseill de construire 2 formats diff rents pour l mission et la r ception car certaines instructions avanc es ont des comportements sp cifiques au sens du format interne Le type EDI gt EDI permet de construire des formats de traduction permettant de traduire directement un document EDI standard vers un autre document EDI standard par exemple une facture INVOIC 90 1 en INVOIC D93A Dans ce cas le format interne doit tre construit partir de la base g n r e automatiquement
12. tre d clar e la vol e dans un Enregistrement ou peut tre d clar e dans la partie D clarations et peut avoir une longueur nulle ou non Dans la partie D clarations elle doit avoir une longueur nulle Pour utiliser la valeur stock e dans une variable il suffit d ins rer une cellule Variable Un dialogue de saisie appara t dans lequel vous devez saisir ou piocher dans la liste un nom de variable la longueur dans l enregistrement et ventuellement une instruction de transcodification ou une instruction de formatage sp cial Exemple d utilisation Dans le format interne on souhaite r p ter dans tous les enregistrements la valeur de la donn e NAD 3039 SU 2 endroits diff rents avec 2 tables de transcodification diff rentes Pour ce faire on d clare dans la partie D claration un mapping vers NAD 3039 avec une condition sur le qualifiant en pr cisant COD DEST dans le champ Stocker dans Puis dans l enregistrement on ins re aux endroits ad quats 2 cellules Variable en appliquant chaque fois la transcodification L utilisation d une partie D claration dans laquelle on r f rence les donn es permet d obtenir un script de format interne bien structur et lisible Autre exemple d utilisation Dans un enregistrement la date d exp dition est en 2 parties de la position 7 10 les mois et jour MMJJ et de la position 15 16 l ann e AA alors que la date g n rer doit tre sous la forme AAA
13. 1 1 DATA 0 MAPTO 2 1 DATA 0 MAPTO 2 2 Cette gestion est transparente l utilisateur 14 PARTICULARITES DU STANDARD TRADACOM La particularit du standard TRADACOM r side dans le fait qu un document se trouve repr sent par plusieurs messages au sens EDIFACT Un message se trouve encadr par les segments MHD et MTR et un interchange repr sentant souvent 1 seul document se trouve encadr par les segments STX et END Afin de pouvoir mod liser une telle structure il faut cr er une structure de message unique dans l atelier de conception Par exemple le message Commande mod lis par ORDHDR 1 de TYP FIL ORDERS R de CLO OTR ORDTLR 1 de OFT OFT sera d crit dans l atelier de conception comme suit TX2 Concept Manuel de l utilisateur du Mapper En r alit les segments CCC et AAA repr sentent les segments MHD pour les messages ORDERS et ORDTLR De plus on ne fait pas appara tre dans la structure les segments MTR Cette r gle doit toujours tre respect e il faut d finir un message composite en rempla ant les segments MHD par des segments dont le nom est imp rativement sous la forme XXX Bien entendu ces segments doivent exister dans le r pertoire des segments la forme XXX Bien entendu ces segments doivent exister dans le r pertoire des segments Cas d un param trage Format interne vers format EDI Dans ce cas le mapping doit tre r alis comme pour un mess
14. AMMJJ Il suffit de d clarer la variable MOISJOUR en position 7 et la variable ANNEE en position 15 puis de d clarer une donn e auto g n r e mappant vers le DTM et ayant pour valeur SUB 0 2 DATEZ ANNEE MOISJOUR 8 CONSTANTES ET EXPRESSIONS TX2 offre un valuateur d expressions qui permet de g n rer des donn es EDI ou des donn es applicatives Cet valuateur permet de manipuler des constantes des variables voir plus haut et des fonctions pr d finies Dans sa version actuelle cet valuateur d expressions ne permet de manipuler que des cha nes de caract res TX2 Concept Manuel de l utilisateur du Mapper 8 1 Constantes Les constantes sont des cha nes apparaissant entre Par exemple HB TECHNOLOGIES ou 1000 8 2 L op rateur L op rateur permet de concat ner 2 constantes ou expressions Par exemple HB Technologies donne HB Technologies LE DATE donne LE 960201 8 3 Les variables Les variables d finies par l utilisateur doivent tre pr fix es par le signe lorsque leur valeur est utilis e dans une expression Par exemple si on a d fini la variable MOIS comme indiqu dans l cran Nom de la variable dans laquelle sera stock e la valeur Longueur _ Obligatoire R f rence IMOIS_LIV Libell Mois de livraison on pourra la r f rencer comme dans l exemple suivant A LIVRER LE MOIS MOIS TX2 C
15. E EXP TARGET DATA 4 PICTURE DATE MMDD YYYYMMDD MAPTO DATE LIV DATA 2 MAPTO SKIP 15 gt 16 TARGET DATA 2 PICTURE DATE YY CCYYMMDD MAPTO DATE EXP DATA 1 MAPTO SKIP 20 gt 20 TEXT LENGTH 6 000000 TARGET DATA 6 MAPTO CODE EXPE CODE TIERS TARGET DATA 5 MAPTO CPOS EXP TEXT LENGTH 1 2 TARGET DATA 24 MAPTO OBSERV TEXT LENGTH 2 TARGET DATA 4 PICTURE NU 0 MAPTO COLIS TARGET DATA 6 PICTURE NU 0 MAPTO POIDS BR TARGET DATA 6 PICTURE NU 0 MAPTO QTE COMP DATA 12 MAPTO SKIP 181 gt 192 TARGET DATA 8 MAPTO REF EXT TARGET DATA 2 MAPTO UN QTECP TARGET DATA 8 MAPTO CODE DEST DATA 46 MAPTO SKIP 211 gt 256 TX2 Concept Manuel de l utilisateur du Mapper 10 COMPILER Pour pouvoir tre exploit par le traducteur un format interne doit avoir t compil Pour ce faire s lectionnez l option Fichier compiler Compilation du format options of X Ligne de commande pour le compilateur COMPINH C TX2 PARAM COMPINH EXE C TX2 DATANDELFOR97 DEF C ATX2 DELFOR97 MDX C ATX y G n rer le ficher source y R f rences applicatives et libell s dans fichier source Note les options par d faut correspondent la quasi totalit des cas de figure Vous ne devez pas les changer sauf instructions particuli re du support technique TX2 Si vous souhaitez compiler un fichier DEF con u par diteur sans
16. H B Technologies E NOCDE HBTECHNOLOGIES 1 Marque de fin de message permet de sp cifier une expression qui sera syst matiquement crite en fin de chaque document dans le fichier en format interne Par exemple si on souhaite que chaque document soit clotur par la cha ne de caract re FINMESS l expression saisie doit tre Marque de fin de message Si l expression de marque de fin de message est du type INCLUDE Fichier alors les instructions contenues dans Fichier sont ins r es dans un bloc LASTDATASET qui correspond une suite d instructions ex cut es en fin de chaque message Exemple SINCLUDE INVOIC93 INC Note importante Cette instruction a t maintenue par souci de compatibilit ascendante Il est pr f rable de d finir les instructions de fin de message l enregistrement de nom d tiquette r serv e END Une fois ces informations saisies deux fen tres s ouvrent une fen tre contenant le diagramme de branchement du message EDI et une fen tre qui contiendra la liste des enregistrements du format interne Au d part seule une ligne D clarations appara t Il s agit d un enregistrement particulier dans lequel on d clarera soit des donn es auto g n r es de niveau message soit des variables tampons Note la partie D clarations correspond un enregistrement particulier dont l tiquette interne est GENINHOOO2 Contr le des donn es obligatoires
17. PR1 et EXPR2 EXPR1 EXPR2 lt NBDEC gt Divise EXPR1 et EXPR2 Toutes ces op rations sont effectu es en double pr cision repr sentation flottante sur 64 bits Le nombre de d cimales est op rationnel s il n est pas pr cis le r sultat obtenu est d padd de ses z ros Exemple 1 2 Retourne 3 1 2 3 Retourne 3 000 S II EXPR1 EXPR2 Division enti re de EXPR1 par EXPR2 Op rations sur les cha nes de caract res Concat nation de cha nes de caract res Exemple XXX YYY Retourne XXXYYY SUB D but Longueur Expression Retourne la sous cha ne de la cha ne expression en commen ant la position D but sur Longueur positions Attention le premier caract re de la cha ne est en position 0 Exemples SUB 0 2 HBTECHNO donne HB SUB 2 6 HBTECHNO donne TECHNO TX2 Concept Manuel de l utilisateur du Mapper SUBST Expr Caract re PAD Longueur L R Caract re Expression Padde la cha ne expression gauche L ou droite R sur Longueur positions en utilisant le Caract re Exemples PAD 8 L 0 120 donne 00000120 PAD 10 R DH X donne DH X PADNUM Longueur L R Caract re Expression Idem mais avec une expression num rique et tient compte du signe de celle ci Exemple PADNUM 5 L 5 donne 5 UNPAD Longueur L R Caract re Expression D padde la cha
18. age EDIFACT Les donn es des segments XXX doivent tre aliment es comme constantes par exemple ORDTLR 8 Cas d un param trage Format EDI vers format Interne Dans ce cas le mapping doit tre r alis comme pour un message EDIFACT mais il faut en plus mettre jour le fichier TX2 MULTISTD INI afin d indiquer au traducteur qu il doit transcoder les MHD entrants en AAA ou CCC selon le type de message Dans notre cas le fichier MULTISTD INI contiendra TRADACOM Syntaxe UNH Code message lt Transco MHD gt lt Transco MTR gt UNH ORDHDR 6 UNH MTR UNH ORDERS 8 AAA MTR UNH ORDTLR 4 BBB UNT Reconnaissance d un message TRADACOM Dans l atelier de conception un message Tradacom doit tre cr ou import en sp cifiant les donn es UNH suivantes lt Type message gt lt Version gt TRA HB TRADAC Par exemple dans notre cas ORDHDR 6 TRA HB TRADAC 15 PARTICULARITES DU STANDARD VDA TX2 Concept Manuel de l utilisateur du Mapper Le standard VDA est tr s proche du standard GENCOD en ce sens qu il s agit d un format de type fixe sans identification formelle de rubrique La contrainte additionnelle est qu il faut maintenir un fichier TX2 VDAINI qui doit permettre au traducteur TX2 d identifier les messages VDA entrant Voici la structure du fichier VDA INI RECEIVE Exemple DOC lt Type doc gt 4916 TAG lt Tag d but gt lt Tag fi
19. e soit en en prenant une sous cha ne Cette valeur peut d ailleurs tre combinant avec d autres variables ou fonctions TX2 Par exemple si on doit mettre dans l l ment NAD 3039 les 6 premiers caract res de NOMDEST pr fix s par 301 on ins rera une donn e auto g n r e mappant vers l l ment NAD 3039 et dont la valeur sera 301 SUB 0 6 SNOMDEST On notera au passage 2 l ments importants Lorsqu on r f rence une variable dans une expression on doit pr fixer son nom par le signe La fonction SUB sous cha ne prend comme arguments l offset d part commen ant 0 la longueur et l expression source TX2 Concept Manuel de l utilisateur du Mapper Autre exemple d utilisation Dans un enregistrement la date d exp dition est en 2 parties de la position 7 10 les mois et jour MMJJ et de la position 15 16 l ann e AA alors que la date g n rer doit tre sous la forme AAAAMMJJ Il suffit de d clarer la variable MOISJOUR en position 7 et la variable ANNEE en position 15 puis de d clarer une donn e auto g n r e mappant vers le DTM et ayant pour valeur SSUB 0 2 DATEZ ANNEE MOISJOUR 7 2 Utilisation des variables dans un format EDI vers Applicatif Dans un format r ception une variable sert stocker un l ment de donn e EDI Pour ce faire on ins re une cellule de type Mapping et on renseigne le champ de saisie Stocker Dans La cellule mapping peut
20. e les enregistrements dans l ordre o ils ont t cr s Ceci ne pose pas de probl me car le traducteur trie le format interne g n r en fonction de l ordre des l ments de donn es mapp s dans le message Cependant il est des cas o l ordre de d claration des enregistrements est important par exemple lorsqu il est fait r f rence une variable qui se trouve d clar e dans un autre enregistrement Dans ce cas l enregistrement o est d clar e la variable doit forc ment tre d clar avant l enregistrement dans lequel cette variable est utilis e L attribution des num ros de s quence est compl tement libre et aucun contr le n est effectu par le syst me 5 UTILISATION DES STRUCTURES TX2 Concept Manuel de l utilisateur du Mapper De mani re g n rale lorsqu on d crit un format interne il nest pas n cessaire d indiquer explicitement au syst me l ordre dans lequel les enregistrements apparaissent dans le fichier Cet ordre est la plupart du temps implicitement logique c est dire qu il est conditionn par l ordre des informations dans le message EDI Cependant dans certains cas l ordre et la structure du fichier interne doivent tre explicitement indiqu s L cran suivant montre un exemple de format interne dans lequel les indications de structure ont t saisies E Format DELJIT Iof x ins a M x 21 enregistrements Imprimer uitter Al 239 cell
21. e r guli rement en utilisant l option de menu Fichier Enregistrer Le syst me cr e alors 3 fichiers un fichier TX2 DATA lt Code format gt REW dans lequel sont stock es les informations saisies sous la forme base de donn es un fichier TX2 DATA lt Code format gt SEQ dans lequel sont stock es les informations li es la structure g n rale num ros de TX2 Concept Manuel de l utilisateur du Mapper s quence structures r p titions et un fichier TX2 DATA lt Code format gt DEF qui est le fichier source de param trage celui l m me qui sera compil Voici un exemple de fichier DEF FORMAT FIXED PAD DEFAULT Constants d finitions DATASET DATA DATE EXP 0 MAPTO 4 1 2 WITH 4 1 1 200 DTM 2380 DATA DATE LIV 0 MAPTO 4 1 2 WITH 4 1 1 2 DTM 2380 DATA CODE EXPE 0 MAPTO 39 2 1 WITH 39 1 PW NAD 3039 DATA NOM EXPE 0 MAPTO 39 3 1 WITH 39 1 PW NAD 3124 DATA OBSERV 0 MAPTO 66 4 1 FTX 4440 DATA COLIS 0 MAPTO 58 2 1 GID 7224 DATA QOTE COMP 0 MAPTO 9 1 2 WITH 9 1 1 6 CNT 6066 DATA POIDS BR 0 MAPTO 9 1 2 WITH 9 1 1 7 CNT 6066 DATA REF EXT 0 MAPTO 14 1 2 WITH 14 1 1 ON RFF 1154 DATA UN OTECP 0 MAPTO 9 1 3 WITH 9 1 1 6 CNT 6411 Records d finitions SET RECORD LABEL R DATA 0 MAPTO 1 1 1 BGM 1001 TARGET DATA 4 PICTURE DATE MMDD YYYYMMDD MAPTO DAT
22. if ainsi que les liens avec les donn es du message EDI Les fichiers applicatifs sont des fichiers ASCII multi ou mono enregistrements Voici un exemple de fichier applicatif et le message EDI ORDERS correspondant Fichier applicatif O01HBTECHNOLOGIES ADRDEST HB TECHNOLOGIES DICROP 12 002TX2 TRADUCTEUR EDI 2 PCE O0O02GESTIONNAIRE DE FORMAT 1 PCE O01HBTECHNOLOGIES ADRDEST HB TECHNOLOGIES DICROP 12 002TX2 TRADUCTEUR EDI 2 PCE 0O02GESTIONNAIRE DE FORMAT 1 PCE Fichier EDIFACT UNB UNOA 1 HB TECHNOLOGIES ADRDEST 951230 1543 10000861 UNH 268 ORDERS D 93A UN BGM 12 NAD SU HB TECHNOLOGIES NAD BY DICROP UNS D LIN TRADUCTEUR EDI QTY 2 PCE LIN GESTIONNAIRE DE FORMAT QTY 1 PCE UNT 10 268 UNH 2 69 ORDERS D 93A UN BGM 12 NAD SU HB TECHNOLOGIES NAD BY DICROP UNS D LIN TRADUCTEUR EDI QTY 2 PCE LIN GESTIONNAIRE DE FORMAT QTY 1 PCE UNT 10 269 UNZ 2 10000861 On constate que 1 le fichier applicatif contient 2 types d enregistrements rep r s par des tiquettes d enregistrement 001 et 002 Le choix des tiquettes est compl tement libre 2 Des donn es ou des qualifiants ont t automatiquement g n r es 3 Lorsque le fichier contient plusieurs messages les messages doivent se suivre 2 ORGANISATION DES FICHIERS DE PARAMETRAGE TX2 Concept Manuel de l utilisateur du Mapper Un format applicatif appel aussi format interne est identifi par un c
23. ition Diff rence entre STRUCT et SEQ STRUCT La diff rence entre les deux se manifeste en traduction de EDI vers format interne Le syst me parcoure une STRUCT dans l ordre o sont d clar s les enregistrements le premier enregistrement de la STRUCT tant un enregistrement Trigger qui conditionne le balayage du reste de la STRUCT Dans le cas d une SEQ STRUCT celle ci est parcourue en boucle ind finiment tant qu il y a des enregistrements alimenter De mani re g n rale on utilise les STRUCT TX2 Concept Manuel de l utilisateur du Mapper 6 STRUCTURE D UN ENREGISTREMENT Voici un exemple de fen tre de structure d enregistrement Ex Enregistrement ENTETE En t te de commande ioj x CTIETITT TEET 37 38 2 BGM 1225 1 3 Fonction du message 39 58 20 BGM 1004 1 2 No de commande 59 60 2 G E EE Mois de livraison Dataset 63 72 10 DTM 2380 212 Date de commande F DTM 2005 2 1 1 ERE EL DEN El DTM 2379 2 1 3 qualifiant format Dataset DTM 2380 2 1 2 Date de livraison DTM 2005 2 1 1 ar x ATi anaman Lis Die LI PO mens de Cuomo AT A Etiquette d enregistrement ENTETE all Longueur totale 111 De Lg Segment El ment 1 6 6 ENTETE 7 19 13 UNB 0010 UNB 3 1 dresse destinataire 20 20 1 UNB 0035 UNB 11 test indicator 21 33 13 UNB 0004 UNB21 dresse metteur 34 36 3 BGM 1001 1 1 1 coddoc
24. ker la valeur courante de l l ment de donn e Bouton Transco Permet d acc der au dialogue de saisie afin d indiquer si une transcodification doit s op rer Dans ce cas vous devrez saisir s lectionner une table de codes qui aura pr alablement t d finie voir paragraphe 8 TX2 Concept Manuel de l utilisateur du Mapper Bouton Sp cial Permet de pr ciser le type de la donn e et ventuellement des conversions de format Par d faut le type de la donn e est le type EDI En particulier ce bouton permet d effectuer des conversions de format de date tout en offrant le support de l an 2000 Voici un exemple d cran Sp cial Formattage sp cial 0 x Format de la donn e D faut format EDI Num rique Num rique sign Date Heure Num riques Point d cimal D cimales Multiplier par 10 Formats date et heure Format applicatif DDMMYY Format EDI CCYYMMDD Utiliser les caract res suivants CC pour le si cle YY pour l ann e MM pour le mois DD pour le jour HH pour l heure MM pour les minutes Ex CCCCHMDD HH MM Pour les donn es de type Date le traducteur effectue une conversion de format entre le format applicatif et le format EDI en s appuyant sur les correspondances de caract res d une z ne l autre Dans le cas pr sent une date 241098 sera transcod e en 19981098 Le syst me rajoute automatiquement le si cle en consid ra
25. n gt 661 669 NUMI lt Tag No interchange gt lt Pos d but gt lt Longueur gt 661 29 5 NUMM lt Tag No message gt lt Pos d but gt lt Longueur gt 661 29 5 DEST lt Tag id dest gt lt Pos d but gt lt Longueur gt 661 6 9 EMET lt Tag id emet gt lt Pos d but gt lt Longqueur gt 661 15 9 UNHDEF lt Id UNH gt V4916 1 01 VD VDA FINDOC TRUE DOC TAG FINDOC TRUE La page suivante contient un exemple de fichier VDA INI RECEIVE DOC 4916 TAG 661 669 NUMI 661 29 5 NUMM 661 29 5 DEST 661 6 9 EMET 661 15 9 UNHDEF V4916 1 01 VD VDA FINDOC TRUE Dans cet exemple le message de type 4916 d butera par un enregistrement 661 et se terminera par un enregistrement 669 Le num ro d change et le num ro de message seront trouv s dans l enregistrement 661 en position 29 sur une longueur de 5 le destinataire sera trouv dans l enregistrement 661 en position 6 sur une longueur de 9 l metteur sera trouv dans l enregistrement 661 en position 15 sur une longueur de 9 et l identification TX2 du message est V4916 1 01 VD VDA Note Les messages VDA doivent tre identifi s dans l atelier de conception sous la forme VXXXX 1 01 VD VDA o XXXX est le code du type de message VDA par exemple 4916 ARCHITECTURE GENERALE DE L ENVIRONNEMENT DE DEVELOPPEMENT TX2 WMESS Atelier de conception de messages et subsets WINH Mapper COMPINH Compilation et contr le de coh rence des messages et mappings WTX2
26. ne de caract res EXPR du caract re CHAR le r sultat obtenu ayant une longueur minimale de LONG Exemple SUNPAD 3 L 3333 donne 3333 SUNPAD 3 L 1 donne 1 Divers NULL Retourne la cha ne de caract res vide IF Expr1 Expr2 Expr3 Expr4l Retourne la cha ne expr3 si expr1 est gale expr2 et retourne expr4 si expr1 n est pas gale expr2 Question Seulement le signe Exemples si nom vaut HB et pr nom vaut DANIEL IF NOM HB NOM VAUT HB PERDU donne NOM VAUT HB IF PRENOM JEAN OK donne un r sultat Cha ne vide SET VAR EXPR Affecte la valeur EXPR la variable VAR puis retourne cette valeur Exemple SET X VALEUR La variable X prend la valeur VALEUR SOUT EXPR En r ception seulement affecte la valeur de EXPR au nom du fichier de sortie qui contiendra les documents traduits en format interne l extension sera toujours RCV Exemple OUT XXX Le nom du fichier de sortie sera XXX RCV Exemple d utilisation on souhaite dissocier parmi des messages ORDERS re us les ORDERS originales donn e BGM 1225 9 des autres commandes Dans ce cas on stockera la valeur de la donn e BGM 1225 dans la variable MESFONC et on utilisera l expression SOUT IF MESFONC 9 ORIGINAL AUTRES Les commandes originales seront rout es vers ORIGINAL RCV les autres vers AUTRES RCV IN Retourne le nom du fichier
27. nt que les ann es post rieures 50 sont 19xx sinon on choisit 20xx Autres exemples YYMMDD DD MM YY HHMM HH MM Voir galement la fonction CC paragraphe 7 Note sur les formats num riques dans le cas d un format num rique le champ multiplier par permet d effectuer un d calage de d cimale Par exemple si une donn e de format interne est fournie en Grammes et qu on souhaite l mettre en KG alors il faudra diviser la valeur par 1000 donc sp cifier 3 dans le champ Multiplier par c est dire on multiplie la valeur de la donn e par 10 Bouton Condition Permet d indiquer une contrainte conditionnelle Par exemple le qualifiant de l adresse doit valoir SU La contrainte SEQ_ WITH case cocher doit tre utilis e lorsqu on souhaite mettre une condition sur un segment r p table ind finiment comme le segment LIN Auto g n r e il s agit d une cellule permettant d alimenter automatiquement une donn e du message EDI donc valable uniquement dans le sens format interne vers EDI Les donn es saisir sont le segment groupe et l ment Cf mapping ainsi que la valeur g n rer qui est une expression pouvant combiner des cha nes de caract res entre et les fonctions DATE date du jour TIME heure courante i incr mentation de compteur et PAD paddage de donn e Exemple XYZ DATE X TIME X PAD 4 L 0 4 1 donne TX2 Concept Manuel de l utilisateur d
28. ode que vous lui attribuez lors de la cr ation Par exemple COMMANDE Ce format fait r f rence un message ou subset et un seul Par exemple ORDER93A Les fichiers de param trage g n r s seront alors les suivants Param trages sources TX2 DATA COMMANDE REW et TX2 DATA COMMANDE SEQ qui produiront eux m mes automatiquement le fichier TX2 DATA COMMANDE DEF lors de la compilation Param trage compil exploit par le traducteur TX2 TX2 COMMANDE FDX Par ailleurs le format interne sera r f renc dans la table de r f rence TX2 INHREF RDX dans laquelle sont stock es les propri t s du format interne ainsi que la correspondance Format lt gt Message Cette table peut tre visualis e et maintenue manuellement en utilisant l utilitaire BPT EXE d crit en annexe R gles de gestion du traducteur En mission le format utiliser pour traduire un fichier devra tre pr cis l appel du traducteur soit explicitement soit en nommant le fichier traduire lt Code format gt INH En r ception le traducteur recherche dans la table MESSREF RDX le code message correspondant ce qui est indiqu dans le segment UNH par exemple ORDERS D 93A UN donne le code ORDER93A puis le traducteur recherche dans la table TX2 INHREF RDX le code format correspondant ce code message par exemple ORDER93A donne COMMANDE Note on peut faire d pendre le format interne du partenaire Ceci se
29. oncept Manuel de l utilisateur du Mapper 8 4 Les fonctions pr d finies Dates DATE Renvoie la date syst me sous la forme AAMMJJ DATE2 Renvoie la date syst me sous la forme CCAAMMJJ TIME Renvoie l heure syst me sous la forme HHMM TIMES Renvoie l heure syst me sous la forme HHMMSS CC lt Ann e gt FONCTION AN 2000 Renvoie le si cle partir de l ann e sur 2 positions selon la logique suivante Si ann e gt 50 alors le si cle vaut 19 sinon le si cle vaut 20 Exemples Expression R sultat SCC 98 19 CC SUB 0 2 S DTLIV 20 si SDTLIV 021024 Compteurs I Renvoie la valeur du compteur l J Renvoie la valeur du compteur I apr s l avoir incr ment de J Exemple 3 1 incr ment du compteur 3 d une valeur gale 1 I J Renvoie la valeur du compteur I puis l incr mente de J l J Renvoie la valeur du compteur apr s l avoir d cr ment de J I J Renvoie la valeur du compteur puis le d cr mente de J 1 32 32 compteurs sauvegard s entre chaque session _MESS1 MESS128 128 compteurs initialis s z ro chaque nouveau message _SESS1 SESS128 128 compteurs initialis s z ro chaque nouvelle session de traduction Arithm tique EXPR1 EXPR2 lt NBDEC gt Additionne EXPR1 et EXPR2 EXPR1 EXPR2 lt NBDEC gt Soustrait EXPR1 et EXPR2 EXPR1 EXPR2 lt NBDEC gt Multiplie EX
30. outon transco ou une r gle de formatage bouton Sp cial Dataset un dataset est une sous structure l int rieur d un enregistrement Un Dataset doit tre utilis lorsque on souhaite avoir 2 occurrences d un segment ou groupe de segments l int rieur d un m me enregistrement sans que toutes les donn es ne soient qualifi es Pour d finir un dataset vous devez s lectionner un ensemble de cellules click gauche puis Shift click gauche puis s lectionner l option de menu Donn es D finir Dataset 7 LES VARIABLES Vous avez la possibilit de d finir des variables tampons dans une description de format interne Ces variables tampon servent stocker des valeurs trouv es soit dans le fichier EDI soit dans le fichier interne et de les utiliser plus tard ce qui permet de contr ler plus facilement les instructions de mapping en particulier lorsqu il est n cessaire de r ordonner les donn es 7 1 Utilisation des variables dans un format Applicatif vers EDI Dans un format mission une variable sert stocker un champ d un enregistrement du fichier interne Pour ce faire on ins re une cellule de type Variable laquelle on attribue un nom et dont on pr cise la longueur et la position dans le fichier applicatif Par exemple variable NOMDEST position 5 longueur 20 La valeur stock e dans cette variable peut alors tre r utilis e dans une cellule de type Auto g n r e soit en prenant la valeur compl t
31. par l atelier de conception Option G n rer format EDI gt EDI Un format EDI gt EDI est trait comme un format en mission en particulier les r gles de contr les de pr sence des donn es s appliquent Rupture de message c est le crit re qui permet au traducteur de savoir quand commence un nouveau message dans le format applicatif Par exemple dans le format du paragraphe 1 c est 001 Etiquette d enregistrement Texte libre ce menu permet d indiquer si le crit re de rupture de message d crit plus haut est une tiquette d enregistrement comme c est le cas dans l exemple du paragraphe 1 ou si c est une cha ne de caract res plac e l uniquement pour a Par exemple si la structure du format interne est ENTETECDE01 19980101 IGNE ARTICLE 3000FRF REMISE10 5 TX2 Concept Manuel de l utilisateur du Mapper REMISEOS 5 IGNE ARTICLE2 450FRF REMISE10 5 ENTETECDE02 19980101 IGNE ARTICLE 3000FRF REMISE10 5 IGNE ARTICLE2 450FRF REMISE10 5 le crit re de rupture de message sera ENTETE et c est une tiquette d enregistrement Note en mission TX2 a toujours besoin d tiquettes pour identifier les enregistrements Dans le cas d un fichier mono enregistrement sans tiquette le fichier doit tre pr trait l aide de l utilitaire UTILTX2 EXE consulter le support technique
32. plus souple de g rer les tables de param trages gr ce l utilitaire BPT EXE qui permet de g rer ces tables sous forme de fichiers Texte en permettant de convertir ces tables en format texte et inversement Win 95 98 et NT seulement L ex cutable BPT EXE est install dans le r pertoire TX2 Au lancement le r pertoire courant doit tre TX2 La syntaxe d utilisation est BPT EXE RDX2TXT MESS TXT2RDX SUBS INH Le premier param tre indique le sens de conversion RDX2TXT pour une conversion de binaire vers texte TXT2RDX pour une conversion de texte vers binaire Les fichiers texte portent le m me nom que les fichiers binaires RDX et leur extension est TXT Le deuxi me param tre indique le type de la table trait e MESS pour la table des messages MESSREF RDX SUBS pour la table des subsets SUBSREF RDX et INH pour la table des formats INEREF RDX Par exemple BPT EXE RDX2TXT INH de INHREF RDX en INHREF TXT BPT EXE TXT2RDX MESS de MESSREF TXT en MESSREF RDX TX2 Concept Manuel de l utilisateur du Mapper
33. sur les segments LIN et PIA 1 occurrence par LIN et l enregistrement G0605 mappe sur le groupe SCC QTY Jusqu ici il n y a pas de probl me Mais de plus il faut crire dans l enregistrement A0900 une donn e du segment SCC qui doit correspondre la premi re r p tition du groupe SCC pour un qualifiant de QTY gal 113 Ceci ne peut pas se faire en mappant simplement la donn e du SCC dans le segment A0900 car dans ce cas TX2 ne verra plus les r p titions du SCC Il faut utiliser la fonction STACK dans le A0900 et la fonction WRITE dans le G0605 Enregistrement A0900 LIN 1229 19 2 gt LIN122S lt action de mise a jour code 6 40 235 LIN 7140 19 3 1 Numero d article 41 75 35 PIA 7140 2021 Numero d article du fabricant Type de programmation 76 78 3 STACK SCC1 FTYPPROG 79 81 3 LIN1229 TX VUUIILCERL IVIAIIUET UE I ULTISALEUT UU IViappeli Enregistrement G0605 1 5 5 G0605 6 21 16 QTY 6060 3512 Quantite a livrer 22 24 3 SCC 4017 36 1 Statut du programme SCC 2013 36 3 1 gt SCC2013 lt Type de programmation x SWRITE SCC1 L instruction STACK SCC1 typprog dans l enregistrement A0900 indique au syst me qu cet endroit l expression typprog devra tre g n r e partir de la pile SCC1 lorsque TX2 rencontrera un ordre d criture de cette pile Dans cet exemple cet ordre d criture ou d pilage est programm dans l enregistrement G0605 c est l ordre SWRITE SCC1 qui doit
34. u Mapper XYZ960123X1523X0002 pour plus de d tails sur la g n ration de constantes ou expressions voir le paragraphe 7 Filler il s agit d une cellule permettant de d clarer un Filler dans l enregistrement Cette cellule est appel e SKIP Vous devez saisir la longueur du filler Texte il s agit d une cellule permettant de forcer un texte dans le fichier applicatif donc valable uniquement dans le sens R ception Ce texte est une expression qui suit les m mes r gles que pour les donn es auto g n r es Vous devez indiquer la longueur du texte Calcul il s agit d une cellule d affecter une variable le r sultat d une expression Texte libre il s agit d un bloc d instructions qui sera ins r dans le fichier source de d finition de format permet d utiliser des instructions du traducteur non support es par le mapper Variable il s agit d une cellule permettant de mettre en correspondance une donn e du fichier interne avec une variable qui aura t d clar e au pr alable Ces variables sont d clar es en indiquant un identifiant dans le champ Stocker dans du dialogue de saisie d un mapping Pour plus de pr cisions concernant l utilisation de variables veuillez vous reporter au paragraphe suivant 6 Les variables Vous devez saisir ou s lectionner un nom de variable la longueur et ventuellement une r f rence interne De plus vous pouvez pr ciser une instruction de transcodification b
35. ules Etiquette Long Seq R p tition Description si T0200 315 9 1 Transaction c0500 642 10 1 Destinataire C1800 1113 11 0 1 Vendeur co100 851 12 0 1 Acheteur C0600 553 13 T Expediteur struct 27 R G0500 375 28 1 Sequence de Production struct 30 1 B0600 165 31 1 Instruction d emballage B0300 133 44 0 2 Type d UM d UC 47 struct 48 R A0900 187 49 1 Article programm Z0200 374 50 0 1 Texte libre 40100 904 51 0 1 Article G0600 324 52 R D tails du programme H0200 134 53 0 1 Point de d chargement H0100 66 54 0 1 Point de Destination 75 7G Z0201 474 77 0 5 Texte libre Note sur les formats d impression Pour un format d impression le bouton ou l option de menu Fichier En t te Pied de page permettent d acc der un cran de saisie des expressions en t te et pied de page Les indications de structures permettent de forcer l ordre et les niveaux de r p titions des enregistrements Ceci doit tre utilis lorsque la structure du fichier interne est loign e de la structure du message afin de lever toute ambigu t sur le traitement du message Pour d finir une structure il faut s lectionner un groupe d enregistrements en maintenant le bouton gauche de la souris appuy et s lectionner l option D finir STRUCTure ou D finir SEQ STRUCture du menu Enregistrements La notion de structure implique de renseigner les facteurs de r p tition des diff rents enregistrements Option Enregistrements R p t
Download Pdf Manuals
Related Search