GUIDE UTILISATEUR

ENTITES GENERIQUES ET
GROOVY
MANUEL D’UTILISATION CARTHAGO
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
Résumé : L’objectif de ce document est de fournir un guide sur le paramétrage des
entités génériques et les scripts Groovy.

Ref. MSVF/GU/01

Date de création 18/01/2016

Projet
Version 1.0
Date de mise à jour 18/01/2016

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

LES ENTITES GENERIQUES DE CARTHAGO.......................................................................... 3

DEFINITION DE L’ENTITE ...................................................................................................... 3
DEFINITION DES ECRANS DES ENTITES GENERIQUES DANS LE MENU ............................... 7
CONFIGURATION DE L’ECRAN DE L’ENTITE GENERIQUE ................................................. 11
CONFIGURATION DU BPM DE L’ENTITE GENERIQUE........................................................ 15
CONFIGURATION DES SCRIPTS GROOVY ........................................................................ 17

Guide Utilisateur Entités Génériques 2/21

LES ENTITES GENERIQUES DE CARTHAGO

La plateforme Massinissa a été mise en place pour faciliter et accélérer le processus de

développement, en évitant une grande partie du travail exhaustive d’élaboration de code, de
conception et de configuration. En effet, la plateforme Massinissa via sa couche de configuration des
entités génériques, permet de paramétrer les attributs et les écrans de l’ensemble des opérations
métiers de la banque.
Le paramétrage des entités génériques consiste à la :

 Définition de l’entité
 Définition des écrans des entités génériques dans le menu
 Configuration de l’écran de l’entité générique
 Configuration du BPM de l’entité générique

Nous allons exposer dans ce rapport, le paramétrage nécessaire pour définir une nouvelle opération
métier.

DEFINITION DE L’ENTITE
L’écran de définition des entités génériques n’est accessible que pour l’administrateur du système via
le menu suivant :

En cliquant sur le lien configurer des entités génériques l’interface de paramétrage est affichée.
Dans notre exemple, nous allons paramétrer l’opération virement émis.
Guide Utilisateur Entités Génériques et Scripts Groovy 3/12
En cliquant sur le bouton « Nouveau », l’interface de création d’une nouvelle opération métier s’affiche
avec deux onglets :

 Général
 Champs écran

GENERAL
Cet onglet contient:
Nom écran : pour définir le nom de l’écran.
Description : pour renseigner une description de l’écran.

CHAMPS ECRAN
C’est l’onglet où on définit les champs de l’écran :
Dans notre exemple si dessous, nous avons trois types de champs qui sont « String », « Date » et
« List ».

Guide Utilisateur Entités Génériques et Scripts Groovy 4/12

Nous pouvons à tout moment ajouter, modifier ou supprimer des champs de l’écran.
Pour ajouter un champ, on clique sur le bouton « Ajouter ».
Nous renseignons les spécifications du champ, à savoir :

 Type champ
 String : champ de type chaine de caractère avec 255 caractères
 Date : champ de type date
 Boolean : champ de type boolean (vrai ou faux)
 Text : champ de type chaine de caractère avec 4000 caractères
 Enum : champ de type liste de valeur fixe
 Long : champ de type numérique
 BigDecimal : champ de type montant
 Select : champ de type entité
 List : champ de type liste d’une autre entité générique
 Nom champ
 Label

Guide Utilisateur Entités Génériques et Scripts Groovy 5/12

Par exemple, nous allons ajouter l’adresse email du client dans l’écran :
Le champ à ajouter a les spécificités suivantes :

 Type champ : String

 Nom champ : stringValue6
 Label : Email

Par la suite, on clique sur le bouton « Ok » pour valider l’ajout.

Guide Utilisateur Entités Génériques et Scripts Groovy 6/12

DEFINITION DES ECRANS DES ENTITES GENERIQUES
DANS LE MENU
C’est le service qui permet d’afficher la nouvelle opération métier dans le menu.
Pour ce faire, nous devons accéder à l’écran « Application » suivant :

En faisant une recherche, le menu de l’application s’affiche :

Guide Utilisateur Entités Génériques et Scripts Groovy 7/12

Il suffit de l’éditer pour ajouter un nouvel écran :

Pour l’ajout d’un nouvel écran, nous devons accéder à l’onglet « Packages » :

Et d’éditer par la suite, la ligne « Carthago_Instruction » et accéder à l’onglet « Sub Packages » :

Guide Utilisateur Entités Génériques et Scripts Groovy 8/12

Pour ajouter un packages, il suffit de cliquer sur ajouter et renseigné le Nom et le Label :

Pour ajouter un lien à un package, il suffit d’accéder à l’onglet service :

Guide Utilisateur Entités Génériques et Scripts Groovy 9/12

Et d’ajouter le service avec les spécificités suivantes :
Id : c’est le service de l’entité :
 CreateGenericEntity pour les écrans de création
 SplittedSearchGenericEntity pour les écran de recherche
