Définition des correspondances

Les menus ci-dessous permettent de gérer les correspondances:

Voir aussi Paramétrer un message entrant XML

Gestion des correspondances

	Modèle : on entre ici le nom du modèle XML crée précédemment et passé en exploitation Version : on entre ici la version du modèle XML crée précédemment et passé en exploitation Correspondance : on vient nommer notre correspondance. On va lui donner un nom logique pour pouvoir l’identifier facilement ! Ici on a choisit “E-” pour “Entrant” et “STPGI” pour le nom de la balise du fichier XML, qui est “SellerTradePartyGlobalID”. Il n’y a pas d’obligations là-dessus, mais il faut pouvoir s’y retrouver par la suite ! Désignation : on va nommer notre correspondance de manière logique pour s’y retrouver ! Ici, le plus évident c’est de lui donner le même nom que la balise. Commentaire Zone de texte libre permettant de données des informations complémentaires à titre d’information.
	Type correspondance : on met évidemment “Entrant”, car c’est un message entrant qu’on est entrain de paramétrer 😉 Balise début : on vient dérouler le fichier XML pour sélectionner la balise de départ de la correspondance. C'est à dire ? Dans nos exemples présentés plus haut, on aura donc : -pour cette correspondance, balise de départ -> <rsm:ExchangedDocument> -pour cette correspondance, balise de départ -> <rsm:GlobalID> car on a directement placé la correspondance dessus Action Interne : La liste déroulante permet de sélectionner l’action interne entrante devant être exécutée par DIAPASON. Cette zone est obligatoire. On distingue trois types d’actions internes entrantes : ACT-SIM : Action simple hors entité. Correspondent aux actions disponibles par ENR-ACT-ENT en dehors de la notion d’entité. ENT-MAJ : Action simple sur entité. Correspond aux actions disponibles par ENR-ACT-ENT agissant sur les entités GFD. ENT-INI : Action d’initialisation de contexte par le biais d’une requête. Ces actions ne concernent que les messages entrants-sortants. Le principe repose sur le fait de renseigner une requête (REB ou REN) et d’indiquer sur quelle liste la correspondance doit se faire (si requête REB). Par la suite lors de l’exécution du document pour génération du message sortant, la liste donnée et la correspondance seront connues en contexte d’entrée. Entité – Requête : Permet de renseigner l’entité ou la requête suivant l’action interne saisie précédemment. Cette zone est obligatoire. Une sélection est possible sur cette zone. Cette zone n’est saisie que si l’action interne est ENT-MAJ, INI-REB ou INI-REN. Pour l’action interne ENT-MAJ, elle doit contenir une entité DIAPASON. Les entités possibles sont toutes les entités GFD de DIAPASON. Pour l’action interne INI-REB, elle doit contenir une requête de type REB. Pour l’action interne INI-REN, elle doit contenir une requête de type REN. Liste Requête : La liste déroulante permet de sélectionner la liste de la requête REB pour laquelle on souhaite faire la correspondance. Cette zone est obligatoire. Cette zone n’est saisie que si l’action interne est INI-REB.
	Transaction Unitaire Indique si une transaction unitaire sera utilisée pour la correspondance. Cette notion est prioritaire sur les notions de transaction définies sur la GFG de définition des types de messages. Visib. Bal. Sup ? Par défaut coché à oui, permet lors de la définition du détail de correspondance par rapport au modèle XML d’avoir toute l’arborescence visible ou pas . Dans le cas contraire seule la partie de l’arborescence (fils) de la balise de départ donnée (cf. Balise Départ) sera visible. Requête Début Référence requête de type REB exécuté avant le traitement de la correspondance. Voir contexte requête ci-dessous. Critères Défaut Bouton permettant de définir les caractéristiques des critères (saisie, affichage, initialisation,..) de la requête sus renseignée. Requête Fin Référence requête de type REB exécuté après traitement de la correspondance. Voir contexte requête ci-dessous. Critères Défaut Bouton permettant de définir les caractéristiques des critères (saisie, affichage, initialisation,..) de la requête sus renseignée Contexte requête Avant et Après Traitement des correspondances Dans chacune des requêtes les variables XML,SCR,VCR, les structures WfEntVar et WfEntAct sont visibles. Le contexte en entrée de requête est le suivant : SCR.EIA_MesIde : Identifiant du message que l’on traite SCR.EIA_CorRef : Référence Correspondance courante SCR.EIA_BalRef : Référence balise de départ correspondance SCR.EIA_BalIdP : Identifiant Père de la balise de départ SCR.EIA_BalIdF : Identifiant Fils de la balise de départ SCR.IAP_ModeAcc : Mode accès (Début correspondance ‘D’ ou Fin correspondance ‘F’)
	Statut Statut de la correspondance. Erreur Indique si la correspondance est ou non en erreur. Une correspondance est en erreur si le programme de traitement de cette correspondance n’a pas pu être généré. A Générer Indique si la correspondance doit ou non être générée. Une correspondance doit être générée si on modifie une des informations de définition ou si on en modifie le détail ou si la requête rattachée à la correspondance (cas des actions INI-REB et INI-REN) a été re-générée. Si la génération du programme de traitement d’une correspondance se déroule anormalement, la correspondance reste à générer Util. Création Utilisateur ayant créé la correspondance Date Création Date de création de la correspondance Heure Création Heure de création de la correspondance Util. Modification Utilisation ayant effectué la dernière modification de la correspondance. Date Modification Date de dernière modification de la correspondance Heure Modification Heure de dernière modification de la correspondance. Util. Génération Utilisateur ayant effectué la dernière génération du programme de traitement de la correspondance. Date Génération Date de dernière génération du programme de traitement de correspondance. Heure Génération Heure de dernière génération du programme de traitement de correspondance. Programme Programme de traitement de correspondance.

