Définition des types de message

Les types de message sont accessibles ici :

	Référence : Référence Type de Message Désignation : Désignation du Type de Message Mot Directeur : Mot Directeur du Type de Message Famille : Référence famille du Type de Message. Ce champ a pour but de classer les types de messages définis. Lien avec Paramètre Utilisateur ‘EIA/TME-FAM’. Sous-Famille : Référence sous-famille du Type de Message. Ce champ a pour but de classer les types de messages définis. Lien avec Paramètre Utilisateur “EIA/TME-SFA”. Commentaire : Commentaire libre. Mode Traitement : Le mode de traitement influe directement sur la manière dont le message va être interprété par DIAPASON. Les différents modes de traitement sont : ‘0’ : Correspondance XML. Ce mode de traitement implique que le message associé à ce type de message est au format XML, qu’un couple modèle/version XML en exploitation est défini dans DIAPASON pour interpréter ce message, enfin qu’il existe au moins une correspondance définie sur le couple modèle/version XML de façon à pouvoir faire le lien entre les données lues dans le fichiers et les mises à jour dans DIAPASON qu’elles impliquent. ‘1’ : Message Entrant-Sortant. Ce mode de traitement implique que la résultante du traitement sera la génération par DIAPASON d’un message sortant. Ce mode autorise les messages de tout format, ce dernier étant précisé dans la suite de la définition du type de message. ‘9’ : Décryptage Complexe. Ce mode de traitement passe obligatoirement par l’exécution d’une requête REB pour la lecture et le traitement du message. Ce mode est obligatoirement dédié aux fichiers au format ASCII et aux fichiers XML type DTCAM pour lesquels il est complexe de modéliser une correspondance par rapport aux mises à jour induites. Dans ce cas, la liste « WfFicTransfert » est alimentée et exploitable dans la REB. ‘99’ : Evènement. Ce mode de traitement est dédié à la réception des évènements. L’action interne est obligatoirement indiquée. Cette gestion remplace l’ancienne gestion des évènements DIAPASON. Modèle XML : Référence modèle XML utilisé pour la lecture et le traitement du message. Le modèle est forcément un modèle en exploitation. Cette zone est active pour les modes de traitement ‘0’, ‘1’ et ‘9’. Version XML : Numéro de version associé au modèle XML. La version est forcément une version en exploitation. Cette zone est active pour les modes de traitement ‘0’, ‘1’, et ‘9’. Action Interne : Référence action interne à mener par DIAPASON. Cette zone concerne uniquement le mode de traitement ‘99’ (Evènements). Les actions internes disponibles sont visibles dans l’application de consultation des actions internes. Entité : Zone non saisissable. Renseignée uniquement pour les modes de traitement ‘99’ (Evènements). Indique la référence entité (au sens DIAPASON) sur laquelle la mise à jour aura lieu.
	Onglet « Réception Message » Cet onglet a pour but de définir les caractéristiques de réception d’un message. Type Pré. Enreg Permet de définir des règles d’enregistrement du message dans la boîte aux lettres du moniteur EIA. Ces règles sont dépendantes du contenu du message. Actuellement cette zone n’est pas gérée (un seul choix possible => Sans Contrôle). Règles Déc./ Détermine les règles de déclenchement du message, conditionne la réception proprement dite du message dans la boîte aux lettres du moniteur EIA. Les règles existantes sont : 0-Enregistre le message entrant : Le message est toujours réceptionné, aucun contrôle particulier n’est effectué. 1-Supprime les messages en erreur : Le message est toujours réceptionné, s’il existe des messages identiques en erreur, ils seront supprimés. Des messages sont dits identiques lorsqu’ils ont la même clé d’identification. 2-Supprime le message en cours : S’il existe au moins un message identique dans la boîte aux lettres du moniteur EIA et que ce dernier n’est pas traité, la réception du message en cours n’est pas effectuée. 3-Transfère le message dans BL erreur : Le message est toujours réceptionné mais s’il existe un message identique en erreur alors il sera réceptionné dans la boite aux lettres des éléments en erreur. Synchronisé ? Ce flag indique si le traitement du message doit s’enchaîner automatiquement dés la phase de réception terminée. Niv. Importance Niveau d'importance : les valeurs possibles sont issues des paramètres utilisateurs toutes sociétés ‘EIA’, ‘NIV-IMP’. Attention cette notion n’a pas pour but de prioriser les messages dans les boites aux lettres du moniteur. Il sera possible toutefois d’utiliser cette zone pour des filtres dans les listes du moniteur. Dossier BL EIA Référence dossier dans lequel le message va être réceptionné. Les valeurs possibles sont issues des paramètres utilisateur toutes sociétés ‘EIA/DOS-BL’. Conf. Récep ? Ce flag indique si DIAPASON doit envoyer ou non une confirmation de réception pour ce message. Doc. Conf. Rec. Référence document pour la confirmation de réception. Les champs suivants sont issus de la lecture du fichier, aussi est-il possible de définir pour chacun d’eux une règle dont la syntaxe est : <Balise> : Le champ contenant cette syntaxe sera affecté par la valeur de la balise donnée. Format XML uniquement. <Balise1> ;<Balise2> : idem que règle précédente, les valeurs des balises sont concaténées. Format XML uniquement. Valeur : Il est possible de donner une valeur constante. Cette syntaxe est valable quel que soit le format du fichier (XML ou Autre). CHAINE[ligne,colonne,longueur] OU CHAINE[ligne,séparateur,numéro mot] : concerne exclusivement les fichiers au format ASCII, le champ prendra la valeur de la chaîne dont le positionnement est donnée entre crochets suivant le format du contenu du fichier (concaténé ou liste chaînée). Pour les fichiers XML, il est possible de donner le chemin complet de la référence balise dans le cas ou la balise souhaitée existe plusieurs fois dans le message. La syntaxe est la suivant <Balise1/Balise2/Balise3/Balise>. Clé Clé d’identification du message. Permet d’identifier un message (voir Règles Déc. ci-dessus), Emetteur Référence de l’émetteur du message. Objet Description générale du message. Application Ori. Référence Application dont le message est issu. Société Ori. Référence Société dont le message est issu. Pièces Jointes Liste chaînée des noms de fichiers composants les pièces jointes du message. Req.Comp.Ide Référence requête REB permettant de définir ou re-définir les caractéristiques de chacun des messages en cours de réception. Le contexte de la requête est le suivant : WFEIALisMes : Liste des messages en cours de réception SCR.EIA_TypRec : Référence Type de Réception en cours SCR.EIA_FicRef : Référence du message courant SCR.EIA_SocMes : Référence société du message (= société du type de message ) SCR.EIA_TypMes : Référence Type de Message associé au message courant.
	Onglet « Traitement Entrant (1) » Trans. Glo Zone saisissable uniquement pour les types de message dont le mode de traitement est ‘0’ (Correspondance XML) ou ‘9’ (Décryptage Complexe). Ce flag indique si le traitement du message se déroule dans un seule transaction ou non. Requête Traitement Zone saisissable uniquement pour les types de messages dont le mode de traitement est ‘9’ (Décryptage Complexe). Zone obligatoire, en effet ces types de messages ne peuvent être traités que par le biais d’une requête REB. Critères Défaut Zone saisissable uniquement pour les types de messages dont le mode de traitement est ‘9’ (Décryptage Complexe). Bouton lançant l’application de définition des caractéristiques (saisie, affichage, initialisations…) des critères de la requête sus renseignée. Correspondances Zone saisissable uniquement pour les types de messages dont le mode de traitement est ‘0’ (Correspondance XML). Permet d’indiquer quelles seront les correspondances devant être effectivement traitées avec ce type de message. En effet il se pourrait que plusieurs correspondances soient définies sur un couple modèle/version XML et que le type de message n’en gère qu’une en particulier (Voir chapitre sur gestion des correspondances) Départ Transaction Zone saisissable uniquement pour les types de messages dont le mode de traitement est ‘0’ (Correspondance XML). Dans le cas où la zone Trans. Glo n’est pas cochée, le bouton permet de définir parmi les correspondances sus sélectionnées, lesquelles démarreront une transaction. Message Sortant Zone saisissable uniquement pour les types de messages dont le mode de traitement est ‘1’ (Messages Entrant-Sortant). Reçoit la référence du document de type message sortant (voir définition des documents, définition messages sortants). Ce document est exécuté lors du traitement du message entrant, le message servant de critère (contexte en entrée) du document. Un chapitre plus détaillé est dédié aux messages entrants-sortants. Protocole Zone saisissable uniquement pour les types de messages dont le mode de traitement est ‘99’ (Evènements) et dont l’action interne est EV-R-ML. Reçoit la référence de la requête de traitement de l’évènement reçu. Objet du Mail Drapeau indiquant si l’objet du mail doit être scruté ou non. Corps du Mail Drapeau indiquant si le corps du mail doit être scruté ou non. Pièces Jointes Drapeau indiquant si les pièces jointes doivent être scrutées ou non. Noms Pièces Jointes Permet d’indiquer le ou les noms des fichiers attachés au mail. Chacun des noms de fichiers devra être séparé par une virgule. Types Pièces Jointes Permet d’indiquer le ou les types des fichiers attachés au mail. Chacun des types de fichiers devra être séparé par une virgule. Par type on entend extension.
	Répert. Travail Peut contenir un répertoire donné. Si renseigné, le fichier sera copié dans ce répertoire avant d’être traité (instruction « cp » UNIX). Cde. Sys. Avt. Commande système exécutée avant traitement du message. Requête Avt. Cette requête est exécutée avant le début du traitement du message. Voir contexte ci-dessous. Cde. Sys. Apr. Commande système exécutée après traitement du message. Requête Apr. Cette requête est exécutée après le traitement du message. Voir contexte ci-dessous. Répert. Erreur Peut contenir un répertoire donné. Si renseigné et si le traitement du message est en erreur, le fichier sera transféré de son emplacement vers ce répertoire (instruction mv UNIX). Document Erreur Peut contenir la référence d’un document DIAPASON qui s’exécutera si le traitement du message termine en erreur. Conf. Lecture ? Flag indiquant s’il y a gestion ou non d’une confirmation de lecture. Doc. Conf. Lec. Si il y a gestion de confirmation de lecture, doit contenir la référence du document DIAPASON destiné à la génération de la confirmation. Archivage ? Flag indiquant s’il y a gestion ou non d’archivage. Répertoire Archivage Si il y a gestion de l’archivage, doit contenir un répertoire de destination pour le fichier venant d’être traité (traitement OK). Horizon Purge Indique le nombre de jours maximum de présence d’un message dans la boîte aux lettres des éléments traités dans le moniteur EIA. Si l’horizon est nul, la purge du message traité n’est pas réalisée. Histo. Sur Entité ? Si coché, permet de tracer toutes les actions effectuées sur la ou les entités gérées. Entités Bouton permettant de sélectionner les entités pour lesquelles on désire suivre un historique des actions menées (Histo. Sur Entité = Oui). Les entités présentées sont déduites des correspondances paramétrées sur l’onglet « Traitement Entrant (1) ». Les correspondances n’étant pas forcément définies sur entité, il est tout à fait possible qu’aucune entité ne soit sélectionnable et de ce fait la gestion de ces deux champs n’est pas effective. Le contexte des requêtes de début et fin traitement message entrant est le suivant : SCR.EIA_FicRec : nom du fichier courant.
	Onglet « MàJ Complémentaire » MàJ Complémentaire Le bouton permet d’accéder à un éditeur en saisie pour insérer un bloc Progress exécuté en fin de traitement de correspondance. Ce bloc est utilisé dans le cadre de la gestion des type de message de mode ‘99’ (Evènements).
	Onglet « Caractéristiques » Caractéristiques Zone de texte dédié à la description de caractéristiques générales tel que le format date, le format décimal ... pouvant être commun à tous les messages rattachés à ce type. Ce champ n’est actuellement pas géré. Bases Bouton permettant de sélectionner les bases nécessaires au traitement du message. Utilisé uniquement dans le cadre de types de messages dont le mode de traitement est ‘99’ (Evènement).

