Formation Technique CARTHAGO Atelier 2

ATELIER DE FORMATION N°2
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/02
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 II : Mise en place d’un 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’une Structure Fichier Plat ______________________________________________4
Exercice 2 : Paramétrage des règles de Conversions de Dates _________________________________ 12
Exercice 3 : Paramétrage d’une Règle de conversion Statique _________________________________ 15
Exercice 4 : Paramétrage des règles de conversion de nombres ________________________________ 19
Exercice 5 : Paramétrage des règles de conversion par expression _____________________________ 21
Exercice 6 : Paramétrage de l’enrichissement des données ____________________________________ 24
Exercice 7 : Paramétrage de la Transformation d’entités _____________________________________ 27
Exercice 8 : Paramétrage d’une boite aux lettres Fichier Sortant _______________________________ 38
Exercice 9 : Paramétrage d’un Descripteur ________________________________________________ 42
Exercice 10 : Activer/Désactiver un Descripteur _____________________________________________ 46
Exercice 11 : Paramétrage d’un Evénement ________________________________________________ 47
Exercice 12 : Émettre un virement________________________________________________________ 50
Atelier de formation Carthago ESB 2/54

ATELIER II : MISE EN PLACE D’UN 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 en provenance de CARTHAGO DAVE dans le cas d’un virement émis.
Compta
Interface Généralisé
Télécompensation
REFERENTIEL
Télécompensation
REGLEMENTAIRE
s
mi
V ir é Interface Généralisé
DAVE
VISION GLOBALE
FONCTIONNALITES MAITRISEES A L’ISSUE DE L’ATELIER

- Comment créer un Fichier Plat et paramétrer ses attributs.
- Comment paramétrer des règles de conversions.
- Comment paramétrer des règles d’enrichissements Locales.
- Comprendre la nécessité de la Transformation d’entités et la paramétrer.
- Comment paramétrer une boite aux lettres fichier Sortant.
- Comprendre comment paramétrer un Descripteur.
- Comprendre comment Activer/Désactiver un descripteur pour consommer le fichier émis à la
télécompensation.
- Comment paramétrer un événement ESB

DEROULEMENT DE L’ATELIER
Exercice 1 : Création d’une Structure Fichier Plat
L’application envoie un fichier sous format plat de Virement émis en direction d’un module externe
(Télécompensation). Il s’agit d’un fichier qui sera déposé dans une boîte aux lettres dédiée. Ce fichier a
une structure bien précise.
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 Transformations Enrichissements et Contrôles, le dossier Règles de transformation,
Sélectionner le Use-case Fichier Plat.
Etape 3 : Dans le use case affiché, appuyer sur le bouton ‘Nouveau’.

Etape 4 : Dans le use case de création de fichier Plat affiché, saisir l’identifiant du fichier. L’identifiant
doit être saisi dans le champ ‘Identifiant’. Pour le besoin de cet exercice, l’identifiant sera
‘VIREMENT_EMIS_GLOBAL’. La Direction du fichier doit être choisie depuis la liste ‘Direction’. Pour le
besoin de cet exercice, la valeur de Direction sera ‘Sortie’, La valeur du ‘Type de Bloc’ sera ‘Position
Fixe’ et la valeur du champ ‘Syntaxe Retour à La Ligne’ sera ‘CRLF’.
Etape 5 : Dans le même use case affiché, Aller à l’onglet ‘Attributs’. appuyer sur le bouton ‘Ajouter’.
Etape 6 : Dans le use case de création d’attributs affiché, saisir le nom de l’attribut, la Position Début et
la Longueur. Le Nom de l’Attribut doit être saisi dans le champ ‘Nom’. Pour le besoin de cet exercice, le
Nom sera ‘sens’. La Position début doit être saisie dans le champ ‘Position début’ et sa valeur doit être

égale à ‘1’. La Longueur de l’attribut doit être saisie dans le champ ‘Longueur’ et sa valeur doit être
égale à ‘1’. Appuyer sur ‘OK’
Remarquer que la même procédure va être reproduite pour les autres attributs :
Nom Position début Longueur
clearingCodeCenter 2 2
countryCodeSender 4 2
generationDate 6 8
hourGeneration 14 6
valueCode 20 2
participantCode 22 5
presentationDate 27 8
presentationAppDate 35 8
remittanceNumber 43 4
savingCode 47 2
currencyCode 49 3
rang 52 2
totalTransferAmount 54 15
totalTransferNumber 69 10
freeText 79 202
Remarque Importante : Une fois que tous les attributs dans le Tableau ci-dessous ont été pré-
paramétrés, l’utilisateur aura une liste d’attributs semblable à cette liste

Etape 7 : retour à l’onglet ‘Général’.
- Appuyer sur le bouton ‘Enregistrer’
- Noter le message :
Etape 8 : Refaire le même enchainement pour créer une Deuxième structure de fichier Plat
(Etape1, …, Etape7) à la seule différence que cette structure de fichier Plat a comme ‘Identifiant’ la
valeur ‘VIREMENT_EMIS_DETAIL’. Le champ ‘Référence dans Block Object’ à la valeur ‘ 01’. Le champ
‘Bloc de Référence’ a la valeur ‘ 01’.

