EIA- Paramétrage des Echanges Inter-Applicatifs

Modèles XML

Modèles XML en Exploitation

Les modèles XML en exploitation sont des modèles XML ayant été transférés depuis les modèles en développement et auxquels on a donné une version lors du transfert.

Cette application est identique à la définition des modèles en développement mais les seules actions possibles sont :

• Actions standards GFG : Modification, Suppression

• Visualisation Structure

Cette action permet de visualiser la structure du modèle XML. Aucune action de gestion n’est possible sur la structure XML (cf. Paramétrage des Correspondances XML Entrantes et Paramétrage des Correspondances XML Sortantes).

• Définition Structure

Cette action est identique à la précédente mais il est possible d’accéder à l’application de définition des correspondances depuis la structure du modèle XML (cf. Paramétrage des Correspondances XML Entrantes et Paramétrage des Correspondances XML Sortantes).

• Développement

Cette action permet de transférer la structure du modèle XML courant dans le modèle en développement correspondant.

Modèles XML en Développement

La définition des modèles XML se fait uniquement depuis l’application de définition des modèles XML en développement.

L’application de définition d’un modèle XML en développement est une application de type GFG.

Onglet « Définition »

• Modèle XML

Référence du Modèle

• Version

Version du Modèle. Paramètre toutes sociétés (XML, VER) indiquant la version du modèle. « 0 » est la version de développement. Cette zone n’est pas saisie.

• Type Modèle

Type de Modèle. Cette zone est initialisée à D et n’est pas saisie.

Les types de modèles XML possibles sont :

• Mode Modèle

Mode de Gestion du modèle XML.

Les modes possibles sont :

• Version Défaut ?

• Indique si cette version est la version défaut du modèle. Non gérée.

• Désignation

Désignation du Modèle

• Mot Directeur

Mot Directeur du Modèle

• Famille

La liste déroulante présente les familles de modèles définies dans les paramètres utilisateurs pour l’entité XML et le groupe FAM.

• Sous-Famille

La liste déroulante présente les familles de modèles définies dans les paramètres utilisateurs pour l’entité XML et le groupe SFA.

• Commentaire

Un éditeur permet de renseigner un commentaire pour le modèle.

• Disponible ?

Indique si cette version du modèle est disponible. Non géré.

• Balise Départ

Balise de départ du fichier XML. Si non renseignée, la balise principale entourant tout le message est la référence du modèle

• Fichier XSD

Fichier de type « .xsd » associé. Non géré.

• Fichier Exemple

Fichier exemple.

Ce fichier est visualisable dans l’onglet « Exemple ».

Onglet « Qui, Quand ? » 

• Util. Création

Utilisateur ayant créé le modèle

• Date Création

Date de création du modèle

• Heure Création

Heure de création du modèle

• Util. Transfert

Utilisateur ayant effectué le dernier transfert en exploitation du modèle

• Date Transfert

Date du dernier transfert en exploitation du modèle

• Heure Transfert

Heure du dernier transfert en exploitation du modèle

Sur cette application les actions possibles sont :

• Actions standards GFG : Création, Modification, Duplication, Suppression

• Visualisation Structure

Cette action permet de visualiser la structure du modèle XML. Aucune action de gestion n’est possible sur la structure.

• Définition Structure

Cette action est identique à la précédente mais les actions de gestion de la structure sont disponibles.

• Initialisation Structure

Cette action permet de générer la structure d’un modèle XML à partir d’un message XML donné. L’interprétation des balises par DIAPASON est faite avec la fonction de lecture XML (ismlxmli.p). La référence de la balise est le nom de la balise.

L’action lance une fiche dont le contenu paramètre le comportement de l’algorithme de lecture :

• Fichier

Fichier XML origine. Donner un chemin absolu visible par DIAPASON.

• Init. Des. / Balise

Si coché, indique que la désignation des balises créées sera égale à la balise originelle dans le message. Par exemple, une balise « Variable » va donner comme désignation : <Variable>.

• Init. Com. / Contenu

Si coché, indique que le commentaire des balises créées sera égal au contenu originel de la balise dans le message.

Par exemple, une balise « Variable » va donner comme commentaire : <Variable>valeur</Variable>.

• Occurrence Unitaire Nulle

Indique si coché que les balises n’apparaissant qu’une fois sur un niveau auront une occurrence « 0/1 » au lieu de « 1/1 ».

• Occurrence Multiple Nulle

Indique si coché que les balises apparaissant plusieurs fois sur un niveau auront une occurrence « 0/n » au lieu de « 1/n ».

Le résultat donne :

• Transfert en Exploitation Forcé

Pour pouvoir utiliser un message XML dans DIAPASON, il faut le transférer en exploitation et lui donner une version. Les numéros de version sont libres et sont définis dans le paramètre toute société d’entité XML et de groupe VER.

