Définition des règles d'identification

A quoi ça sert ?

Quand un message entrant arrive dans DIAPASON, il va falloir que DIAPASON identifie de quel message il s’agit pour venir l’associer au type de message qui convient !

• Pour un message XML, en général on va venir regarder quelle est la première balise du fichier pour pouvoir orienter vers le type de message qui va bien.

• Dans le cadre de fichiers ascii, la condition pourra dépendre du contenu dont la localisation dans le fichier pourra être donnée selon une syntaxe précise.

Les règles d’identification sont définies pour toutes les sociétés.

Il existe deux types de règles d’identification de messages, accessibles par ici :

Règles d’Identification / XML

L’application de définition des règles d’identification / XML est accessible depuis l’explorateur et se présente sous la forme d’une GFG DIAPASON :

Ordre : Numéro d’ordre de traitement de la règle d’identification. Cette notion est importante car elle permet de prioriser leur exécution s’il y a plusieurs règles similaires ! Balise Départ : Référence balise départ interne DIAPASON. Toute règle d’identification / XML est associée à une balise départ. C’est cette référence qui est le point de départ d’exécution des règles. Il est à noter que la balise départ interne correspond à un départ de modèle XML DIAPASON. Description Règle : Zone facultative permettant de décrire une règle par rapport à l’existence d’une balise ou par rapport à la valeur d’une balise donnée contenue dans le message. Cette zone est facultative dans la mesure où la balise de départ peut suffire à différencier deux messages XML dans nombre de cas. Syntaxe d'une règle Une balise est désignée par son nom compris entre les signes "<" et ">". <Bal_1> Cette syntaxe signifie que la balise Bal_1 doit être présente dans le message. Le fait d’écrire une telle règle signifie que cette condition est suffisante pour faire l’association avec le type de message voulu. <Bal_1>=Valeur Cette syntaxe signifie que la balise Bal_1 doit être présente dans le message et que son contenu est ‘Valeur’ (traduit en Progress par MATCHES ‘*Valeur*’). Le contenu ne doit pas être entouré de quotes ou de double quotes. Les *, nécessaire au MATCHES ne sont pas à préciser non plus. <Bal1> ;<Bal2>=FAB_LAP : le ‘ ;’ permet de cumuler les conditions. Pour que cette condition soit vraie, Bal1 ET Bal2 doivent être présentes dans le message ET Bal2 doit contenir FAB_LAP dans sa valeur. Société : Référence société du type de message à associer. Correspond en fait à la société de travail de l’action interne issue du type de message associé. Le schéma de gestion du multi société étant le suivant : Type Message Référence type de message (définie dans la société sus renseignée) à associer aux messages répondant à la règle d’identification décrite. Modèle XML Zone non saisissable déduite du couple Société/Type Message renseigné. Version XML Zone non saisissable déduite du couple Société/Type Message renseigné. Ambiguïté Zone non saisissable indiquant si la règle décrite présente une ambiguïté avec une autre règle déjà définie. Les ambiguïtés peuvent être : une règle est déjà rattachée à la balise de départ. une règle repose déjà sur ce couple modèle/version XML. La présence d’une ambiguïté n’est pas bloquante car le numéro d’ordre et la description de la règle peuvent permettre de lever l’ambiguïté. Cette information joue un rôle informatif avant tout.

Quelles actions sont disponibles ?

• Régénération Identification Cette action a pour but de déterminer de façon automatique les règles d’identification possibles à partir de la base de modèles/version XML en exploitation et de la base des types de messages définis au moment de son lancement. Elle se présente sous la forme d’un tableur en saisie se présentant comme suit :

Chaque ligne du tableur représente la définition d’une règle d’identification. A ? Zone non saisissable. Flag indiquant si il y a une ambiguïté avec une autre règle. N ? Zone non saisissable. Flag indiquant que la règle est nouvelle (non encore référencée dans la base). S ? Zone saisissable. Permet d’indiquer que l’on veut supprimer la règle. La suppression aura lieu lors de la validation du tableur. Balise Départ: Zone saisissable. Ce tableur permet de créer des règles d’identification, cette cellule reçoit la référence balise départ interne DIAPASON rattachée à la règle. Ordre: Zone Saisissable. Numéro d’ordre d’exécution de la règle d’identification lors de la phase d’identification effectuée par le traitement de réception des messages. Description Règle: Zone saisissable. Permet de définir les différentes conditions d’association au couple société/type message en fonction du contenu du message . Société: Zone non saisissable. Référence société associé au type de message. Type Message: Zone non saisissable. Référence type message rattaché à société. Modèle XML: Zone non saisissable. Référence modèle XML sur lequel repose le couple société/type message. Version XML: Zone non saisissable. Version XML du modèle rattaché au couple société/type message.