-Remarquer que la démarche est la même que pour la première structure de fichier plat créée, par
conséquent cette structure de fichier doit être intégré par une opération d’import.
Etape 9 : Dans la barre des menus Gestion des Messages (ESB), aller à la rubrique Traitement,
Sélectionner le Use-case Import.
-Dans le use case de création d’import de données affiché.
1
2
5
6
7
3

Cliquer sur le bouton ‘Attacher’, ensuite cliquer sur le bouton ‘Parcourir’. Sélectionner le fichier
‘VIREMENT_EMIS_DETAIL.xml’ et appuyer sur ouvrir.
L’utilisateur doit appuyer sur le bouton ‘Attacher’. Le fichier est maintenant attaché.
-L’utilisateur doit choisir la transformation I/O pour ce fichier. L’utilisateur doit cliquer sur le combo
‘Transformation I/O’. Il doit choisir depuis cette liste la ‘transformation statique’. Un use case de
transformation statique s’affiche. Pour le besoin de cet exercice, l’utilisateur doit sélectionner la
transformation ayant comme identifiant la valeur ‘MML’. Appuyer ensuite sur le bouton ‘Importer’.
-Après l’import de la structure du fichier plat avec succés, l’utilisateur peut consulter la structure du fichier
plat en allant dans la barre des menus Gestion des Messages (ESB), aller à la rubrique Configuration,
Sélectionner le Use-case Fichier Plat. Chercher la structure fichier plat ayant comme ‘identifiant’ la
valeur ’VIREMENT_EMIS_DETAIL’.
La liste des attributs existant pour cette structure du fichier plat ‘VIREMENT_EMIS_DETAIL’ est la
suivante :
Nom Position début Longueur
sens 1 1
clearingCodeCenter 2 2

countryCodeSender 4 2
generationDate 6 8
hourGeneration 14 6
valueCode 20 2
participantCode 22 5
presentationDate 27 8
presentationAppDate 35 8
remittanceNumber 43 4
savingCode 47 2
currencyCode 49 3
rang 52 2
transferAmount 54 15
transferNumber 69 7
sourceAccountCode 76 23
fullName 99 30
particiantDestCode 129 5
destinationCountryCode 134 2
beneficiaryRib 136 23
beneficiaryName 159 30
paymentDocReference 189 20
compSavingCode 209 2
objet 211 45
paymentDate 256 8
rejectReason 264 8
freeText 272 9

Remarque Importante :
La Structure du Fichier Plat de l’opération relative au VIREMENT_EMIS est divisée en
sous blocs. La Structure du fichier Plat ‘VIREMENT_EMIS_GLOBAL’ fait appel à une
autre structure de fichier plat ‘VIREMENT_EMIS_DETAIL’.
Il est impératif d’ajouter le sous Bloc ‘VIREMENT_EMIS_DETAIL’ à la structure du

fichier plat ‘VIREMENT_EMIS_GLOBAL’ après avoir paramétré les deux structures des
fichiers Plats au niveau de l’onglet ‘Sous Blocs’.
3 4
Sélectionner le Use-case Fichier Plat. Dans l’use-case affiché appuyer sur le bouton ‘Chercher’
Remarquer l’existence des deux structures de fichier Plat nouvellement créées.

Exercice 2 : Paramétrage des règles de Conversions de Dates
Une fois le fichier plat crée et structuré, l’utilisateur est tenu à paramétrer les règles de conversions et
d’enrichissements auxquels il fera appel lors de la transformation d’entités.
sous-rubrique Transformations Enrichissements et Contrôles, le dossier Règles de conversions,
Sélectionner le Use-case Conversion de dates.
Etape 3 : Dans le use case de création des Règles de conversions de Dates affiché, saisir l’identifiant du
convertisseur, son format source, son format cible. L’identifiant doit être saisi dans le champ ‘Identifiant’.
Pour le besoin de cet exercice, l’identifiant sera ‘COMP_DATE_CONV’. Le format cible doit être saisi
dans le champ ’Format Cible’. Pour le besoin de cet exercice la valeur du format cible sera
‘yyyyMMdd’.

- Appuyer sur le Bouton ‘ Enregistrer’
- Noter le Message
Etape 4 : Refaire le même enchainement que l’étape 3, saisir l’identifiant du converter, son format source,
son format cible. L’identifiant doit être saisi dans le champ ‘Identifiant’. Pour le besoin de cet exercice,
l’identifiant sera ‘DATE_FICHIER_COMP’. Le format cible doit être saisi dans le champ ’Format Cible’.
Pour le besoin de cet exercice la valeur du format cible sera ‘ddMMyyyy’.
- Appuyer sur le bouton ‘ Enregistrer’

- Noter le Message

Sélectionner le Use-case Conversion de dates. Appuyer sur le bouton ‘Chercher’.
Remarquer l’existence de la règle de conversions de dates nouvellement créée.

Exercice 3 : Paramétrage d’une Règle de conversion Statique
Sélectionner le Use-case Conversion statiques.
Etape 3 : Dans le use case de création d’une table de correspondance affiché, saisir l’identifiant du
convertisseur. L’identifiant doit être saisi dans le champ ‘Identifiant’. Pour le besoin de cet exercice,
l’identifiant sera ‘TYPEOPERATION_CODE VALEUR_VIR’.la valeur par défaut doit être saisie dans le
champ ‘Valeur par défaut’. Pour le besoin de cet exercice la valeur par défaut sera ‘ '10' ‘

