ATELIER DE FORMATION N°5

CARTHAGO ESB
FORMATION TECHNIQUE CARTHAGO

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/05

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 V : Mise en place d’un FLUX ENTRANT SYNCHRONE/Flux sortant _________________ 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’un endpoint sortant EJB ___________________________________________6
Exercice 3 : Paramétrage d’un Descripteur ________________________________________________ 10
Exercice 4 : Activer/Désactiver un Descripteur ______________________________________________ 12
Exercice 5 : Test d’expression ___________________________________________________________ 13

Atelier de formation Carthago ESB 2/15

ATELIER V : MISE EN PLACE D’UN FLUX ENTRANT
SYNCHRONE/FLUX SORTANT
OBJECTIF
L’objectif de cet atelier est de passer en revue toutes les étapes nécessaires pour la mise en place d’un
flux qui va permettre l’incrémentation de la date session du module DAVE.

FONCTIONNALITES MAITRISEES A L’ISSUE DE L’ATELIER

- Comment créer un Endpoint Entrant Virtuel Synchrone.
- Comment paramétrer un Endpoint Sortant EJB.
- Comprendre comment paramétrer un Descripteur.
- Comprendre comment Activer/Désactiver un descripteur
- Comment tester une expression

Atelier de formation Carthago ESB 3/15

DEROULEMENT DE L’ATELIER

Exercice 1 : Création d’un endpoint virtuel synchrone

Etape 1 : Se connecter avec l’utilisateur = KONATE, mot de passe = 1234.
Etape 2 : Au cours de cet atelier on va prévoir un descripteur synchrone dont l’exécution incrémentera la
date session de l’application.
On note La date session actuelle = ’03/03/2014’.
Consulter l’écran suivant :

Etape 3 : 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.

Atelier de formation Carthago ESB 4/15

Etape 4 : 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
‘INCREMENTER_DATE_COURANTE_DAVE_SYN’. Noter que les champs ‘Politique de traçage’ et ‘Filtre’
sont remplis en automatique.

-Appuyer sur le bouton ‘Enregistrer’.

-Noter le message

Atelier de formation Carthago ESB 5/15

Etape 5 : 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.

Exercice 2 : Paramétrage d’un endpoint sortant EJB

Une fois que l’utilisateur a fini de paramétrer l’endpoint entrant synchrone (Exercice 1), il doit
paramétrer un endpoint EJB sortant qui va lui permettre de récupérer le montant des impayées d’un
crédit.
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 EJB. Sélectionner le Use-case
Configuration EJB.

Atelier de formation Carthago ESB 6/15

Etape 2 : Dans le use case affiché, appuyer sur le bouton ‘Nouveau’

Etape 3 : Saisir dans le champ ‘Identifiant’ la valeur ‘DAVE_FACADE_REMOTE’.

Dans le champ ‘Nom JNDI’, l’utilisateur doit saisir, pour le besoin de l’exercice, la valeur
‘MassinissaFacade_CarthagoDave’
Dans le champ ‘Contexte’, l’utilisateur doit saisir, pour le besoin de l’exercice, la valeur suivante
‘org.jboss.naming.NamingContextFactory’.
Pour le champ ‘URL’, l’utilisateur doit saisir pour le besoin de l’exercice la valeur ‘jnp://localhost:1099’.

Etape 4 : Appuyer sur le bouton ‘Enregistrer’

- Noter le message

Atelier de formation Carthago ESB 7/15

Etape 5 : Dans la barre des menus Gestion des Messages (ESB), aller à la rubrique Configuration,
sous-rubrique Contenaires de messages, le dossier Boîte aux lettres EJB. Sélectionner le Use-case
Configuration EJB.
. Appuyer sur ‘Chercher’.

Remarquer l’existence de la configuration EJB nouvellement crée.

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 EJB. Sélectionner le Use-case
Façade sortante.

Atelier de formation Carthago ESB 8/15

Etape 7 : Dans le use case de création affiché, cliquer sur ‘Nouveau’ puis :
- Saisir l’identifiant de l’endpoint sortant. Pour le besoin de cet exercice, l’identifiant sera
‘INCREMENTER_DATE_COURANTE_DAVE_OUT’.
- Sélectionner depuis le combo ‘Configuration EJB’ la valeur ‘DAVE_FACADE_REMOTE’
- Saisir dans le champ ‘Contrôleur’ la valeur ‘com.bfi.ref.ent.ctl.EntityJobManager’ et dans le
champ ‘Méthode’ la valeur ‘incrementBusinessDay’.
- Saisir dans le champ ‘Expression utilisateur’ la valeur ‘MALIK’

Etape 8 : Appuyer sur le bouton ‘Enregistrer’.

- Noter le message

Etape 9 : Dans la barre des menus Gestion des Messages (ESB), aller à la rubrique Configuration,
sous-rubrique Contenaires de messages, le dossier Boîte aux lettres EJB. Sélectionner le Use-case
Façade sortante.
. Appuyer sur ‘Chercher’

Atelier de formation Carthago ESB 9/15

Remarquer l’existence de l’endpoint EJB nouvellement crée.

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.

Atelier de formation Carthago ESB 10/15

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 ‘INCREMENTER_DATE_COURANTE_DAVE_OUT.

- 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 ‘INCREMENTER_DATE_COURANTE_DAVE_SYN’.
- L’identifiant doit être saisi dans le champ ‘Identifiant’. Pour le besoin de cet exercice, l’identifiant
sera ‘INCREMENTER_DATE_COURANTE_DAVE_DESC’.

Etape 3 :
- Appuyer sur le bouton ‘Enregistrer’.
- Noter le message

Atelier de formation Carthago ESB 11/15

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.

Etape 2 : Le use case de configuration de Traitements pour les descripteurs synchrones s’affiche.
L’utilisateur cherche le Descripteur avec l’identifiant ‘INCREMENTER_DATE_COURANTE_DAVE_DESC’,
ensuite il doit sélectionner la ligne et appuyer sur le bouton ‘Activer’.

- Noter le message

Atelier de formation Carthago ESB 12/15

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(null,'INCREMENTER_DATE_COURANTE_DAVE_DESC')’

- Cliquer sur ‘Evaluer’

- Cette expression renvoie le message d’erreur suivant :

Atelier de formation Carthago ESB 13/15

 Etape 3 : Editer l’endpoint sortant synchrone ‘INCREMENTER_DATE_COURANTE_DAVE_OUT’,
changer l’expression utilisateur de ‘MALIK’ à ‘KONATE’.

Etape 4 : Désactiver le descripteur synchrone ‘INCREMENTER_DATE_COURANTE_DAVE_DESC’.

- Noter le message

Atelier de formation Carthago ESB 14/15

Etape 5 : Refaire les étapes 1 et 2 et ré-exécuter l’expression
‘ESBClient:sendSyncMsg(null,'INCREMENTER_DATE_COURANTE_DAVE_DESC')’
- Noter le message

Etape 6 : Ré-consulter le même écran de l’exercice 1 : Remarquer que la date session a été bien passée
de ‘03/03/2014’ à ‘04/03/2014’.

Atelier de formation Carthago ESB 15/15