Résumé : L’objectif de ce document est de fournir un ensemble d’ateliers de formation sur les concepts de Messaging abordés dans les applications CARTHAGO, et assurés par le framework MASSINISSA. Ces ateliers seront basés sur un ensemble d’exercices guidés.
Ref. MSESB/AT/04
Date de création 03/03/2014
Projet Version 1.0 Date de mise à jour 27/03/2014
Rue lac Ghar El Melh - Les berges du lac - 1053 Tunis – Tunisie Phone : (216) 71 962.030 - Fax : (216) 71 961.299 www.bfigroupe.com TABLE DES MATIERES
ATELIER IV : Mise en place d’un FLUX SYNCHRONE ____________________________________ 3
Objectif ________________________________________________________________________ 3 Fonctionnalités maîtrisées à l’issue de l’atelier ________________________________________ 3 Déroulement de l’atelier __________________________________________________________ 4 Exercice 1 : Création d’un endpoint virtuel synchrone. __________________________________________4 Exercice 2 : Paramétrage d’une boite aux lettres JPQL. ________________________________________6 Exercice 3 : Paramétrage d’un Descripteur. __________________________________________________9 Exercice 4 : Activer/Désactiver un Descripteur. _____________________________________________ 10 Exercice 5 : Test d’expression. __________________________________________________________ 12
Atelier de formation Carthago ESB 2/12
ATELIER IV : MISE EN PLACE D’UN FLUX SYNCHRONE OBJECTIF L’objectif de cet atelier est de passer en revue toutes les étapes nécessaires pour la mise en place d’un flux synchrone.
FONCTIONNALITES MAITRISEES A L’ISSUE DE L’ATELIER
- Comment créer un Endpoint Entrant Virtuel Synchrone. - Comment paramétrer une boite aux lettres JPQL Sortante. - Comprendre comment paramétrer un Descripteur. - Comprendre comment Activer/Désactiver un descripteur - Comment tester une expression
Atelier de formation Carthago ESB 3/12
DEROULEMENT DE L’ATELIER Exercice 1 : Création d’un endpoint virtuel synchrone Etape 1 : Se connecter avec un utilisateur ayant le privilège ADMINISTRATEUR : utilisateur = KONATE, mot de passe=1234. Etape 2 : Dans la barre des menus Gestion des Messages (ESB), aller à la rubrique Configuration, sous-rubrique Contenaires de messages, le dossier Boîte aux lettres virtuelle. Sélectionner le Use-case Synchrone.
Etape 3 : Dans le use case affiché, appuyer sur le bouton ’Nouveau’.
Dans le use case de création d’endpoint virtuel synchrone affiché, saisir l’identifiant de l’endpoint dans le champ ‘Identifiant’. Pour le besoin de cet exercice, l’identifiant sera ‘MONTANT_VIREMENT_RECU’. Noter que les champs ‘Politique de traçage’ et ‘Filtre’ sont remplis en automatique.
Atelier de formation Carthago ESB 4/12
-Appuyer sur le bouton ‘Enregistrer’. -Noter le message
Etape 4 : Dans la barre des menus Gestion des Messages (ESB), aller à la rubrique Configuration, sous-rubrique Contenaires de messages, le dossier Boîte aux lettres virtuelle. Sélectionner le Use-case Synchrone. Appuyer sur ‘Chercher’.
Remarquer l’existence de l’endpoint virtuel synchrone nouvellement crée.
Atelier de formation Carthago ESB 5/12
Exercice 2 : Paramétrage d’une boite aux lettres JPQL Une fois que l’utilisateur a fini de paramétrer l’endpoint entrant synchrone (Exercice 1), il doit paramétrer un endpoint JPQL sortant qui va lui permettre de récupérer le montant des virements reçus d’un compte. Etape1 : Dans la barre des menus Gestion des Messages (ESB), aller à la rubrique Configuration, sous- rubrique Contenaires de messages, le dossier Boîte aux lettres JPQL.Sélectionner le Use-case Sortant.
Etape 2 : Dans le use case affiché, appuyer sur le bouton ‘Nouveau’
Etape 3 : Dans le use case de création affiché, saisir l’identifiant de l’endpoint sortant, le filtre, l’expression Criteria, l’entité et le type de projection à faire. L’identifiant doit être saisi dans le champ ‘Identifiant’. Pour le besoin de cet exercice, l’identifiant sera ‘MONTANT_VIREMENT_RECU’.
Atelier de formation Carthago ESB 6/12
Le champ ‘Entité’ permet de choisir l’entité adéquate sur laquelle on va appliquer la requête. Pour le besoin de cet exercice, l’utilisateur doit choisir l’entité ‘Virement reçu’. Dans le champ ‘Expression criteria’, l’utilisateur doit saisir, pour le besoin de l’exercice, la valeur suivante ‘accountContractCode==compte’. Pour le champ ‘Projection Type’, l’utilisateur doit choisir pour le besoin de l’exercice la valeur ‘PROJECTION‘. Cocher le champ ‘Single result’.
Etape 3 : Aller à l’onglet ‘Paramètres’ et appuyer ensuite sur le bouton ‘Ajouter’.
Saisir dans les champs ‘Nom’ et ‘Valeur’ respectivement ‘compte’ et ‘this’ puis valider en appuyant sur ‘Ok’.
Atelier de formation Carthago ESB 7/12
Etape 4 : Aller à l’onglet ‘Projections’, ensuite appuyer sur le bouton Ajouter. A partir du champ ‘Type’ choisir la valeur ‘Sum’. Choisir la valeur ‘Montant net’ à partir de la liste ‘Champ’. Valider en appuyant sur ‘Ok’.
Etape 5 : retour à l’onglet ‘Général’.
- Appuyer sur le Bouton ‘Enregistrer’ - Noter le message
Etape 6 : Dans la barre des menus Gestion des Messages (ESB), aller à la rubrique Configuration, sous-rubrique Contenaires de messages, le dossier Boîte aux lettres JPQL. Sélectionner le Use-case Sortant. Appuyer sur ‘Chercher’.
Remarquer l’existence de l’endpoint JPQL sortant nouvellement crée.
Atelier de formation Carthago ESB 8/12
Exercice 3 : Paramétrage d’un Descripteur L’utilisateur est amené à paramétrer un Descripteur qui représente l’élément central pour la configuration d’un traitement de messages.
Etape 1 : Dans la barre des menus Gestion des Messages (ESB), aller à la rubrique Configuration, sous-rubrique Traitement des messages, Sélectionner le Use-case Configuration des flux synchrones.
Etape 2 : créer un descripteur en cliquant sur le use case ‘ nouveau’
- Cliquer ensuite sur ‘Endpoint Sortant’ et choisir depuis la
liste défilante qui s’affiche . Chercher et sélectionner l’endpoint sortant synchrone ayant comme identifiant ‘MONTANT_VIREMENT_RECU’.
- Cliquer sur ‘Endpoint Entrant’ et choisir depuis la liste
défilante qui s’affiche .Chercher et sélectionner l’endpoint entrant synchrone ayant comme identifiant ‘MONTANT_VIREMENT_RECU’. - L’identifiant doit être saisi dans le champ ‘Identifiant’. Pour le besoin de cet exercice, l’identifiant sera ‘MONTANT_VIREMENT_RECU’.
Atelier de formation Carthago ESB 9/12
Etape 3 : - Appuyer sur le bouton ‘Enregistrer’. - Noter le message
Exercice 4 : Activer/Désactiver un Descripteur
L’utilisateur est amené à activer le descripteur pour pouvoir mettre en marche le flux paramétré. Etape 1 : Dans la barre des menus Gestion des Messages (ESB), aller à la rubrique Traitement, Sélectionner le Use-case Activation et Désactivation des flux synchrones.
Atelier de formation Carthago ESB 10/12
Etape 2 : Le use case de configuration de Traitements pour les descripteurs synchrones s’affiche. L’utilisateur cherche le Descripteur avec l’identifiant ‘MONTANT_VIREMENT_RECU’, ensuite il doit sélectionner la ligne et appuyer sur le bouton ‘Activer’.
- Noter le message
Atelier de formation Carthago ESB 11/12
Exercice 5 : Test d’expression
Etape 1 : Dans la barre des menus Expression, sélectionner le Use-case Test expression.
Etape 2 : Dans le use case affiché, saisir dans le champ ‘Expression simple’ l’expression suivante ESBClient:sendSyncMsg('250390100100100007080004','MONTANT_VIREMENT_RECU')