Etape 4 : Aller à l’onglet ‘Valeurs’. Appuyer sur le bouton ‘Ajouter’
Etape 5 : dans le use case de Correspondance de Valeurs affiché, saisir la Valeur Entrante dans le
champ ‘Valeur Entrante’. Pour le besoin de cet exercice, la valeur entrante aura comme valeur
‘SentTransfer_PostDated_Represent’. Saisir la Valeur Sortante dans le champ ‘Valeur Sortante’. Pour le
besoin de cet exercice, la valeur sortante aura comme valeur ‘13’. Appuyer sur ‘OK’

-5.1 Refaire le même enchainement pour la suite des valeurs qui doivent être paramétrées. Le tableau
suivant présente les différentes valeurs à paramétrer au niveau de la règle de conversion statique
‘TYPEOPERATION_CODE VALEUR_VIR’.
Valeur Entrante Valeur Sortante
SentTransfer_Reject_Represent 13
SentTransfer_SentToClearing_Represent 13
SentTransfer_Start_Represent 13
Etape 6 : Retour à l’onglet principal ‘General’.
- Appuyer sur le Bouton ‘ Enregistrer’.

- Noter le Message
Etape 7 : Reprendre le même enchaînement pour paramétrer une règle de conversion statique. Pour le
besoin de cet exercice, les autres tables de correspondances (Règles Statiques) vont être importées.
- Dans la barre des menus Gestion des Messages (ESB), aller à la rubrique Traitement, Sélectionner le
Use-case Import. Importer le fichier ‘Converters Statiques.xml’

Après l’import du fichier ‘Converters Statiques.xml’, il y a ajout de ces différentes conversions
statiques
 CODE ENREG GLOBALE

 CODE ENREG DETAIL
Sélectionner le Use-case Conversion statiques. Appuyer sur le bouton ‘Chercher’.
Remarquer l’existence des règles de conversion statique nouvellement créées et importées.

Exercice 4 : Paramétrage des règles de conversion de nombres
L’utilisateur procède à la création de règles de conversions de nombres qui permet de convertir une
chaîne de caractère vers un nombre ou une chaîne de caractère et réciproquement en utilisant une
syntaxe spécifique.
sous-rubrique Transformations Enrichissements et Contrôles, le dossier Règles de conversion,
Sélectionner le Use-case Conversion de nombres.
Etape 3 : Dans le use case de création de la règle de conversion de nombre affiché, saisir l’identifiant du
convertisseur, le Pattern cible. L’identifiant doit être saisi dans le champ ‘Identifiant’. Pour le besoin de
cet exercice, l’identifiant sera ‘MONTANT_15’. Le Pattern cible du convertisseur qui doit être saisie dans
le champ ‘Pattern cible’. Pour le besoin de cet exercice, sa valeur sera ‘000000000000000’.

-
- Appuyer sur le Bouton ‘Enregistrer’
- Noter le Message
Sélectionner le Use-case Conversion de nombres. Appuyer sur le bouton ‘Chercher’.
Remarquer l’existence de la règle de conversion de nombres nouvellement créée.

Exercice 5 : Paramétrage des règles de conversion par expression
L’utilisateur procède à la création de règles de conversions par expression qui permet de convertir une
expression vers une variable et réciproquement en utilisant une syntaxe spécifique.
Sélectionner le Use-case Conversion d’expressions.
Etape 2 : Dans le use case affiché, appuyer sur le bouton ‘Nouveau’
Etape 3 : Dans le use case de création de la règle de conversion par expression, saisir l’identifiant du
convertisseur, l’expression et le nom de variable. L’identifiant doit être saisi dans le champ ‘Identifiant’.
Pour le besoin de cet exercice, l’identifiant sera ‘CODE_CENTRE_FROM_CODE _BANQUE’. L’expression
doit être saisie dans le champ ‘Expression‘. Pour le besoin de cet exercice la valeur de l’expression sera
‘x.startsWith('1')||x.startsWith('91')?'01':'02'’. Le nom de variable doit être saisi dans le champ ‘Nom
variable’ .Pour le besoin de l’exercice sa valeur sera ‘x’.

- Appuyer sur le bouton ‘Enregistrer’.
- Noter le Message
Etape 4 : Refaire le même enchainement que l’étape 3, saisir l’identifiant du convertisseur, l’expression et
le nom de variable. L’identifiant doit être saisi dans le champ ‘Identifiant’. Pour le besoin de cet
exercice, l’identifiant sera ‘NUMBER_TO_TIME’. L’expression doit être saisie dans le champ ‘Expression‘.
Pour le besoin de cet exercice la valeur de l’expression sera
‘(((Math:round(Math:floor(Long:valueOf(x)/3600))%24)>9?'':'0')+Math:round(Math:floor(Long:valu
eOf(x)/3600))%24)+(((Math:round(Math:floor(Long:valueOf(x)/60))%60)>9?'':'0')+Math:round(Mat
h:floor(Long:valueOf(x)/60))%60)+((Long:valueOf(x)%60>9?'':'0')+Long:valueOf(x)%60)’.
Le nom de variable doit être saisi dans le champ ‘Nom variable’ .Pour le besoin de l’exercice sa valeur
sera ‘x’.

