GRAF–Outillage pour les nuls / l’identité des objets

 

Reprenons le référentiel généré de notre petite application de test :

Les trois premières colonnes du référentiel contiennent des informations sur l’identité des objets :

• id GRAF : l’identité de l’objet telle qu’elle est gérée dans visio
• idP roposé : une identité proposée par le générateur conformément aux règles de nommage GRAF
• id Retenu : l’identité de l’objet telle qu’elle sera finalement retenue.

 

A quoi sert l’identité d’un objet ?

L’identité sert principalement à deux choses :

• Permettre de représenter un composant ou un flux plusieurs fois dans un diagramme ou dans plusieurs diagrammes sans que le générateur crée plusieurs objets dans le référentiel
• pouvoir référencer l’objet dans les différents outils de CalliGRAF, notamment GRAF_Workshop

 

Quelles sont les règles de nommage d’un objet ?

• Un système est identifié par une lettre (majuscule ou minuscule) ou un chiffre
• Un sous-système est identifié par la lettre ou le chiffre du système auquel il appartient, + “_” + une lettre (majuscule ou minuscule) ou un chiffre.
• Un module est identifié par les deux lettres du sous-système auquel il appartient, + “_” + 9 lettres (majuscule ou minuscule) ou chiffres.
• Un composant est identifié par les 12 lettres du module auquel il appartient, + “_” + 9 lettres (majuscule ou minuscule) ou chiffres.
• Un flux est identifié par 4 lettres (les deux lettres du sous-système source, les deux lettres du sous-système destination) + “_” + 9 lettres (majuscule ou minuscule) ou chiffres + éventuellement “_” + 3 lettres pour finir de caractériser le flux

 

Comment le générateur procède-t-il pour générer les identités ?

Le générateur s’appuie sur le paramétrage de la codification des systèmes et des sous-systèmes décrit dans le fichier CalliGRAF.par

Dans notre exemple, on a :

§codification système -- lettres de codification des systèmes
COMMANDES=C
 

§codification sous-système -- lettres de codification des sous-systèmes

--
Gestion des commandes= C
Portail = P

Il génère ensuite un identifiant en utilisant un algorithme qui s’appuie sur le nom de l’objet.

Le module :

du sous-système “Gestion des commandes” du système “Commandes” aura pour  identifiant généré :

CC_Commandes

Le flux représenté par la flèche bleue dans le schéma :

possède un nom en clair dans la propriété GRAF_dénomination : “saisir et mettre à jour les commandes”.

Le générateur construit alors l’identifiant :

CPCC_SaiMetJou

 

Comment s’assurer de l’unicité de l’identité ?

Dans le référentiel généré, la colonne “id U” contient un point d’interrogation en rouge lorsque plusieurs objets ont la même identité. Il est dans ce cas souhaitable de corriger manuellement l’identité (conformément aux règles de nommage de préférence).

GRAF–Outillage pour les nuls / générer le référentiel sous Excel

Créer  l’arborescence

Pour générer le référentiel, nous devons d’abord créer une arborescence de travail, qui contient les outils à la racine.

Une telle arborescence est fournie sur l’exemple de l’agence de voyage et est téléchargeable sur le site KM 2.0 de Capgemini. (Fichier Arborescence Cali_Voyage V3.2.zip)

Dans le répertoire “vsd” nous plaçons le fichier contenant notre schéma :

Commandes V1.0.vsd

Ce fichier contient l’onglet “Commandes” qui contient le schéma.

Paramétrer l’arborescence

Il faut ensuite paramétrer la liste des onglets analysés par l’outil. Pour cela on édite le fichier “schémas.csv” du répertoire “param”.

• des : numéro de dessin
• fichier : nom du fichier Visio
• onglet : nom de l’onglet
• nom : nom détaillé du schéma
• court : nom abrégé du schéma (permet de faire des filtres dans le référentiel généré)

Générer l’extraction brute

On lance ensuite le fichier visio GRAFEXTRACTOR qui est à la racine de l’arborescence

GRAFEXTRACTOR produit dans le répertoire “xgl” des fichiers d’analyse des schémas

• un fichier xx.xgl par schéma analysé
• un fichier elem.csv qui contient la description des systèmes, sous-systèmes, modules et composants
• un fichier flux.csv qui contient la description des flux

Mettre en forme le référentiel sous Excel

Pour mettre en forme les résultats, on lance alors le fichier Excel  GRAFlux qui est également à la racine de l’arborescence, puis on exécute la macro GRAFllux

GRAFlux génère alors un fichier Excel dans le répertoire “flux” qui contient les composants (onglet “elem”) et les flux (onglet “flux”)

Ci dessous un extrait de l’onglet “elem” contenant l’arborescence des composants

GRAF–Outillage pour les nuls / préparer la génération documentaire avec les propriétés

 

La génération du Dossier d’architecture logique construit un document qui contient :

• La hiérarchie des systèmes, sous-systèmes, modules et composants
• pour chaque composant, ses interfaces (flux entrants et sortants du composant)

Cette description peut être enrichi avec le contenu des propriétés des différents objets dans le schéma.

Prenons notre exemple de la gestion des commandes :

Objet 1 : les propriétés “commentaire” et “documentation” enrichissent la description du module

Objet 2 : la propriété “désignation” indique la nature du flux. Il s’agit ici d’une écriture en base de données. Une désignation doit être précédé d’un article (la, le) et d’une apostrophe si nécessaire pour générer une élision.

la propriété “objets” liste les objets métier véhiculés par le flux

la propriété “protocole” décrit le protocole de communication utilisé par le flux

 

 

 

 

 

 

 

Objet 3 : la propriété “retour” contient la valeur de retour de l’invocation synchrone