Quelles actions sont disponibles sur les correspondances ?

Il existe quatre méthodes de définition du détail des correspondances XML.

Définition / Modèle

Dans cette approche, le point de départ de définition d’un détail de correspondance est le modèle XML (à l’image du message XML à traiter). On raisonne en balise et on y affecte des variables.

Cette action permet de définir le détail des correspondances à partir de l’arborescence du couple modèle/version XML rattaché sur l’entête.

Le principe est de décrire les liens Balises-Information DIAPASON de façon à ce que l’action interne puisse être menée à bien.

Au fur et à mesure de la définition des détails de correspondances, les icônes du tree-view vont évoluer de façon à avoir un état visuel de l’avancement. Le tableau ci-dessous décrit les différents icônes utilisés dans cette représentation :

Les icônes vont représenter à la fois le type de balise mais aussi le type de correspondance définie pour ce lien.

	Balise	PDF	Balise Valeur	Attribut
Aucune correspondance
Correspondance sur Variable	(idem sur fond bleu)	(idem sur fond bleu)
Valeur défaut	(idem sur fond jaune)	(idem sur fond jaune)	(idem sur fond jaune)	(idem sur fond jaune)
Début de Lien		(idem sur fond vert)		(idem sur fond vert)
Fin de Lien	(idem sur fond rouge)	(idem sur fond rouge)

Pour définir le détail de correspondance, il suffit de se positionner sur la balise désirée pour accéder à la fiche de définition de sa correspondance.

Onglet « Définition » :

Ordre : Numéro ordre de traitement de la correspondance. Cet ordre permet de prioriser lors du traitement du message les affectations des variables et permet donc de se détacher de la structure du message lui-même. Par exemple, il est tout à fait envisageable d’avoir un message XML présentant une balise <OF> suivie d’une balise <Etape> et de vouloir d’abord initialiser la variable réceptionnant la valeur de la balise <Etape>.
Variable : Référence variable associée à la balise. Les variables possibles sont déterminées en fonction de l’action interne (définie sur l’entête de correspondance). Le tableau ci-dessous présente un récapitulatif des variables par action interne :