• Identification / DIALOG Cette action permet de renseigner une requête décrivant les règles d’association message au couple société/type message. Cette règle d’identification est la seule ne raisonnant pas par la notion de balise de départ et est marquée par le caractère ‘*’ dans la référence balise de départ.Cette règle, si définie, est exécutée en fin de phase d’identification si aucune règle n’a pu déterminer d’association message / couple société/type message. Le contexte de cette règle est :

  • WFEIALisMes

  • SCR.EIA_FicRec

Il ne faut pas faire de CREATION LISTE WFEIALisMes dans cette requête.

Règles d’Identification / Autres Formats

Ce type de règle d’identification est dédié à l’association des messages entrants au format ascii et des couples société/type de message.

Ordre Ordre d’exécution de la règle d’identification. Description Règle Zone facultative permettant de décrire une règle par rapport à une valeur dans le contenu du fichier. Une syntaxe particulière permet de décrire l’emplacement (ligne, colonne) et la longueur de la chaîne de caractères à tester OU, dans le cadre d’un contenu de fichier sous forme de liste chaînée, de préciser la ligne, le numéro de mot et le caractère séparateur pour localiser la chaîne de caractères à tester. Il est aussi possible de raisonner à partir du nom du fichier. Les syntaxes sont les suivantes : FIC=Valeur Cette syntaxe est vraie si le nom du fichier contient Valeur (traduit en Progress par MATCHES ‘*Valeur*’). Il ne faut cependant pas entourer Valeur par des ‘’ ni utiliser le caractère ‘*’. CHAINE[Ligne,Colonne,Longueur]=Valeur  Cette syntaxe permet de positionner la chaîne de caractères à tester dans un fichier dont les données sont concaténées. Cette chaîne doit contenir la valeur précisée pour que la règle soit vraie. Ex : « CHAINE[1,1,2]=OF » pour identifier la chaine « OF,145001,ALU » CHAINE[Ligne,Séparateur,Numéro mot]=Valeur Cette syntaxe permet de positionner la chaîne de caractères dans un fichier dont les données sont sous forme de liste chaînée. Cette chaîne doit contenir la valeur précisée pour que la règle soit vraie. Ex : « CHAINE[1,@,1]=OF » pour identifier la chaine « OF@145001@ALU » Société : Référence société du type de message à associer Type Message : Référence type de message (définie dans la société sus renseignée) à associer aux messages répondant à la règle d’identification décrite.

Définition règle d’identification pour réception via messagerie

La réception de message via serveur de messagerie (type M0) impose une définition de règles d’identification particulière.

Les messages électroniques entrants issus de la scrutation d’une boite de messagerie via un type de réception « M0 » sont retranscris par DIAPASON sous la forme d’un message xml dont la structure est la suivante :

La règle d’identification portera obligatoirement sur la balise de départ « IS_MAIL ».

Deux solutions possibles pour le traitement du contenu d’un message électronique :

Les données sont directement inscrites dans le corps du message lui-même

Ce type de message électronique peut être considéré comme un message xml simple car le corps décrit les données à traiter. DIAPASON génèrera un fichier xml sous la forme :

La règle d’identification peut tester la présence de la balise « D_ART01 » et aiguiller sur une type de message (« 0 » sur correspondances XML ou « 9 » décryptage complexe).

Les données sont inscrites dans une ou plusieurs pièces jointes du message

Ce type de message électronique sera considéré comme un message xml complexe car le fichier xml ressort uniquement les noms des fichiers effectivement à traiter (balise IS_CPJ dans le descripeur IS_PJ :

Note : dans tous les cas de figures il est conseillé de décrire une règle d’identification prioritaire (sur balise de départ IS_MAIL et testant la présence de la balise IS_PJ) destinée au traitement de messages électroniques avec pièces jointes. Cette règle devra faire l’association avec un type de message associé à la méthode de traitement « 9 » (décryptage complexe) .

Les règles d’identification sur des messages électroniques dont le corps contient les données à traiter peuvent faire l’objet de règles d’identification sur des types de messages associés aux méthodes de traitement « 0 » (par correspondance XML) ou « 9 » (décryptage complexe). Elles seront définies APRES la règle concernant les messages avec pièces jointes.