Cette action permet de sélectionner la version d’exploitation du modèle, puis effectue un contrôle d’intégrité général dépendant du mode de message (0/9). Si le contrôle est bon, le modèle est recopié dans la version choisie. Si le modèle existait déjà dans cette version, il est écrasé. Si un problème intervient lors du contrôle (référence nœud qui boucle, modèle Pré-Défini n’existant plus, etc.), une trace affiche le détail du problème.

• Transfert en Exploitation

Cette action fonctionne comme la précédente, mais lors du transfert en exploitation dans une version déjà existante, si une des correspondances présente une anomalie (ambiguïté sur une référence balise, etc…) le transfert en exploitation ne sera pas effectué. L’action « Simulation Exploitation » permet de visualiser les problèmes constatés.

• Simulation Exploitation

Cette action est identique à la précédente mais seul le contrôle d’intégrité est effectué.

Structure d’un modèle XML

La description de la structure d’un modèle XML s’effectue par le biais d’un outil de type « TreeView » (similaire à celui de gestion des nomenclatures) qui permet de dessiner l’arborescence des balises du modèle :

Onglet « Définition »

• Type Nœud

La liste déroulante permet de sélectionner le type de nœud. Cette zone est obligatoire.

Les différents types de nœuds sont :

• N° Enfant

Numéro d’ordre du nœud sur le nœud père. Calculé automatiquement et non saisi.

• Modèle Pré-Déf.

Référence du modèle XML pré-défini à insérer dans la structure. Cette zone est saisie uniquement si le type de nœud est P et est obligatoire dans ce cas. Une sélection est possible sur cette zone.

• Version Pré-Déf.

La liste déroulante permet de sélectionner une des versions du modèle pré-défini saisi précédemment. Cette zone est saisie uniquement si le type de nœud est P et est obligatoire dans ce cas.

• Référence

Nom de la balise. Cette zone est obligatoire et est initialisée avec la référence du modèle prédéfini si le type de nœud est P.

• Désignation

Désignation du nœud. Cette zone est initialisée avec la désignation du modèle prédéfini si le type de nœud est P.

• Occurrence

Occurrence du nœud. Permet d’indiquer le nombre de fois où peut apparaître le nom dans le message. Les occurrences possibles sont :

• Format XML

Format XML du nœud. Non géré.

• Format DIAPASON

Format DIAPASON du nœud. Sur cette zone une sélection est possible. Non géré.

• Commentaire

Un éditeur permet de renseigner un commentaire pour le nœud.

Onglet « Correspondances »

• Correspondances

Un éditeur présente la liste des correspondances utilisant la même référence balise que celle de la balise courante sous la forme :

Version ; Référence_Correspondance => Variable_associée_à_la_balise.

Onglet « Qui, Quand ? » 

• Util. Création

Utilisateur ayant créée le nœud.

• Date Création

Date de création du nœud.

• Heure Création

Heure de création du nœud.

• Util. Modification

Utilisateur ayant effectué la dernière modification du nœud.

• Date Modification

Date de dernière modification du nœud.

• Heure Modification

Heure de dernière modification du nœud.

