Modélisation UML & SysML

Expertise et articles Blog sur UML, SysML, et Enterprise Architect de Sparx Systems

jeudi, 14 mars 2013 00:00

Trucs et astuces Sparx Systems Enterprise Architect, FAQ

Écrit par
Évaluer cet article
(6 Votes)

Cette page présente une sélection de trucs et astuces pour améliorer l'utilisation quotidienne ou ponctuelle d'Enterprise Architect. Plusieurs articles sont également accessibles via le tag Astuce EA.

N'hésitez pas à me contacter par email (Cette adresse e-mail est protégée contre les robots spammeurs. Vous devez activer le JavaScript pour la visualiser.) si vous cherchez d'autres astuces, ou si vous en avez à partager afin que je les rajoute sur cette page. Il me reste encore plusieurs astuces que je rajouterai au fur et à mesure.

Liste des astuces :

  1. raccourcis clavier
  2. afficher un diagramme par défaut à l'ouverture d'un projet EA
  3. afficher les commentaires du diagramme ou d'un élément dans une note
  4. associer une exigence à un cas d'utilisation par un "glisser/déposer"
  5. regrouper des attributs ou opérations d'une classe avec les stéréotypes
  6. replacer un libellé à son emplacement initial
  7. limiter le périmètre d'une recherche à une partie modèle
  8. utiliser ctrl-c et ctrl-v pour copier/coller des paquetages depuis l'explorateur "project browser"
  9. créer plusieurs connecteurs entre éléments avec la "Relationship Matrix"
  10. inverser le sens d'une connecteur
  11. identifier les erreurs SQL entre EA et la BD via le fichier DBError.txt
  12. modifier l'apparence et le style de ligne de plusieurs connecteurs dans un diagramme EA
  13. créer une Tagged Value sur une sélection d'éléments
  14. afficher plusieurs fois le même élément en utilisant les cadres de diagrammes
  15. déplacer horizontalement ou verticalement un élément du diagramme
  16. masquer les stéréotypes dans le project browser
  17. masquer le nom de la superclasse en haut à gauche de la classe (en italiques)
  18. copier un diagramme dans le presse-papier (Clipboard) sans le cadre

Astuce 1 : raccourcis clavier

Voici des raccourcis claviers pouvant être efficaces et très utiles:

  1. ALT-G : sur sélection d'un élément depuis un diagramme, alt-g permet d'afficher cet élément, par exemple une classe ou un use case, dans le navigateur du projet (vue Project Browser).
  2. Ctrl-U : sur sélection d'un élément depuis le navigateur du projet (vue Project Browser), control-U permet d'afficher la liste des diagrammes où apparait cet élément. Si la classe, use case, activité ou autre élément sélectionné dans le "project browser" n'est utilisé que dans un diagramme, alors EA ouvre ce diagramme.
  3. SHIFT-ALT-G : ce raccourci permet d'afficher où le diagramme ouvert se trouve dans le "project browser".
  4. Ctrl-TAB : similaire au Alt-TAB de Windows, ce raccourci permet d'afficher un aperçu de l’ensemble des diagrammes ouverts (utile lorsque l’on a beaucoup de diagrammes ouverts)
  5. F2 sur un élément ou connecteur sélectionné depuis le diagramme pour éditer le nom d'un élément (classe, use case, interface) ou d'une transition, ce qui évite d'ouvrir les propriétés.
  6. F4 sur un élément ou connecteur sélectionné depuis le diagramme pour modifier la couleur et épaisseur de ligne sur un connecteur, ou accéder aux paramètres d'affichage sur un élément.

Astuce 2 : afficher un diagramme par défaut à l'ouverture d'un projet EA

Pour guider les collègues ou clients qui vont consulter un projet EA, il est souvent utile de présenter un titre, un résumé d'introduction, et des liens pour ouvrir les modèles principaux dès l'ouverture de ce projet.

Après avoir créé un diagramme d'accueil dans le projet, il est possible de le définir comme diagramme par défaut :

  • Afficher le diagramme et ouvrir le menu Diagram > Advanced > Make Model Default (EA version 10).
  • Pour tester, fermer et ré-ouvrir le projet EA : ce diagramme va s'afficher.
  • Remarque : si la barre d'outils (toolbar) Diagram est affichée, un click sur l’icône "maison" va ouvrir ce diagramme.

sparx enterprise architect make model default

Astuce 3 : afficher les commentaires du diagramme ou d'un élément dans une note

Il est parfois utile d'afficher sur un diagramme dans une note le contenu des commentaires du diagramme en cours ou de l'élément affiché tel qu'un use case, une classe, une interface, etc.