Action	Type	Description	O ?
ACT-AP-RE	VFL SFL XML	Variables Standard (APL) Variables Spécifiques (APL) Variables XML Variables de l’action : AppLigDatRec => Date réception AppLigQteIntRec => Quantité Interne Déclarée AppNumBL => Numéro de BL RefPalette => Numéro de palette RefTypePalette=> Type Palette
ACT-FA-DE	XML	Variables XML Variables de l’action : CdeNumCom => Numéro de cde de production CdeNumLig => Numéro de ligne de cde. GamEtaRef => Référence étape file d'attente GenEnrRefUtilCre => Utilisateur origine Déclaration GenRefArt => Référence article GenRefTypeArt => Type article (C ou R) LanSerCTRef => Référence Caractéristique Technique LanSerFabDecCtx => Contexte Déclaration de fabrication LanSerFabDecMod =>Mode de déclaration LanSerFabOF => Numero d'OF LanSerFabQteDec => Qte déclarée. LanSerFabQteTyp => Déc. / Reste à Fabriquer ou /Qté Condi. LanSerFabQteUnMe => Unité de mesure déclaration. LanSerReeDecDat => Date de déclaration. LanSerReeDecHeu => Heure Réelle de déclaration LanSerRef => Référence Série LanSerRLRef =>Référence Regroupement Local RefEmplaStock =>Reference emplacement stock. RefPalette => Numéro de palette. RefTypePalette => Type palette. ResGenRef => Référence ressource Déclaration StoFluSecEntRef => Section entrée en stock. SuiIdeRef =>Identifiant annulation de déclaration
ACT-INF-SUI	XML	Variables XML Variables de l’action : Action => Action à mener FatCatDecCl2 => Référence Etape FatCatDecEnt =>Entité pour Informations Suivies FatCatDecEntRef => Référence Entité FatCatDecRef =>Référence Famille Informations Suivies LanModTyp =>Mode Lancement sur Entité.	+ + + +
ACT-ORDO	XML	Variables XML
ACT-PRO	XML	Variables XML
ACT-STO-IND	XML	Variables XML Variables de l’action : Action => Action à mener EntCl1 => Référence Inventaire InvDes => Désignation Inventaire InvGenListePrevDate => Date Prévue Gén. Liste Comptage InvGenListePrevHeure => Heure Prévue Gén. Liste Comptage InvPhotoPrevDate => Date Prévue pour Photo. InvPhotoPrevHeure => Heure Prévue pour Photo InvTyp => Référence Inventaire Type	+ + +
ENT-MAJ	XML	Variables XML Variables de l’action : Action => Action à réaliser Présentation => Présentation
INI-CTX	XML SCR VCR	Variables XML Variables Standards Critères Variables Spécifiques Critères
INI-REB	XML SCR VCR	Variables XML Variables Standards Critères Variables Spécifiques Critères Champs de la liste de la requête REB définie sur l’entête
INI-REN	XML SCR VCR	Variables XML Variables Standards Critères Variables Spécifiques Critères

Balise Bouton permettant de sélectionner la balise sur laquelle la correspondance doit s’effectuer. Cette zone est inactive dans ce cadre de définition puisque le choix de la balise se fait en se positionnant dessus dans le tree-view.
Visib. Bal. Sup. Si coché, ce flag indique que si la balise en cours de définition n’est pas présente dans le message (occurrence 0/1 ou 0/n), DIAPASON remontera les niveaux d’arborescence du message XML traité et cherchera la première balise ayant le même nom. Si il en trouve une, il affectera alors la valeur à la variable rattachée à la balise non présente.
Formule Référence formule. Possibilité de re-travailler la valeur de la balise courante par rapport à des règles données (exemple, calcul d’une variable date à partir de trois balises <jour>, <mois>, <annee>). Voir chapitre détaillant la définition des formules.
Par. 1 Formule Paramètre d’entrée éventuel de la formule.
Par. 2 Formule Paramètre d’entrée éventuel de la formule.
Par. 3 Formule Paramètre d’entrée éventuel de la formule.
Par. 4 Formule Paramètre d’entrée éventuel de la formule.
Par. 5 Formule Paramètre d’entrée éventuel de la formule.
Valeur Alpha. Valeur défaut alphanumérique. Ce champ est actif si la variable associée est de type alphanumérique.
Valeur Num. Valeur défaut numérique. Ce champ est actif si la variable associée est de type réel ou entier.
Valeur Date Valeur défaut date. Ce champ est actif si la variable associée est de type date.
Valeur Log. Valeur défaut logique. Ce champ est actif si la variable associée est de type logique.