Sur la structure du modèle XML, les actions possibles sont (aucune action n’est possible sur les nœuds appartenant un modèle pré-défini :

• Ajouter Avant

Cette action permet d’ajouter un nœud avant le nœud courant

• Ajouter Après

Cette action permet d’ajouter un nœud après le nœud courant.

• Ajouter Niveau Inférieur

Cette action permet de créer un nœud au niveau inférieur de la balise courante. Cette action n’est pas disponible sur les nœud de type A et V

• Modification

Cette action permet de modifier les informations du nœud courant.

• Supprimer

Cette action permet de supprimer (couper) le nœud courant ainsi que les nœuds de niveaux inférieurs. Cette action n’est pas disponible sur les nœuds de type A.

• Supprimer Lien

Cette action permet de supprimer (couper) le nœud courant uniquement.

• Copier

Cette action permet de copier un nœud ainsi que tous les nœuds de niveaux inférieurs.

• Coller Avant

Cette action permet de coller le(s) nœud(s) copiés ou coupés avant le nœud courant.

• Coller Après

Cette action permet de coller le(s) nœud(s) copiés ou coupés après le nœud courant.

• Coller Niveau Inférieur

Cette action permet de coller le(s) nœud(s) copiés ou coupés au niveau inférieur au nœud courant.

• Cas d’Emploi

Cette action permet de visualiser toutes les versions de modèles XML utilisant la référence balise courante (avec l’arborescence complète d’accès au nœud).

Modèles Pré-Définis

Les modèles XML pré-définis sont des parties «standards» d’arborescence de modèles XML pouvant être insérées lors de la définition de structure d’un modèle XML.

Leur gestion est identique à celle des modèles XML, c’est-à-dire qu’ils doivent être définis en développement puis être transférés en exploitation avec association d’une version.

Seuls les modèles pré-définis en exploitation pourront ensuite être utilisés dans la définition de structure des modèles.

Norme XML

La lecture et l’écriture des fichiers XML dans DIAPASON repose sur la norme W3C (World Wide Web Consortium). C’est à ce jour la référence pour la formalisation des échanges via fichiers XML.

En ce qui concerne l’ordre d’écriture des balises de type attribut, la règle est la suivante :

• L’ordre des attributs n’est pas significatif.

• Les attributs sont écrits dans l’ordre alphabétique

Il existe d’autres normes de formalisation XML qui ont une influence dans la manière de restituer le fichier. Aussi un même fichier XML pourra être différent (dans l’ordre des attributs notamment) suivant le parseur XML qui l’interprète.

Afin de cadrer au mieux à la représentation XML, DIAPASON présente les balises de type « attribut » en premier lieu telles qu’on peut les lire dans le fichier XML. Les attributs sont représentés par

Anciennes versions DIAPASON	Nouvelle version DIAPASON

Paramètres Moniteur EIA 

Les applications contenues dans la branche ‘Paramètres Moniteur EIA’ permettent de gérer des paramètres qui pourront être utilisés dans le module Echanges Inter-Applicatif et de consulter des informations utiles à la définition des messages.

Dossiers Moniteur EIA

Cette application permet de définir les différents dossiers de rangement gérés dans le moniteur EIA. Ces dossiers de rangement peuvent être renseignés sur l’application de définition des Types de Message

Paramètre Utilisateur avec comme ENTITE =EIA et GROUPE =DOS-BL

Voici les champs utilisés :

• Référence

Référence du dossier.

• Désignation

Désignation associée à la référence dossier

• Commentaire

Il est possible de renseigner une référence icône sur le commentaire de 1.

Niveau d’Importance Message

Cette application permet de définir les différents niveaux d’importance gérés dans le moniteur EIA. Ces niveaux d’importance peuvent être renseignés sur l’application de définition des Types de Message. Paramètre Utilisateur avec comme ENTITE =EIA et GROUPE =NIV-IMP

Voici les champs utilisés :

• Référence

Référence du niveau d’importance.

• Désignation

Désignation associée au niveau d’importance.

• Commentaire

Il est possible de renseigner une référence icône sur le commentaire.

Versions Modèles XML

Cette application permet de définir les différentes versions XML utilisées au niveau des modèles XML. Ces versions XML sont renseignées lors du transfert d’un modèle XML en développement vers un modèle XML en exploitation.

Paramètre Utilisateur avec comme ENTITE =XML et GROUPE =VER

Voici les champs utilisés :

• Référence

Référence de la version XML.

• Désignation

Désignation associée à la version XML.

Familles XML

Cette application permet de définir les différentes familles XML utilisées au niveau des modèles XML. Ces familles XML sont renseignées lors de la définition d’un modèle XML. Paramètre Utilisateur avec comme ENTITE =XML et GROUPE =FAM

Voici les champs utilisés :

• Référence

Référence de la famille XML.

• Désignation

Désignation associée à la famille XML.

Sous-Familles XML

Cette application permet de définir les différentes sous-familles XML utilisées au niveau des modèles XML. Ces sous-familles XML sont renseignées lors de la définition d’un modèle XML. Paramètre Utilisateur avec comme ENTITE =XML et GROUPE =SFA

Voici les champs utilisés :

• Référence

Référence de la sous-famille XML.

• Désignation

Désignation associée à la sous-famille XML.

Familles Types de Messages

Cette application permet de définir les différentes familles utilisées au niveau des types de messages. Ces familles Types de Messages sont renseignées lors de la définition d’un message entrant, d’une transaction sortante ou d’un message sortant. Paramètre Utilisateur avec comme ENTITE =EIA et GROUPE =TME-FAM

Voici les champs utilisés :

• Référence

Référence de la famille type de message.

• Désignation

Désignation associée à la famille type de message.

Sous-Familles Types de Messages

Cette application permet de définir les différentes sous-familles utilisées au niveau des types de messages. Ces sous-familles Types de Messages sont renseignées lors de la définition d’un message entrant, d’une transaction sortante ou d’un message sortant. Paramètre Utilisateur avec comme ENTITE =EIA et GROUPE =TME-SFA

Voici les champs utilisés :

• Référence

Référence de la sous-famille type de message.

• Désignation

Désignation associée à la sous-famille type de message.

Répertoires de Travail

Cette application permet de définir les différents répertoires de travail utilisés au niveau des types de messages. Ces répertoires de travail sont renseignés lors de la définition d’un message entrant. Paramètre Utilisateur avec comme ENTITE =EIA et GROUPE =REP-TRV

Voici les champs utilisés :

• Référence

Référence du répertoire de travail.

• Désignation

Nom du répertoire de travail avec son chemin complet.

Répertoires des Erreurs

Cette application permet de définir les différents répertoires contenant les messages en erreur utilisés au niveau des types de messages. Ces répertoires d’erreur sont renseignés lors de la définition d’un message entrant. Paramètre Utilisateur avec comme ENTITE =EIA et GROUPE =REP-ERR

Voici les champs utilisés :

• Référence

Référence du répertoire des erreurs.

• Désignation

Nom du répertoire des erreurs avec son chemin complet.

Répertoires d’Archivage

Cette application permet de définir les différents répertoires d’archivage des messages utilisés au niveau des types de messages. Ces répertoires d’erreur sont renseignés lors de la définition d’un message entrant, d’une transaction sortante ou d’un message sortant. Paramètre Utilisateur avec comme ENTITE =EIA et GROUPE =REP-ARC

Voici les champs utilisés :

• Référence

Référence du répertoire d’archivage.

• Désignation

Nom du répertoire d’archivage avec son chemin complet.

Traçabilité Messages Sortants

Cette application permet de renseigner le message sortant à utiliser par défaut lors de l’envoi de mail avec traçabilité dans la cas où le message sortant n’a pas été défini sur le document. Paramètre Utilisateur avec comme ENTITE=EIA, GROUPE=TRC-MES et PARAMETRE=0. Cette application permet uniquement de modifier ce paramètre.

Voici les champs modifiables :

• Désignation

Désignation du paramètre.

• Commentaire

La première ligne du commentaire contient, sous forme de liste chaînée (avec comme séparateur « , »), la référence du serveur de messagerie et le message sortant utilisés pour la traçabilité des mails dans le moniteur EIA

Evénements Entrants pour EIA

Cette application permet de consulter la structure des actions internes Diapason permettant de définir des événements entrants dans le moniteur EIA.

Dans la définition des messages entrants de type événement, l’action interne doit être renseignée sur le message entrant et les variables doivent être utilisées pour définir la structure de l’événement.

Description de la liste :

• Action Interne

Référence de l’action interne Diapason

• Désignation

Désignation de l’action interne Diapason

• Domaine

Domaine applicatif de Diapason auquel est rattachée l’action interne

• Détail

Si coché, indique qu’un détail est défini pour l’action interne

Description de la fiche :

• Action Interne

Référence de l’action interne Diapason

• Désignation

Désignation de l’action interne Diapason

• Domaine

Domaine applicatif de Diapason auquel est rattachée l’action interne

• Commentaire

Commentaire associé à l’action interne donnant des informations complémentaires pour l’utilisation de l’action interne

• Détail

Si coché, indique qu’un détail est défini pour l’action interne

Sur cette application, les actions de gestion ne sont pas disponibles et une action permet de visualiser la structure de l’action interne.

• Détail Action Interne

Description de la liste

• Variable

Référence de la variable

• Désignation

Désignation de la variable

• Clé ?

Si coché, indique que la variable correspond à un champ clé de la table sur laquelle porte l’action interne.

• Obligatoire

Si coché, indique que la variable doit être obligatoirement renseignée dans l’événement

• Commentaire

Commentaire associé à la variable

• Cadre Utilisation Variable

Cadre d’utilisation de la variable. Non utilisé.

• Type de Variable

Type de la variable. Les types de variables sont (C)aractère, (N)umérique, (D)ate, (L)ogique

• Val. Déf. Num.

Valeur par défaut de la variable si elle est de type numérique

• Val. Déf. Date

Valeur par défaut de la variable si elle est de type date

• Val. Déf. Log.

Valeur par défaut de la variable si elle est de type logique

• Val. Déf. Car.

Valeur par défaut de la variable si elle est de type caractère

Evénements Sortants pour EIA

Cette application permet de consulter la structure des actions internes Diapason permettant de définir des événements sortants dans le moniteur EIA.

Dans la définition des transactions sortantes de type événement, l’action interne doit être renseignée sur la transaction sortante et les variables doivent être utilisées pour définir la structure de l’événement.

Cette application est identique à la consultation des Evénements Entrants pour EIA

Actions Internes pour Transactions Sortantes

Cette application permet de consulter la structure des actions internes Diapason permettant de définir des transactions sortantes dans le moniteur EIA.

Dans la définition des transactions sortantes , l’action interne doit être renseignée sur la transaction sortante et les variables doivent être rattachées à des balises dans les correspondances XML.

Cette application est identique à la consultation des Evénements Entrants pour EIA