Afin d'éviter de dupliquer ce contenu, ou de ne pas saisir des commentaires dans l'élément en question mais uniquement dans une note associée, EA permet d'afficher dans une note le contenu de commentaires déjà saisis dans un diagramme ou un élément :

  • Pour afficher les commentaires du diagramme dans une note:
    • sélectionner ou créer une note UML,
    • faire un clic droit sur cette note pour afficher son menu contextuel, puis Advanced > Link to Diagram Note
  • Remarque : il est possible de décocher cette option par la suite
  • Pour afficher les commentaires d'un élément dans une note :
    • créer une note UML et l'associer à un élément présent sur le diagramme, par exemple une classe,
    • clic droit sur l'association entre la note et la classe, puis Link this Note to an Element Feature...
    • choisir comme "Feature type" l'option Element Note.
    • Remarque : les autres choix ci-dessous permettent par exemple d'afficher les commentaires d'un attribut au choix, d'une opération au choix, etc
    • Sparx Enterprise Architect link note to element feature
  • Remarque : il est uniquement possible d'afficher les commentaires d'un élément ou du diagramme
  • Exemple de notes associées au diagramme et à une classe:

astuce EA : link note to an element feature and to a diagram note

Astuce 4 : associer une exigence à un cas d'utilisation par un "glisser/déposer"

Il existe plusieurs moyens d'établir la traçabilité dans votre modèle, par exemple pour créer des liens de réalisations entre exigences (requirements) et cas d'utilisations (use case), notamment :

  1. afficher les cas d'utilisations et exigences sur un diagramme, puis créer des liens de réalisation de cas d'utilisations vers des exigences via le Quicklinker;
  2. afficher une matrice de traçabilité (relationship matrix) et créer de nouvelles associations via un clic droit : "create a new relationship".

Il est également possible avec Enterprise Architect de glisser/déposer des exigences sur des cas d'utilisations pour créer ces liens :

  • Ouvrir le diagramme de cas d'utilisations
  • Sélectionner une exigence depuis le "Project Browser", et glisser/déposer cet élément sur le cas d'utilisation -> l'exigence n'est pas ajoutée sur le diagramme, mais le lien de réalisation est créé par l'outil.

astuce-sparx-ea-lien-realisation-requirement-usecase

  • Pour vérifier la création du lien de réalisation, ouvrir les propriétés du cas d'utilisation ou de l'exigence, puis l'onglet Links

astuce-sparx-ea-lien-realisation-requirement-usecase properties

 

Astuce 5 : regrouper des attributs ou opérations d'une classe avec les stéréotypes

Pour certains besoins, il est parfois nécessaire ou utile de pouvoir organiser les attributs et/ou opérations d'une classe par groupes. Par exemple, l'on peut avoir besoin d'indiquer des attributs définis par le système étudié d'une part, et les attributs spécifiques (custom) qui ont été rajoutés d'autre part.

L'exemple suivant présente une classe avec des attributs mélangés, puis la même classe où l'on a regroupé ces attributs par stéréotype System & Custom :

astuce enteprise architect regrouper les attributs d'une classe avec des stereotypes