Principe d’affectation des valeurs défaut :

La variable associée est initialisée par sa valeur défaut définie sur sa définition. Si une valeur défaut est définie au niveau de la correspondance, alors elle lui est affectée. Enfin si la lecture du message renvoie une valeur par rapport à la balise donnée, alors elle lui est affectée.

Onglet « MàJ Complémentaires »

MàJ Comp. Le bouton permet d’accéder à un éditeur en saisie pour insérer un bloc Progress exécuté en fin de traitement de la correspondance. Ainsi il est possible de re-travailler la valeur récupérée selon des règles de gestion éventuelles.

Onglet « Définition Balise »

Toutes les informations de cet onglet sont en consultation. Elles permettent d’avoir en ligne les informations inhérentes à la balise courante.

Type Nœud: Indique le type de la balise. Les différents types sont :
- ‘B’ : balise. Ce type défini un ensemble (fils) de balises de tout type.
- ‘V’ : Valeur. Une balise valeur est une balise de dernier niveau (aucun fils) contenant une valeur.
- ‘A’ : Attribut. Une balise attribut décrit plusieurs valeurs chacune étant décrite par Var = Valeur et ce, dans le référencement de la balise elle-même (exemple : <Balise_Attr Var1=Val1 Var2=Val2 ... /> )
N° Enfant : Numéro ordre de description dans le modèle XML par rapport à la balise père.
Modèle Pré-Défi. : Si renseigné, ce champ indique que la balise provient de ce dit modèle pré-défini. Voir chapitre détaillant la gestion des modèles XML.
Version Pré-Défi. : Si renseigné, ce champ indique que la balise provient de ladite version du modèle pré-défini sus renseigné. Voir chapitre détaillant la gestion des modèles XML.
Référence : Référence ou nom de la balise.
Désignation : Désignation de la balise.
Occurrence: Règle permettant d’indiquer si une balise est obligatoirement existante dans un message XML et si oui permet d’indiquer si elle peut se répéter ou non :
- 1/1 : Balise obligatoirement présente dans le message. Elle y sera qu’une fois.
- 1/n : Balise obligatoirement présente dans le message. Elle peut être répétée.
- 0/1 : Balise non obligatoirement présente dans le message. Dans le cas où elle est présente, elle n’y sera qu’une fois.
- 0/n : Balise non obligatoirement présente dans le message. Dans le cas où elle est présente, elle peut être répétée.
Format XML : Zone non gérée actuellement, Sert à titre d’information.
Format Diapas. : Zone non gérée actuellement. Sert à titre d’information.
Commentaire Texte libre permettant de donner des informations complémentaires éventuelles.

Définition / Variables

Application identique à celle décrite précédemment mais avec une approche différente. On raisonne par rapport aux variables de l’action à mener et on réalise le rattachement des balises sur chacune. Lors de la création d’un détail, l’accès à la GFG de définition présente une liste vide et on est directement positionné en création sur la fiche.

La description de la fiche est identique à celle décrite précédemment dans l’action “Définition/modèle”

Variable : Référence variable de l’action interne (définie sur l’entête de correspondance) sur laquelle va être définie la correspondance avec une balise du couple modèle/version XML. L’action de sélection ne présente que les variables possibles en fonction de l’action interne.
Balise : Le bouton lance un tree-view représentant l’arborescence du couple modèle/version XML. La sélection de la balise se fait donc depuis cette arborescence.

Définition / Variables Obligatoires

Même principe que “Définition / Variables” si ce n’est que la liste est pré-initialisée avec les variables de l’action interne (définie sur l’entête de correspondance). Toutefois la notion “Obligatoire” n’est à ce jour considérée que sur les actions reposant sur une entité. En ce qui concerne les actions internes entrantes, seule l’action ACT-AP-RE repose sur une entité (APL) et cette application n’a de ce fait d’intérêt que pour cette action interne entrante (l’intérêt est plus évident sur les actions internes sortantes dont la majorité repose sur une entité). La saisie dans la fiche correspond du coup à une modification et non à une création.