- Noter le Message
Sélectionner le Use-case Conversion d’expressions. Appuyer sur le bouton ‘Chercher’.
Remarquer l’existence de la règle de conversion d’expression nouvellement créée.

Exercice 6 : Paramétrage de l’enrichissement des données
L’utilisateur procède à l’enrichissement de l’information à partir de la base locale de l’IG
sous-rubrique Transformations Enrichissements et Contrôles, le dossier Enrichissement des données,
Sélectionner le Use-case Enrichissement local.
Etape 3 : Dans le use case de création de la règle d’enrichissement affiché, saisir l’identifiant du
convertisseur, le nom entité, le champ source et le champ résultat. L’identifiant doit être saisi dans le
champ ‘Identifiant’. Pour le besoin de cet exercice, l’identifiant sera ‘DEVISE_IDENTIFIER_ISO’. Le nom
de l’entité doit être saisi depuis la liste ‘Nom Entité’. Pour le besoin de cet exercice la valeur du Nom
Entité sera ‘Catalogue des Devises’. Le champ source doit être saisi dans la liste’ Champ Source’. Pour
le besoin de l’exercice sa valeur sera ‘Identifiant’. Le champ Résultat doit être saisi depuis la liste
‘Champ Résultat’. Pour le besoin de cet exercice sa valeur sera ‘ISO 4217’

- Noter le Message
Etape 4 : Refaire le même enchainement que l’étape 3, saisir l’identifiant, le nom de l’entité, le champ
source et le champ résultat. L’identifiant doit être saisi dans le champ ‘Identifiant’. Pour le besoin de cet
exercice, l’identifiant sera ‘BANQUE_COMPENSATION_CODE_PAYS’. Le nom de l’entité doit être saisi
depuis la liste ‘Nom Entité’. Pour le besoin de cet exercice la valeur du Nom Entité sera ‘Banques’. Le
champ source doit être saisi dans la liste’ Champ Source’. Pour le besoin de l’exercice sa valeur sera
‘Code compensation’. Le champ Résultat doit être saisi depuis la liste ‘Champ Résultat’. Pour le besoin
de cet exercice sa valeur sera ‘Nationalité‘ et ‘Identifiant’ (on obtiendra ‘nationality.identifier’)

- Noter le Message
sous-rubrique Transformations Enrichissements et Contrôles, le dossier Enrichissement des données,
Sélectionner le Use-case Enrichissement local. Appuyer sur le bouton ‘Chercher’.
Remarquer l’existence de la règle d’enrichissement local nouvellement créée.

Exercice 7 : Paramétrage de la Transformation d’entités
Une fois le fichier plat crée et structuré, les règles de conversions et d’enrichissements paramétrées,
l’utilisateur procède à la correspondance des attributs champs à champs avec la possibilité d’utiliser des
expressions.
Sélectionner le Use-case Règles de transformations simples.

Etape 3 : Dans le use case de création de Transformations d’entités affiché, saisir l’identifiant du fichier,
sa Source, sa Cible et l’Action à faire. L’identifiant doit être saisi dans le champ ‘Identifiant’. Pour le
besoin de cet exercice, l’identifiant sera ‘VIREMENT_E_GLOBAL’. La Source du fichier doit être choisie
depuis la liste ‘Source’. Pour le besoin de cet exercice, la valeur de Direction sera
‘com.bfi.dav.ope.ins.fin.tr.ltr.sto.SentTransfer’’, La valeur de la ‘Cible’ sera
‘com.massinissa.esb.msgs.BlockObject ’ et la valeur du champ ‘Action à Faire’ sera ‘Création’.
Etape 4 : Dans le même use case affiché, Aller à l’onglet ‘Eléments’. appuyer sur le bouton ‘Ajouter’
Etape 5 : Dans le use case de création des clés de transformations affiché, saisir l’expression source ainsi
que la Clé cible. L’expression source doit être saisie dans le champ ‘Expression source’. Pour le besoin
de cet exercice, la valeur source sera ‘'1'’.La Clé Cible doit être saisie dans le champ ‘Clé Cible’ et sa
valeur doit être égale à ‘strings['sens'].value’.

-Refaire le même enchainement avec la clé de transformation qui a comme ‘expression source’ la valeur
‘beneficiaryRib’. Le clé cible doit être saisie depuis le champ ‘Clé Cible’. Pour le besoin de l’exercice la
valeur sera ‘strings['clearingCodeCenter'].value‘
Etape 6 : Aller à l’onglet ‘Conversions’, Appuyer sur ‘Ajouter’

Etape 7 : choisir depuis la liste déroulante ‘Règle de conversion’ ‘Règles de conversion par
expression’
Etape 8 : Choisir la conversion par expression qui a comme identifiant

‘CODE_CENTRE_FROM_CODE_BANQUE‘

8.1-Appuyer sur ‘OK’
8.2- Retourner à l’onglet ‘Général’ et appuyer sur ‘OK’
Important : l’utilisateur peut appliquer les converters pré-paramétrées (Exercice 2,

Exercice 3, Exercice 4, Exercice 5) sur les différentes clés de transformations. Pour le
besoin de l’exercice, les converters utilisés sont :
- BANQUE_COMPENSATION_CODE_PAYS (Enrichissement Local)