Pour obtenir ce résultat, il faut modifier chaque attribut de la classe (ouvrir les propriétés de la classe, puis l'onglet Details -> Attributes), puis définir une valeur (ex: System) dans le champ stéréotype de l'attribut en cours de modification :

définir un stéréotype dans l'attribut d'une classe

 

Astuce 6 : replacer un libellé à son emplacement initial

Pour mettre en forme un diagramme, il est courant de déplacer la position d'affichage d'un libellé, par exemple déplacer le texte pour une condition de garde sur une transition entre un nœud de décision et une activité (texte = "oui").

Pour revenir au contexte initial donc replacer ce texte à son emplacement d'origine, il suffit de lancer un clic droit sur le texte/libellé > Default Position :hint ea to place a text label to its default position

Astuce 7 : limiter le périmètre d'une recherche à une partie du modèle

Le module de recherche d'Enterprise Architect est accessible via le raccourci clavier Ctrl-F. Par défaut EA permet d'effectuer une recherche sur l'ensemble du modèle.

Or il est parfois nécessaire de limiter la recherche à une partie du modèle i.e. un paquetage ; pour cela les options avancées de recherches doivent être modifiées :

1- Après avoir ouvert le module de recherche et sélectionné la recherche à effectuer (simple, extended, find orphans, etc.), cliquer sur Builder ; les détails / critères de la recherche sont affichés

2- Cliquer sur le bouton "advanced options" comme illustré dans l'encadré vert ci-dessous :

hint enterprise architect search builder

3- Modifier l'option sous "Search Scope" de "Return matching items for the entire model" par "Return matching items for the selected Package" comme illustré ci-dessous :


4- Sélectionner le paquetage depuis le Project Browser sur lequel la recherche doit être effectuée, saisir le critère de recherche, et lancer Run

Exemple d'application : pour faire le "ménage" dans les modèles afin de supprimer tout élément potentiellement inutilisé (absent de tout diagramme), il peut être nécessaire de ne pas obtenir l'ensemble des éléments orphelins du projet, mais de se limiter à un modèle donné (par exemple le modèle d'analyse).

Astuce 8 : utiliser ctrl-c et ctrl-v pour copier/coller des paquetages depuis l'explorateur "project browser"

Cette astuce est très simple, mais bonne à savoir : pour copier / coller des paquetages depuis l'explorateur du projet EA (Project Browser), il est nécessaire de lancer un droit, puis de sélectionner la commande "Copy Package to Clipboard" ou "Paste Package from Clipboard".

Ctrl-C (copier) et ctrl-V (coller) sur un paquetage sélectionné depuis le Project Browser permettent d'obtenir plus rapidement et simplement le même résultat.

Ces raccourcis ont été modifiés dans la version 13 :

  • Ctrl+C copie le paquetage en tant que lien, par exemple pour le placer dans un diagramme. Il faut utiliser Ctrl+Maj+C pour copier le contenu d'un paquetage dans le presse papier (clipboard).

Astuce 9 : créer plusieurs connecteurs entre éléments avec la "Relationship Matrix"

Il est parfois nécessaire de relier plusieurs éléments via le même type d’association vers un élément, par exemple : relier plusieurs sous classes à une classe principale par des associations d'héritage, relier plusieurs cas d'utilisation à un acteur, relier plusieurs activités BPMN à un gateway, etc.

EA ne permet pas de créer ces associations depuis une sélection d'éléments sur le diagramme, néanmoins un workaround existe avec la matrice (relationship matrix) : ouvrir la vue Relationship Matrix, afficher les éléments source & cible, lancer un Ctrl+Clic pour sélectionner plusieurs cellules et créer les associations nécessaires. En ouvrant le diagramme en cours de modifications, les nouvelles associations devraient être affichées.

Astuce 10 : inverser le sens d'un connecteur

Après avoir créé un connecteur avec un sens de direction entre deux éléments, par exemple une association avec une flèche indiquant le sens (directed association) entre 2 classes, une association d'aggrégation entre 2 classes, ou une association de données entre une activité et un "data object" BPMN2, vous réalisez parfois que le sens est incorrect. Il faut alors inverser ce sens. Afin d'éviter la suppression de ce connecteur pour créer un nouveau connecteur dans le bon sens, il suffit de lancer un clic droit sur le connecteur >  Advanced > Reverse Direction : 

 

Astuce 11 : identifier les erreurs SQL entre EA et la BD via le fichier DBError.txt

Lorsqu'un message d'erreur lié aux échanges avec la base de données du projet EA est affiché (ex : DAO.Recordset error), il est possible d'en obtenir les détails afin de faciliter l'analyse. Cela permet par exemple d'obtenir le contenu de la requête SQL transmise en base de données.
Ces informations sont accessibles à partir du fichier %appdata%\Sparx Systems\ea\DBError.txt.
Important : seule la dernière erreur est conservée dans ce fichier.

Exemples :
20/08/2015 08:00:14
Microsoft OLE DB Provider for ODBC Drivers [-2147467259]
[MySQL][ODBC 5.1 Driver]Can't connect to MySQL server on '127.0.0.1' (10061)
Context:
Provider=MSDASQL.1;Persist Security Info=False;Data Source=MySQL-Win;Initial Catalog=umlchannel_ea;
 
20/08/2015 08:58:35
DAO.Recordset [3077]
Syntax error (missing operator) in expression.
Context:
SQL: select * from t_object where Stereotype='XSDschema' and Object_Type='Package'
 

Astuce 12 : modifier l'apparence et le style de ligne de plusieurs connecteurs dans un diagramme

Cette astuce ne fonctionne qu'à partir d'EA 12.

Enterprise Architect ne permet pas de sélectionner plusieurs connecteurs à partir d’un diagramme afin d’appliquer la même couleur ou modifier le style de ligne (direct, tree style, orthogonal…).

1. Utiliser le raccourci clavier CTRL+Shift+é (touche « 2 » au-dessus des touches azerty) pour afficher la vue Relationships (ou utiliser le menu Element > Relationships avec EA12).

2. Sélectionner tous les éléments sur le diagramme avec la souris : créer d’une zone de sélection sur l’ensemble des éléments du diagramme (le raccourci Ctrl+A ne fonctionne pas).

3. Utiliser la vue Relationships pour sélectionner plusieurs ou tous les connecteurs :

astuce-selection-multiple-connecteurs-EA

4. Lancer un clic droit et sélectionner Appearance pour modifier l’épaisseur et la couleur des connecteurs :

5. Lancer un clic droit et sélectionner Line Style pour modifier le style de ligne. Remarque : cela permet par exemple d’appliquer le style Orthogonal sur l’ensemble des connecteurs.

Astuce 13 : créer une Tagged Value sur une sélection d'éléments

Le raccourci clavier Ctrl-shift-T permet de créer une Tagged Value sur une sélection d'éléments depuis un diagramme comme illustré ci-dessous :

sparx enterprise architect astuce tagged values

La tagged value est alors créée sur tous les éléments:

Astuce 14 : afficher plusieurs fois le même élément en utilisant les cadres de diagrammes

EA ne permet pas d’afficher plusieurs fois le même élément dans un diagramme.
Le contournement consiste à utiliser les cadres de diagrammes (diagram frame) afin de créer un diagramme composé de plusieurs diagrammes.
Dans l’exemple suivant, deux diagrammes ont été définis pour représenter la classe Class1 selon des contextes différents. L’ensemble des classes ont été déposées dans un paquetage dédié (classes).

astuce-ea-affichage-element-multiple

Le diagramme « poster » a été défini pour rassembler le contenu de ces diagrammes ; un glisser/déposer depuis le Project Browser des diagrammes ‘diagram1’ et ‘diagram2’ suivi du choix de l’option ‘Diagram Frame’ permet de créer et d’afficher le cadre de chaque diagramme avec son contenu.

Ces cadres constituent de nouveaux éléments dans le modèle :

L’on obtient ainsi l’affichage multiple de la même classe Class1 dans un seul diagramme.
Le menu contextuel des cadres permet de sélectionner un mode d’affichage différent si besoin :

Le contenu de ce diagramme d’ensemble est automatiquement mis à jour lorsque l’un des diagrammes est modifié. Un double clic sur l'un des cadres permet d'ouvrir facilement le diagramme affiché afin de réaliser des modifications.

Astuce 15 : déplacer horizontalement ou verticalement un élément du diagramme

Il peut être pratique lorsque l'on travaille sur un diagramme de déplacer un élément sur un axe horizontal ou vertical. EA permet de passer dans ce mode :

  • appuyer sur la touche clavier SHIFT (ne pas la relâcher),
  • sélectionner l'élément via un clic gauche de la souris (ne pas la relâcher),
  • déplacer l'élément de gauche à droite (mode horizontal), ou de haut en bas (mode vertical).

astuce Sparx EA deplacer elements diagramme

Astuce 16 : masquer les stéréotypes dans le project browser

L'explorateur du projet EA (project browser) possède quelques options, parmi lesquelles figure la possibilité de masquer les stéréotypes d'éléments. Cette option est spécifique au client EA utilisé car elle est modifiable à partir du menu Tools > Options > General (EA v12.1).

astuce sparx enterprise architect faq hide stereotype project browser

Une fois modifiée, EA doit être relancé afin de constater les changements dans l'explorateur du projet.

Astuce 17 : masquer le nom de la superclasse en haut à gauche de la classe (en italiques)

Lorsqu'une classe possède un lien d'héritage vers une classe parente (superclass) absente du diagramme, EA affiche en italiques le nom de cette classe en haut à gauche de la classe fille. Pour désactiver cet affichage, ouvrir les menu TOOLS | Options | Diagram | Behavior, et décocher Show 'Hidden' Parents.

Astuce 18 : copier un diagramme dans le presse-papier (Clipboard) sans le cadre

Il est souvent utile de copier un diagramme pour le coller dans un document Word, présentation Powerpoint, e-mail, ou autre. Pour cela il suffit de lancer un Ctrl-C dans le diagramme et un Ctrl-V dans l'outil cible. Lorsque le cadre du diagramme avec le type et nom du diagramme ne sont pas nécessaire, il est possible de le désactiver dans les options EA : ouvrir le menu Tools, Options, et sélectionner Diagram. Dans le groupe "Diagram Frames", décocher l'option "On Printed Images".