Définition / Toutes Variables

Même principe que “Définition / Variables” si ce n’est que la liste est pré-initialisée avec toutes les variables de l’action interne. La saisie dans la fiche correspond du coup à une modification et non à une création.

Il est donc possible d’affecter les balises sur les variables voulues et de supprimer les variables non nécessaires au traitement de l’action.

Voir Définition du détail des correspondances

Chacune de ces méthodes correspond à une action depuis la liste des entêtes de correspondances.

Actions de Génération des Correspondances: trois actions permettent de regénérer les correspondances :

Correspondances Sélectionnées : les correspondances sélectionnées (ou la correspondance courante si aucune sélection n’a été faite)
Correspondances à Re-Générer : toutes les correspondances ayant été modifiées et n’ayant pas été régénérées (Information «A Générer» cochée).

Une branche de l’explorateur applicatif des Echanges Inter-Applicatifs, « Correspondances à Générer » présente la liste de toutes les correspondances à régénérer.

Toutes les Correspondances : toutes les correspondances

Ces actions de génération lancent le traitement GEN-REQ qui peut être exécuté en mode interactif ou en mode batch.

Action de Génération « Environnement EIA à Régénérer » : Cette action permet de regénérer, tous les types de messages, les correspondances et les documents à Re-Générer.

On peut également définir les correspondances via les actions “Définition/ Variable”

Correspondances en Anomalie

Cette application présente toutes les correspondances présentant au moins une anomalie suite à une modification du modèle/version XML en exploitation sur lequel l’action “transfert forcé” a été effectué. Il est alors possible de lever les ambiguïtés par le biais des actions de modification ou de suppression.

Description de la liste :

Ambiguïté : Ce flag indique si la correspondance présente une ambiguïté par rapport au modèle/version XML. En effet, les modèles/versions XML peuvent évoluer de façon indépendante par rapport aux correspondances déjà définies et donc provoquer des ambiguïtés. Ces dernières sont repérées lors du transfert d’un modèle/version en exploitation. Voir le chapitre concernant la définition des modèles XML qui détaille les différents cas d’ambiguïté.
Erreur : Descriptif de l’erreur à l’origine de l’ambiguïté.
Proposition : Lors du transfert en mode forcé, l’algorithme de contrôle d’intégrité tente de trouver des liens possibles entre la nouvelle structure du modèle/version XML et les correspondances déjà définies et pour lesquelles il a trouvé une ambiguïté.
Modèle : Référence modèle XML en exploitation servant de support pour la définition de la correspondance.
Version : Version du modèle XML en exploitation sus cité.
Correspondance : Référence correspondance.
Ordre : Numéro ordre de traitement du détail de correspondance (initialisation variable associée)
Variable : Référence variable concernée par le détail de correspondance courant.
Désignation Variable : Désignation de la variable sus citée.
Balise : Référence balise rattachée à la variable.
Désignation Balise : Désignation de la balise sus citée.
Format : Format de la variable.
Valeur Alpha. : Valeur défaut de la correspondance si variable de type alphanumérique
Valeur Num. : Valeur défaut de la correspondance si variable de type numérique
Valeur Date : Valeur défaut de la correspondance si variable de type date
Valeur Log. : Valeur défaut de la correspondance si variable de type logique
Formule : Référence formule utilisée pour calcul particulier sur la variable.
Désignation Formule : Désignation de la formule.
MàJ Complémentaire : Flag indiquant si un bloc Progress exécuté après traitement du détail de correspondance a été défini ou non.

Correspondances à Générer

Une correspondance ne peut être utilisée dans DIAPASON que si elle a été générée. La phase de génération consiste en la génération d’un programme Progress traduisant toutes les affectations de variables impliquées dans la correspondance.

Cette application présente donc toutes les correspondances créées ou celles pour lesquelles au moins une modification a été apportée au niveau de son détail.