Name : c‘est le nom de l’écran sans espaces : Virement
Label : c’est le label de l’écran : Virement

Et rajouter par la suite les attributs comme suit dans l’onglet « Attributs » :

entityClass : c’est le path de l’entité : com.bfi.ent.ObjectEntity

configType : c’est le nom de l’écran déjà défini dans la définition de l’entité : Virement
Une fois le service ajouté, il faut procéder à la sauvegarde du menu :

Guide Utilisateur Entités Génériques et Scripts Groovy 10/12

Une fois la sauvegarde du menu effectuée, il faut vider le cache du menu via le bouton « Clear
Cache Menu ».

CONFIGURATION DE L’ECRAN DE L’ENTITE GENERIQUE

Une fois le menu de l’opération métier paramétré, nous pouvons accéder à ce menu comme suit :

En cliquant sur le bouton « Virement », l’interface de création des virements émis s’affiche les champs
paramétrés et les deux onglets :
Guide Utilisateur Entités Génériques et Scripts Groovy 11/12
  Général
 Détail

AJOUT DES ACTIONS

Cet onglet contient les informations générales des virements émis paramétrés, nous devons
supprimer tous les actions créées par défaut et paramétrer les deux actions suivantes au niveau de
l’onglet « Actions » :

Lancement du processus instruction :

Guide Utilisateur Entités Génériques et Scripts Groovy 12/12

Name : pour définir le nom du bouton sans espace : lancer_instruction
Label : pour renseigner le label du bouton : Lancer instruction
Event : expression de type événement : doNothing
On Action Exp : c’est l’expression qui permet de lancer le BPM :
BPMProcessManager:launchBPMProcess(this.persist())

Impression du tracking ID :
Guide Utilisateur Entités Génériques et Scripts Groovy 13/12
Name : pour définir le nom du bouton sans espace : printTrucking
Label : pour renseigner le label du bouton : Imprimer Tracking ID

Une fois les boutons ajoutés, il faut enregistrer la configuration écran et faire un « Clear All Flows
Cache ».
Après le rafraîchissement de la page, seulement le bouton « Lancer instruction » et « Imprimer
tracking ID » s’affiche à l’écran comme suit :

Guide Utilisateur Entités Génériques et Scripts Groovy 14/12

CONFIGURATION DU BPM DE L’ENTITE GENERIQUE
La configuration du BPM de l’entité générique suit la même logique de configuration des processus
énoncée dans le Guide utilisateur BPM.

CONFIGURATION USE CASE

Seulement la configuration use case est spécifique comme suit :
Nom : pour définir le nom de l’écran dans le BPM : Virement
Identité service : pour définir le service métier : CreateGenericEntityWorkflow
Id Attribut : pour définir l’unicité de l’écran : VirementWF

Dans l’onglet « Attributs », il suffit d’ajouter la ligne suivante :

Nom : entityClass
Valeur : ‘com.bfi.ent.ObjectEntity’

Guide Utilisateur Entités Génériques et Scripts Groovy 15/12

Nous allons faire appel à cet écran lors du paramétrage du processus BPM de l’opération métier au
niveau des tâche de type use case.

AFFECTATION WORKFLOW
Après le paramétrage du processus BPM, il faut créer l’affectation du workflow de l’opération
métier comme suit :

Au niveau de la création de la nouvelle affectation workflow, nous devons renseigner dans la

condition le nom de l’opération métier comme nous l’avons paramétré dans l’ :
Condtion : objectEntityConfigCode=='Virement'

Guide Utilisateur Entités Génériques et Scripts Groovy 16/12

CONFIGURATION DES SCRIPTS GROOVY
L’écran de définition des scripts Groovy pour utilisation dans les traitements spécifiques n’est accessible
que pour l’administrateur du système via le menu suivant :

En cliquant sur le lien Script Groovy l’interface de paramétrage est affichée.

En cliquant sur le bouton « Nouveau », l’interface de création d’une nouvelle opération métier s’affiche
avec deux onglets :

 Général
 Parameters

Guide Utilisateur Entités Génériques et Scripts Groovy 17/12

GENERAL
Cet onglet contient:
Identifier : pour définir l’identifiant du script.
Script : pour renseigner le script à traiter.

PARAMETERS
C’est l’onglet où on définit les paramètres à renseigner pour le script renseigné.

Nous pouvons à tout moment ajouter, modifier ou supprimer des paramètres.

Pour ajouter un paramètre, on clique sur le bouton « Ajouter ».
Nous renseignons le nom du paramètre.

Guide Utilisateur Entités Génériques et Scripts Groovy 18/12

Par la suite, on clique sur le bouton « Ok » pour valider l’ajout du paramètre.

Guide Utilisateur Entités Génériques et Scripts Groovy 19/12