- COMP_DATE_CONV (Règle de conversion de dates)
- NUMBER_TO_TIME (Règles de conversion par expression)
- TYPEOPERATION_CODE VALEUR_VIR (Tables de Correspondances)
- CODE ENREG GLOBALE (Tables de Correspondances)
- DEVISE_IDENTIFIER_ISO (Enrichissement Local)
- MONTANT_15 (Règle de conversion de Nombres)
- DATE_FICHIER_COMP (Règle de conversion de dates)

Etape 9 : Retour à l’onglet ‘Eléments’, l’utilisateur continue l’ajout des clés de transformations et reproduit
l’enchainement décrit en suivant le tableau ci-dessous :
Expression Source Clé Cible Règles de Convertisseur Sous

conversions Transformation
DaveRibUtility:getPartFrom strings['countryCodeSen Enrichissement BANQUE_COMPE

Rib(0,accountContract.refer der'].value Local NSATION_CODE_
ence) PAYS
sentToClearDate strings['generationDate' Règles de COMP_DATE_CO

].value conversion de NV
Dates
paymentDocReference strings['hourGeneration' Règles de NUMBER_TO_TIME

].value conversion par
expression
operationType.filterOpeTy strings['valueCode'].val Tables de TYPEOPERATION_

pe+'_'+sentTransferLCStat ue Correspondan CODE VALEUR_VIR
us+'_'+operationType.filte ces
rOpeTypeAction
DaveRibUtility:getPartFrom strings['participantCode - -
Rib(0,accountContract.refer '].value
ence)
t.strings['generationDate']. strings['presentationDat - -
value e'].value
t.strings['generationDate']. strings['presentationApp - -
value Date'].value
('0000'+paymentDocRefer strings['remittanceNumb - -
ence).substring(('0000'+pa er'].value
ymentDocReference).lengt
h())
sentTransferLCStatus strings['savingCode'].val Tables de CODE ENREG

ue Correspondan GLOBALE
ces
currency.identifier strings['currencyCode'].v Enrichissement DEVISE_IDENTIFIER

alue Local _ISO
'00' strings['rang'].value - -

grossAmount strings['totalTransferAm Règle de MONTANT_15
ount'].value conversion de
Nombres
'0000000001' strings['totalTransferNu - -
mber'].value
objet strings['freeText'].value - -
this block['01'].instance - - VIREMENT_E_DETAIL
sentToClearDate strings['generationDate Règles de DATE_FICHIER_CO

FileName'].value conversion de MP
Dates
Remarque Importante : Une fois que toutes les clés de transformations dans le Tableau ci-
dessous ont été pré-paramétrées, l’utilisateur aura une liste de clés de transformations à cette
liste.
Il faut noter que la sous transformation ‘VIREMENT_E-DETAIL’ ne peut être ajouté qu’une
fois la deuxième transformation entité (Etape 11) est paramétrée.

Etape 10 : Aller à l’onglet ‘Général’.
- Appuyer sur le Bouton ‘Enregistrer’.
- Noter le message
Etape 11 : Reprendre le même enchaînement de la création d’une Transformation Entité. Cette

transformation entité va être importée. Le fichier MML à importer est ‘VIREMENT_E_DETAIL.xml’
L’identifiant pour cette nouvelle transformation d’entités est ‘VIREMENT_E_DETAIL’

- Le tableau suivant présente les différentes valeurs qui ont été paramétré au niveau de la nouvelle
Transformation d’entités importé.
Expression Source Clé Cible Règles de Converter Condition

conversions
'1' strings['sens'].value -
beneficiaryRib strings['clearingCode Règles de CODE_CENTRE_FR

Center'].value conversion par OM_CODE
expression _BANQUE
DaveRibUtility:getPartF strings['countryCodeS Enrichissement BANQUE_COMPE

romRib(0,accountContr ender'].value Local NSATION_CODE_
act.reference) PAYS
sentToClearDate strings['generationDat Règles de COMP_DATE_CO

e'].value conversion de NV
Dates
paymentDocReference strings['hourGeneratio Règles de NUMBER_TO_TIME

n'].value conversion par
expression
operationType.filterOp strings['valueCode'].v Tables de TYPEOPERATION_

eType+'_'+sentTransfe alue Correspondanc CODE VALEUR_VIR
rLCStatus+'_'+operatio es
nType.filterOpeTypeAct
ion
DaveRibUtility:getPartF strings['participantCo - -
romRib(0,accountContr de'].value
act.reference)

t.strings['generationDat strings['presentationD - -
e'].value ate'].value
t.strings['generationDat strings['presentationA - -
e'].value ppDate'].value
('0000'+paymentDocR strings['remittanceNu - -
eference).substring(('00 mber'].value
00'+paymentDocRefere
nce).length()
sentTransferLCStatus strings['savingCode'].v Tables de CODE ENREG -

alue Correspondanc DETAIL
es
currency.identifier strings['currencyCode' Enrichissement DEVISE_IDENTIFIER -

].value Local _ISO
'00' strings['rang'].value - - -
grossAmount strings['transferAmoun Règle de MONTANT_15 -

t'].value conversion de
Nombres
paymentDocReference. strings['transferNumb - - -
substring(0,7) er'].value
paymentDocReference strings['freeText'].valu - - -
e
accountContract.client.a strings['fullName'].val - - -
ctingEntity.fullName ue
beneficiaryRib strings['beneficiaryRib - - -
'].value
'CM' strings['destinationCo - - -
untryCode'].value
beneficiaryName strings['beneficiaryNa - - -
me'].value
paymentDocReference strings['paymentDocR - - -
eference'].value
'00' strings['compSavingC - - -
ode'].value
objet strings['objet'].value - - -
t.strings['generationDat strings['paymentDate' - - -
e'].value ].value

rejectCodeReasons==n strings['rejectReason']. - - -
ull?'00000000':('00000 value
000'+rejectCodeReaso
ns.replace('\\',
'')).substring(rejectReas
onsCode.replace('\\',
'').length())
accountContractCode strings['sourceAccount - - -
Code'].value
DaveRibUtility:getPartF strings['particiantDest - - -
romRib(0,accountContr Code'].value
act.reference)
sous-rubrique Transformations Enrichissements et Contrôles, le dossier Transformation d’entités,
Sélectionner le Use-case Règles de transformations simples. Appuyer sur le bouton ‘Chercher’
Remarquer l’existence des deux transformations d’entités nouvellement créées.
VIREMENT_E_GLOBAL a été paramétré.
VIREMENT_E_DETAIL a été importé.

Exercice 8 : Paramétrage d’une boite aux lettres Fichier Sortant
Une fois que l’utilisateur a fini de paramétrer la structure du Fichier Plat (Exercice 1), les différentes
règles de conversions et d’enrichissements (Exercice 2, Exercice 3, Exercice 4, Exercice 5, Exercice 6), la
transformation d’entité (Exercice 7), l’utilisateur est amené à paramétrer l’endpoint fichier local sortant
qui permettra de générer le fichier de virement émis.
sous-rubrique Contenaires de messages, Sélectionner le Use-case Sortant.
Etape 3 : Dans le use case de Endpoint fichier local sortant affiché, saisir l’identifiant de l’endpoint
sortant, Expression du nom du répertoire, la transformation I/O à faire et l’expression nom fichier.
L’identifiant doit être saisi dans le champ ‘Identifiant’. Pour le besoin de cet exercice, l’identifiant sera
‘VIREMENT EMIS’.
Le champ ‘Transformation I/O’ permet de choisir la structure du fichier plat adéquate pour l’endpoint
fichier local sortant (Exercice 1). L’utilisateur doit cliquer sur le combo , une liste
s’affiche et l’utilisateur appuie sur .
Pour le besoin de cet exercice, l’utilisateur doit choisir la structure du fichier plat ayant comme identifiant

‘VIREMENT_EMIS_GLOBAL’.
Dans le champ ‘Expression nom répertoire’, l’utilisateur doit saisir la valeur suivante pour le besoin de
l’exercice ‘ 'D:/OUT/VIREMENT' ‘.
Dans le champ ‘Expression nom fichier’, l’utilisateur doit saisir la valeur suivante pour le besoin de
l’exercice ‘strings['clearingCodeCenter'].value+'-CM-10019-
'+strings['generationDateFileName'].value+'-'+strings['hourGeneration'].value+'-
'+strings['valueCode'].value+'-2'+strings['savingCode'].value.substring(1)+'-950'+'.ENV'‘.
Etape 4 : Aller à l’onglet ‘ Transformateurs ‘, Cliquer sur le bouton ‘Ajouter’
Etape 5 : Dans le use case de création transformation Endpoint affiché, l’utilisateur va faire appel à la
transformation entité (Exercice 6).Choisir la transformation Endpoint. La transformation doit être saisie
depuis la liste ‘Transformation’. Pour le besoin de cet exercice, la transformation à appliquer sera
‘transformation Entité’.

- Choisir la Structure du Fichier Plat qui a pour ‘identifiant’ ‘VIREMENT_E_GLOBAL’.

Remarque Importante : Noter que la transformation Entité à laquelle on a fait appel
‘VIREMENT_E_GLOBAL’ fait appel à la deuxième transformation entité qui contient
les détails en tant qu’une sous transformation avec la clé de transformation qu’on a
paramétrée au niveau de la dernière ligne de ‘VIREMENT_E_GLOBAL’.
‘VIREMENT_E_GLOBAL’
Faire appel
Sous Transformation
‘VIREMENT_E_DETAIL’
Etape 7 : retour à l’onglet ‘General’.

- Appuyer sur le Bouton ‘Enregistrer’ .
- Noter le message
-
sous-rubrique Contenaires de messages, Sélectionner le Use-case Sortant. Appuyer sur ‘Chercher’.
Remarquer l’existence de l’endpoint fichier local entrant nouvellement créée.

Exercice 9 : 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.
sous-rubrique Traitement des messages, Sélectionner le Use-case Configuration des flux de messages.
Etape 2 :
Dans le use case de Configurations de Traitements(Descripteur) affiché, saisir la Date début du
descripteur, la Date fin, l’identifiant, l’utilisateur et l’Action à faire. La date début doit être saisie dans le
champ ‘Date début’. Pour le besoin de cet exercice la valeur de la date début sera ‘ 01/01/2008’.
La Date fin doit être saisie dans le champ ‘Date fin’. Pour le besoin de cet exercice la valeur de la date
fin sera ‘12/12/2050’
L’identifiant doit être saisi dans le champ ‘Identifiant’. Pour le besoin de cet exercice, l’identifiant sera
‘VIREMNT_EMIS_COMPENSATION’.
L’action à faire doit être saisi dans la liste ‘Action à faire’. Pour le besoin de cet exercice, l’action à
faire sera ‘Ignorer’.

Etape 3 : Aller à l’onglet ‘Routeurs entrants’, ensuite aller au sous-onglet ‘Routeurs’.
Appuyer sur le bouton Ajouter, une liste défilante s’affiche, choisir ‘Routeur Filtrant ‘.
Etape 4 : dans le use case de création de routeur entrant filtrant affiché, le champ ‘identifiant’ doit être
saisi et sa valeur sera pour le besoin de l’exercice ‘SIMPLE’. Appuyer ensuite sur le bouton ‘OK’

Etape 5 : aller au sous-onglet ‘Endpoint’.Cliquer sur le bouton ’Ajouter’.
Etape 6 : Cliquer sur combo .Une liste défilante s’affiche, l’utilisateur doit
choisir pour les besoins de cette exercice
- Sélectionner l’Endpoint pré-paramétré dans l’exercice 7 ‘VIREMENT EMIS COMPENSATION’.
2 4

Etape 7 : - Retour à l’onglet ‘General’, Cliquer sur le bouton ‘OK’.
-Aller à l’onglet ‘Routeurs sortant’
-Appuyer sur le bouton ‘Ajouter’ ensuite choisir ‘Routeur sortant filtrant’
Etape 8 : ajouter un routeur sortant filtrant avec la valeur ‘ SIMPLE VIREMENT’ dans le champ
‘Identifiant’.
1
3
- Aller à l’onglet ‘ Endpoints ’

- Appuyer sur le bouton .un nouveau écran de création de retour endpoint sortant
s’affiche.
- Cliquer sur ‘Endpoint Fichier Local Sortant’ et choisir depuis la liste

défilante qui s’affiche .
- Chercher et sélectionner l’endpoint fichier local sortant ayant comme identifiant ‘VIREMENT
EMIS’.
- Ajouter la condition suivante ‘operationType.internalExternal=='External' &&
(sentTransferLCStatus=='Start' || sentTransferLCStatus=='PostDated')’

Etape 9 :
- Noter le message
Exercice 10 : 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 de messages.
Etape 2 : le use case de configuration de Traitements pour les descripteurs s’affiche. L’utilisateur cherche
le Descripteur avec l’identifiant ‘VIREMNT_EMIS_COMPENSATION’ (1), ensuite il doit sélectionner la
ligne (2).Appuyer sur le bouton ‘Activer’ (3).
1 3

- Noter le message
Remarque Importante : Il faut toujours vérifier si le descripteur est activé (Statut =Démarré)
avant d’émettre un virement.
Pour désactiver le descripteur, il suffit de cliquer sur la ligner et appuyer sur
Exercice 11 : Paramétrage d’un Evénement

L’utilisateur est tenu de paramétrer l’événement ESB qui déclenche la création d’un fichier de VIREMENT
ÉMIS.
sous-rubrique Traitement des messages, le dossier Messages de l’application, Sélectionner le Use-case
Evénement.

Etape 3 : Dans le use case de création d’évènement Client affiché, le type message doit être saisi dans le
champ ‘Type message’. Pour le besoin de cet exercice la valeur de ce champ est ‘VIR_EMIS’
Etape 4 : Aller à l’onglet ‘événements’. Cliquer sur le bouton ‘Ajouter’. Un écran de création
d’événement ESB s’affiche. Le champ ‘Descripteur’ doit contenir le nom du Descripteur
paramétré ‘VIREMNT_EMIS_COMPENSATION’. Au niveau du champ ‘Endpoint virtuel’ choisir
la valeur de l’endpoint virtuel synchrone ‘VIREMNT_EMIS_COMPENSATION’.
Ajouter la condition ‘operationType.internalExternal=='External'’ dans le champ ‘Condition’

7
1
2
3 5
4
- Appuyer ensuite sur le bouton ‘OK’.

- Aller à l’onglet ‘Général’
- Appuyer sur le Bouton ’Enregister’.
- Noter le message

Exercice 12 : Émettre un virement
Etape 1 : Dans la barre des menus Gestion des opérations financières, aller à la rubrique Gestion des
virements, Sélectionner la sous-rubrique Virement émis, sélectionner le dossier Création du virement
émis, le Use-case Virement émis.
Etape 2 : Dans le use case de création de virement émis affiché, l’utilisateur va émettre un virement.
- Sélectionner depuis le combo ‘Code d’agence’ la valeur ‘BHS/01001. Sélectionner ensuite depuis
le combo ‘Type opération’, la valeur ‘ VIREMENT EMIS INTERBANCAIRES ’. Cliquer sur le
combo ‘RIB du payeur’. Sélectionner le client ayant un RIB du compte =
‘250390100100100006750010’.
Noter bien qu’une fois le client est sélectionné, le champ ‘Numéro de compte’, le champ ‘Nom
complet’ et le champ ‘Solde du compte’ se remplissent automatiquement
- Dans le champ ‘Rib du bénéficiaire’, saisir la valeur ‘250390100300100005610057’.
- Dans le champ ‘Nom du bénéficiaire’, saisir la valeur ‘MARIEME DIOP ‘.
- Saisir le montant brut du virement émis dans le champ ‘Montant brut’. Pour le besoin de cet
exercice, la valeur du montant brut est ‘45000’.
- Cliquer ensuite sur ‘Enregistrer’

Etape 3 : Aller à l’use-case
L’utilisateur doit sélectionner la ligne du virement émis nouvellement créé et appuyer sur le bouton
‘Lancer processus de validation’
3
1
2

-Noter le message
Etape 4 : Aller à l’use-case
L’utilisateur doit sélectionner la ligne du virement émis nouvellement créé et appuyer sur le bouton
‘Décider’
1 3
2
Un écran de validation s’affiche.
Noter que pour le besoin de cet exercice l’utilisateur bénéficie de tous les privilèges de validation.
L’utilisateur peut ajouter un commentaire de décision avant validation et il doit par la suite appuyer sur
le bouton ‘Valider’

-Noter le message
Remarque Importante : Dès que l’utilisateur appuie sur le bouton de validation.

L’événement est déclenché et le flux du virement émis est lancé.
Un fichier de virement émis pour la compensation a été généré
Et il a la structure suivante après toutes les modifications déjà paramétrer au cours de cet
atelier

Etape 5 : L’utilisateur peut consulter le virement émis en allant à l’use case ‘Consultation des virements.
-un écran de consultation de virement émis s’affiche. L’utilisateur appuie sur ‘View’
-L’utilisateur peut consulter ainsi les différentes informations relatives au virement nouvellement créée.

Formation Technique CARTHAGO Atelier 2

Transféré par

Informations du document

Copyright

Formats disponibles

Partager ce document

Partager ou intégrer le document

Options de partage

Avez-vous trouvé ce document utile ?

Ce contenu est-il inapproprié ?

Droits d'auteur :

Formats disponibles

Formation Technique CARTHAGO Atelier 2

Transféré par

Droits d'auteur :

Formats disponibles

ATELIER DE FORMATION N°2

Date de création 03/03/2014

ATELIER II : Mise en place d’un FLUX Sortant _________________________________________ 3

Atelier de formation Carthago ESB 2/54

FONCTIONNALITES MAITRISEES A L’ISSUE DE L’ATELIER

Atelier de formation Carthago ESB 3/54

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

Atelier de formation Carthago ESB 4/54

Atelier de formation Carthago ESB 5/54

Nom Position début Longueur

Atelier de formation Carthago ESB 6/54

Atelier de formation Carthago ESB 7/54

-Dans le use case de création d’import de données affiché.

Atelier de formation Carthago ESB 8/54

Nom Position début Longueur

Atelier de formation Carthago ESB 9/54

Atelier de formation Carthago ESB 10/54

Il est impératif d’ajouter le sous Bloc ‘VIREMENT_EMIS_DETAIL’ à la structure du

Remarquer l’existence des deux structures de fichier Plat nouvellement créées.

Atelier de formation Carthago ESB 11/54

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

Atelier de formation Carthago ESB 12/54

- Appuyer sur le bouton ‘ Enregistrer’

Atelier de formation Carthago ESB 13/54

Remarquer l’existence de la règle de conversions de dates nouvellement créée.

Atelier de formation Carthago ESB 14/54

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

Atelier de formation Carthago ESB 15/54

Atelier de formation Carthago ESB 16/54

Valeur Entrante Valeur Sortante

Etape 6 : Retour à l’onglet principal ‘General’.

- Appuyer sur le Bouton ‘ Enregistrer’.

Atelier de formation Carthago ESB 17/54

 CODE ENREG GLOBALE

Remarquer l’existence des règles de conversion statique nouvellement créées et importées.

Atelier de formation Carthago ESB 18/54

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

Atelier de formation Carthago ESB 19/54

Remarquer l’existence de la règle de conversion de nombres nouvellement créée.

Atelier de formation Carthago ESB 20/54

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

Atelier de formation Carthago ESB 21/54

Atelier de formation Carthago ESB 22/54

Remarquer l’existence de la règle de conversion d’expression nouvellement créée.

Atelier de formation Carthago ESB 23/54

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

Atelier de formation Carthago ESB 24/54

Atelier de formation Carthago ESB 25/54

Remarquer l’existence de la règle d’enrichissement local nouvellement créée.

Atelier de formation Carthago ESB 26/54

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

Atelier de formation Carthago ESB 27/54

Atelier de formation Carthago ESB 28/54

Etape 6 : Aller à l’onglet ‘Conversions’, Appuyer sur ‘Ajouter’

Atelier de formation Carthago ESB 29/54

Etape 8 : Choisir la conversion par expression qui a comme identifiant

Atelier de formation Carthago ESB 30/54

8.2- Retourner à l’onglet ‘Général’ et appuyer sur ‘OK’

Important : l’utilisateur peut appliquer les converters pré-paramétrées (Exercice 2,

- BANQUE_COMPENSATION_CODE_PAYS (Enrichissement Local)

Atelier de formation Carthago ESB 31/54

Expression Source Clé Cible Règles de Convertisseur Sous

DaveRibUtility:getPartFrom strings['countryCodeSen Enrichissement BANQUE_COMPE

sentToClearDate strings['generationDate' Règles de COMP_DATE_CO