„La plate-forme EAI “ Initiation à WBI 22/11/2018 „La plate-forme EAI “ Initiation à WBI « Les normes» 6

Sommaire Objectif Deux domaines Normes de développement 22/11/2018 Sommaire Objectif Deux domaines Normes de développement Normes d ’infrastructure Ce document est un support de cours; il n ’est donc pas utilisable seul 22/11/2018

L ’objectif La normalisation contribue à assurer la cohérence générale des dizaines/centaines de composants d ’une plate-forme AI opérationnelle La normalisation permet d’identifier, de retrouver un composant de manière simple et rapide 22/11/2018

Deux domaines La mise en œuvre de plate-forme AI s’appuie sur des normes concernant : Le développement des objets nécessaires à un flux L’infrastructure technique de la plate-forme 22/11/2018

Normes de développement D ’abord, la normalisation IBM (impérative): Utiliser uniquement des caractères alphanumériques, des underscores, pas de ponctuation, pas de caractères spéciaux La première lettre d’un nom est une lettre Pas de blanc dans un nom Longueurs maximums des noms : Collaboration, Connector, Business Object : 80, Map : 76, Relationship : 8, ICS : 80 ... 22/11/2018

Normes de développement, la normalisation IBM ... Nom d’une instance de connecteur : Structure : xxxxxConnector La chaîne de caractères Connector doit : c ’est impératif être écrite en minuscules apparaître en dernier dans le nom du connecteur Pas d’apostrophe ou de guillemet dans les Propriétés Parfois, Connector doit être omis (création de l ’Agent, …) 22/11/2018

Normes de développement ... Aussi, une normalisation d ’usage (organisationnelle): Le référentiel abrite autant de : Bibliothèques: autant qu’il y a de projets Projects: autant qu’il y a de lots de livraison Granularité des Collaborations: Une Collaboration Template : peut être utilisée pour traiter un seul flux comme être réutilisée pour d’autres flux Une Collaboration Object : son nom est composé de celui du Template associé avec son utilisation 22/11/2018

Normes de développement, normalisation d ’usage ... Granularité des connecteurs MQSeries: 1 Queue = 1 connecteur MQSeries l’identification du flux est portée par l’entête du message trouvé dans la Queue, ce qui permet de le diriger sur la bonne Collaboration Nommage des composants: De manière générale, le nom d’un composant est constitué de : Un préfixe Un nom signifiant 22/11/2018

Normes de développement Renommage: Attention qu’un objet ne peut pas être renommé ; dans un tel cas, il faudrait donc le dupliquer sous un nouveau nom avant de le supprimer sous son ancien nom Attention aussi qu’une suppression n’est autorisée que si cet objet n’a plus de référence avec un autre composant (BO, connecteur, …) Préfixe plutôt que Suffixe: Comme il est souvent utile d’obtenir une vue d’ensemble de tous les objets d’une même application, leur nom est préfixé plutôt que suffixé Ainsi, les différents composants d’un projet sont naturellement rassemblés et visibles ensemble (dans le CSM) 22/11/2018

Normes de développement Versioning: Le choix est fait de ne pas insérer de versioning dans les noms des composants En effet, changer le nom de certains composants pour y gérer un versioning nécessiterait de modifier les paramétrages dans lesquels ce nom apparaîtrait dans d’autres composants 22/11/2018

Normes d ’infrastructure Plusieurs logiciels sont nécessaires au fonctionnement d’une plate-forme AI : DB2, MQSeries, Java, WBI Plusieurs domaines sont normalisés : Les applications Des users/passwords Les répertoires d’installation Des Queues MQSeries Les répertoires Jtext Les tables d’événement 22/11/2018

Normes d ’infrastructure ... Normalisation IBM: Nom de la base WBI : Longueur maximum = 8 car Normalisation d ’usage: Nom du Queue Manager : QM_ICSxxxxr Nom de la base de données XW : XWRFxxxx Nom de l’ICS : ICSxxxx xxxx: DEVx, INTx, RECx, PRDx 22/11/2018

Normes d ’infrastructure ... Users/passwords: DB2: db2inst1, db2fenc1, db2as1 MQSeries: mqm (user Unix et groupe) Java: ICSadmin ICS, accès au référentiel: admin 22/11/2018

Normes d ’infrastructure ... Queues: pour JMS: 8 queues techniques pour un connecteur MQseries: queue://QMgr/MQCONN.REPLYTO queue://QMgr/MQCONN.UNSUBSCRIBED queue://QMgr/MQCONN.IN_PROGRESS queue://QMgr/MQCONN.ARCHIVE queue://QMgr/MQCONN.ERROR 22/11/2018

Normes d ’infrastructure ... Les 3 répertoires Jtext + des extensions: Arrivée d’un événement : /tmp/JtextConn/Data_Handler_name/event, extension : .in Traitement positif complet : /tmp/JtextConn/Data_Handler_name/archive extension : .success Traitement positif partiel : /tmp/JtextConn/Data_Handler_name/archive extension : .partial Traitement non souscrit : /tmp/JtextConn/Data_Handler_name/archive extension : .unsub Le fichier original : /tmp/JtextConn/Data_Handler_name/archive extension : .orig Erreur : /tmp/JtextConn/Data_Handler_name/archive extension : .fail Sortie : /tmp/JtextConn/Data_Handler_name/out extension : .out 22/11/2018

Normes d ’infrastructure ... Les tables d ’événement: La table Event : events_table La table Archive : archive_table Ces tables peuvent être multiples 22/11/2018

Des exercices Des questions? 22/11/2018

Fin du module Vos remarques et commentaires peuvent être notés sur la page concernée ou sur cette page avant de les transmettre à votre interlocuteur Ils aideront à améliorer cette initiation 22/11/2018