Quelles actions sont disponibles ?

Génération Message Cette action se présente, à l’image des actions de génération de requêtes, en trois sous-actions permettant la génération des « Messages sélectionnés », « Messages à Re-Générer » ou de « Tous les Messages ». Un type de message ne peut être exploitable qu’à la condition qu’il est était généré. Cette action est active pour les types de message dont le mode est ‘0’ (Correspondance / XML), ‘1’ (Message Entrant-Sortant), ‘99’ (Evènement) .
Environnement EIA à Régénérer : permet de regénérer, tous les types de messages, les correspondances et les documents à Re-Générer.
Gestion Evènement Pour les types de message de type « 99 », cette action permet d’accéder à l’application de définition de la structure de l’évènement.

Cette définition est réalisée par le biais d’une GFG telle que

Onglet « Définition »

Information Information contextuelle de l’action interne. Obligatoire, elle doit contenir, soit une variable spécifique de l’action interne, soit une variable standard ou spécifique de l’entité liée à l’action interne. Une sélection est disponible sur cette zone.
Type Type de l’information. Cette zone est initialisée avec le type de l’information renseignée précédemment. Les types possibles sont Caractère, Numérique, Date, Logique.
Stocké Indique si cette information est ou non stockée dans la boîte aux lettres des événements transmis. Une information doit être stockée pour être transmise par l’événement.
Liste Nom de la liste de détail dans laquelle on stocke l’information. Non gérée.
N.Ord Numéro d’ordre dans la liste ci-dessus. Non géré.
Zone La liste déroulante présente la liste des champs de la boîte aux lettres des événements transmis. La saisie est obligatoire si la zone «Stocké» est cochée.

Il est recommandé d’utiliser un champ correspondant au type de l’information ; les champs EvtCar* correspondant au type Caractère, les champs EvtDat* correspondant au type Date, les champs EvtLog* correspondant au type Logique et les champs EvtNum* et EvtRec* correspondant au type Numérique.

Format Format utilisé pour le stockage de l’information. Le format saisi doit correspondre au type de l’information. Une sélection est disponible sur cette zone.

Onglet « Valeurs Défaut »

Commentaire Commentaire associé à l’information. Cette zone n’est pas saisissable.
Valeur Alpha. Valeur Alphanumérique par défaut. Cette zone n’est saisissable que si l’information est de type Caractère.
Valeur Num. Valeur Numérique par défaut. Cette zone n’est saisissable que si l’information est de type Numérique.
Valeur Date Valeur Date par défaut. Cette zone n’est saisissable que si l’information est de type Date.
Valeur Logique Valeur Logique par défaut. Cette zone n’est saisissable que si l’information est de type Logique.

Seules les variables définies dans la structure d’un événement peuvent être utilisées dans le bloc de mise à jour complémentaire de celui-ci (sous la forme V_NomVariable).

Les actions disponibles sur cette application sont :

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