Prise en main de Borland Together Designer 2005 Borland Together Solutions de modélisation agiles et intégrées
Borland Software Corporation 100 Enterprise Way Scotts Valley, California 95066-3249 www.borland.com Les applications mentionnées dans ce manuel sont brevetées, ou en attente de brevet, par TogetherSoft Corporation, filiale à 100 % de Borland Software Corporation. Reportez-vous au CD ou à la boîte de dialogue A propos pour avoir la liste des brevets. Ce document ne donne aucun droit sur ces brevets. Copyright 1998-2004 TogetherSoft Corporation, filiale à 100 % de Borland Software Corporation. Tous droits réservés. Tous les noms de marques et de produits Borland sont des marques de fabrique ou des marques déposées de Borland Software Corporation aux Etats-Unis et dans d autres pays. Tous les autres produits sont la propriété de leurs fabricants respectifs. Mise à jour : 11 novembre 2004
Table des matières Préface A propos de la gamme de produits....... 1-5 Fonctionnalités prises en charge....... 1-6 A propos de ce guide............... 1-7 Public...................... 1-7 Conventions utilisées dans la présentation du texte.................... 1-8 A propos de la documentation.......... 1-8 Autres sources d information........... 1-9 Conseils..................... 1-9 Astuces du jour................. 1-9 Sites Web.................... 1-9 Ressources issues de tiers........... 1-9 Introduction à Together Designer A propos de Together Designer......... 2-11 Scénarios d utilisation classique.........2-12 Ingénierie directe................2-12 Rétro-ingénierie.................2-14 A propos de la modélisation dans Borland Together.................2-14 Eléments de modélisation pris en charge..2-15 Formats de fichiers...............2-16 Lanceur Together Designer............2-16 Présentation de l interface utilisateur graphique.....................2-17 Volets de Together Designer..........2-18 Actions standard portant sur les volets...2-18 A propos des principaux volets........2-20 Travail sur un exemple de projet A propos de cet exemple et de ce chapitre...3-25 Etape 1 : Ouverture du projet exemple.....3-26 Réouverture rapide du projet.........3-27 Etape 2 : Navigation dans les espaces de travail, les projets, les diagrammes et les éléments..3-27 Navigation dans les espaces de travail....3-28 Navigation dans les projets..........3-29 Navigation dans les diagrammes.......3-29 Navigation dans les éléments.........3-32 Etape 3 : Apprendre à modifier des diagrammes................. 3-32 Utilisation des éléments de modélisation.. 3-32 Utilisation de la vue globale......... 3-34 Zoom...................... 3-35 Affichage et masquage des éléments.... 3-36 Etape 4 : Impression des diagrammes..... 3-38 Etape 5 : Modification des propriétés générales du projet............... 3-39 Etape 6 : Fermeture du projet exemple..... 3-40 Création et travail avec un nouveau projet A propos de cet exemple et de ce chapitre... 4-43 Etape 1 : Création d un nouveau projet UML 2.0..................... 4-44 Lancement de l expert Projet......... 4-44 Utilisation de l expert Projet......... 4-45 Etape 2 : Conception d un diagramme cas d utilisation................. 4-46 A propos du placement des éléments et de leur modification........... 4-47 Ajout d acteurs et de cas d utilisation.... 4-48 Interconnexion des éléments du diagramme................ 4-48 Etape 3 : Conception d un diagramme d activité..................... 4-49 Ajout des éléments de modélisation.... 4-50 Etape 4 : Conception d un diagramme de classes..................... 4-51 Ajout d éléments classe............ 4-51 Création de membres pour les éléments classe 4-52 Ajout d interfaces et de liens......... 4-52 Ajout des liens d héritage.......... 4-53 Etape 5 : Modification des propriétés avec l inspecteur................. 4-54 Etape 6 : Ajout d un package enfant...... 4-54 Etape 7 : Création de raccourcis......... 4-55 Etape 8 : Création d hyperliens......... 4-56 Résumé....................... 4-57 iii
iv
CHAPITRE 1 Chapitre 1Préface Ce chapitre est composé des sections suivantes : A propos de la gamme de produits, page 5 A propos de ce guide, page 7 A propos de la documentation, page 8 Autres sources d information, page 9 A propos de la gamme de produits Bienvenue dans la nouvelle gamme d outils Borland Together (ci-après Borland Together), le puissant environnement de conception permettant la modélisation des projets logiciels de tout niveau de complexité, y compris des applications d entreprise. La gamme est constituée de deux produits : Borland Together Designer 2005 Borland Together Developer 2005 Borland Together est un des éléments de la solution globale de gestion du cycle de vie des applications (ALM : Application Lifecycle Management) fournie par Borland Software Corporation. Simplifiez la phase de développement de votre projet en concevant un modèle efficace avec Borland Together. L intégration à JBuilder 2005 permet aux développeurs une transition aisée entre modèles et code source Java. Non seulement tous ces produits permettent aux utilisateurs de travailler sur les modèles de leurs projets logiciels, mais ils proposent plusieurs ensembles de fonctionnalités, destinés aux différents membres de l équipe, et jouent des rôles différents dans le processus de développement. 5
Remarque Borland Together Designer 2005 (ci-après Together Designer) est un studio de modélisation commercial comprenant l ensemble des puissantes fonctionnalités de modélisation de Together. Les concepteurs de logiciels s en servent pour construire les modèles de leurs futures applications. Borland Together Developer 2005 (ci-après Together Developer) est une extension du studio de développement de Borland JBuilder 2005. Il permet aux développeurs de logiciels d utiliser les modèles Borland Together pour créer à partir d eux des logiciels ultra-efficaces. Le chapitre suivant présente les scénarios classiques de l utilisation de ces produits par une équipe de développement de logiciels (voir Scénarios d utilisation classique, page 12). Fonctionnalités prises en charge Le tableau suivant présente les fonctionnalités prises en charge par produit : Tableau 1 Fonctionnalités prises en charge par les produits Fonctionnalité Together Designer 2005 Together Developer 2005 UML 1.4 1 UML 2.0 - Diagrammes logiques relations-entités - LiveSource (Java) - Audits du contrôle de qualité - Métriques du contrôle de qualité - Impression des diagrammes Comparaison de modèles - OCL Patterns de modélisation - Patterns de code source - Collecte de patterns - Génération de code source Java - Génération de la documentation Import XMI v 1.2-6 Pré face
Tableau 1 Fonctionnalités prises en charge par les produits (suite) Fonctionnalité Together Designer 2005 Together Developer 2005 Export XMI v 1.2 - Importation de fichiers IBM Rational Rose 2003 Enterprise Edition (MDL) Intégration de logiciels de gestion des exigences (Borland CaliberRM, IBM RequisitePro) Intégration de logiciels de gestion du code source (SCM=Source Code Management) (ClearCase, CVS, StarTeam, Visual Source Safe) - 2 1. Dans Together Developer, seuls les diagrammes de classes, de séquence et de collaboration sont pris en charge. 2. La prise en charge SCM est fournie par Borland JBuilder. Remarque Toutes les fonctionnalités de Together Designer sont accessibles dans Together Developer si vous possédez une licence Together Designer. A propos de ce guide Ce guide de Prise en main est une introduction au produit Together Designer et il donne un aperçu des techniques de modélisation de Borland Together. Il décrit brièvement l interface utilisateur du produit et propose deux visites guidées dans lesquelles le lecteur explore les fonctionnalités de base sur un exemple de projet, et crée ensuite lui-même un projet simple. De ce fait, nous vous recommandons de suivre les chapitres dans l ordre séquentiel. Pour des instructions plus spécifiques des tâches et des descriptions détaillées, reportez-vous à l aide en ligne (choisissez Aide Rubriques d aide dans le menu principal.) Ce guide suppose que le logiciel Together Designer est installé et configuré sur votre ordinateur. Si ce n est pas le cas, recherchez les instructions d installation dans les notes de mise à jour. Public Les informations contenues dans ce guide sont principalement destinées aux concepteurs de logiciels utilisant Borland Together pour construire les modèles de leurs applications. Cette documentation suppose que vous possédez une certaine expérience dans les domaines suivants : Le langage UML (Unified Modeling Language) Les méthodes mises en œuvre dans votre entreprise pour la conception et la modélisation des systèmes ou des composants orientés objet Prise en main de Borland Together Designer 7
Conventions utilisées dans la présentation du texte Ce guide est au format des fichiers PDF Adobe. Adobe Reader, ou tout autre outil Adobe Acrobat, est nécessaire pour le visualiser ou l imprimer. Le guide utilise les conventions suivantes : Les noms des boutons, boîtes de dialogue et autres éléments de l interface sont en gras, par exemple : Ouvrir. Les éléments sélectionnés dans les menus sont séparés à chaque niveau par une barre verticale ( ), par exemple : Outils Pattern Gestionnaire de patterns signifie : choisir le menu Outils, puis choisir le sous-menu Pattern, et ensuite l élément de menu Gestionnaire de patterns dans celui-ci. A propos de la documentation La documentation de Borland Together se compose des éléments énumérés au Tableau 2 : Tableau 2 Borland Together : documentation Elément Description Emplacement Prise en main de Borland Together Designer 1 Aide en ligne Notes de mise à jour (readme.html) Ce document (voir A propos de ce guide, page 7.) Aide en ligne de Together Designer. Informations complètes particulièrement adaptées à l utilisateur, comprenant : Une introduction à Together Designer Instructions détaillées sur toutes les fonctionnalités Together Designer Utilisation des diagrammes UML Définition des préférences personnelles et des options Informations de dernière minute, comprenant : Notes de licence Configuration système nécessaire Installation et démarrage de Together Problèmes connus Fichier PDF Adobe se trouvant aux emplacements suivants : Dans le dossier de votre installation Borland Together : getting_started.pdf http://info.borland.com/techpubs /together Le menu principal sous Aide Rubriques d aide. Readme se trouvant aux emplacements suivants : Le dossier de votre installation Together dans readme/readme.html http://info.borland.com/techpubs /together 1. Il y a des Guides de prise en main différents pour Together Designer et Together Developer. 8 Pré face
Autres sources d information Si vous avez besoin de plus amples informations, essayez les sources situées ci-après ou contactez le service de support clients de Borland Software Corporation. Conseils Together Designer affiche de brèves descriptions pour chaque option des dialogues de préférences. Cliquez avec le bouton droit sur l option et sélectionnez Qu est-ce que c est? dans le menu contextuel pour voir ces descriptions. Astuces du jour Les utilisateurs peuvent apprendre à connaître les fonctionnalités Together Designer à partir des conseils qui s affichent à chaque démarrage du programme. Sites Web Site Web officiel de Borland Software Corporation : http://www.borland.fr/ Site Borland Developer Network : http://bdn.borland.com/ Ressources issues de tiers Si vous débutez en langage UML, la technologie objet ou le développement d applications distribuées, les ouvrages et sites Web suivants pourront vous aider. UML Distilled : Applying the Standard Object Modeling Language par Martin Fowler. Addison-Wesley, 1997. ISBN : 0201325632 The Unified Modeling Language User Guide par Booch, Rumbaugh et Jacobson. Addison-Wesley, 1998. ISBN 0-201-57168-4 Java Modeling in Color with UML : Enterprise Components and Process par Peter Coad, Jeff De Luca et Eric Lefebvre. Prentice Hall, juin 1999. ISBN : 013011510X Java Design : Building Better Apps & Applets (2 me Ed.) par Peter Coad et Mark Mayfield. Prentice Hall, 1997. ISBN 0-13-271149-4 (pbk). Java Enterprise in a Nutshell par David Flanagan, Jim Farley, William Crawford et Kris Magnusson. O Reilly & Associates, 1999. ISBN 1-56592-483-5 Site du Object Management Group : http://www.omg.org/ Site des Cetus Links : http://www.cetus-links.org/ Site Dev-x Developer Exchange : http://www.devx.com/ Prise en main de Borland Together Designer 9
10 Pré face
CHAPITRE 2 Chapitre 2Introduction à Together Designer Ce chapitre est composé des sections suivantes : A propos de Together Designer, page 11 Scénarios d utilisation classique, page 12 A propos de la modélisation dans Borland Together, page 14 Lanceur Together Designer, page 16 Présentation de l interface utilisateur graphique, page 17 A propos de Together Designer Together Designer 2005 est un studio de conception pour les modèles d applications conformes à UML 1.4 ou UML 2.0. Together Designer comprend toutes les fonctionnalités d avant-garde offertes par la technologie de modélisation Borland Together, y compris la prise en charge des patterns de conception, OCL, les diagrammes logiques relations-entités, l importation et l exportation XMI, l importation des fichiers de modèles IBM Rational Rose (MDL) et la génération automatisée de la documentation. Together Designer 2005 est : Le logiciel de conception de modèles Borland Together L élément le plus récent de la gamme de produits Borland Together La suite de modélisation indépendante conforme à UML 1.4 et UML 2.0 11
Scénarios d utilisation classique Cette section vous montre comment et qui, dans une équipe de développement logiciel, peut utiliser tous les éléments de la gamme de produits Borland Together. Des exemples pratiques d utilisation des produits sont donnés dans les chapitres suivants (voir Travail sur un exemple de projet, page 25, et Création et travail avec un nouveau projet, page 43). Travailler avec un modèle peut se faire selon deux directions : Aller du modèle au code source (voir Ingénierie directe, page 2-12) Aller du code source au modèle (voir Rétro-ingénierie, page 2-14) Borland Together, avec sa technologie de pointe LiveSource, prend en charge ces deux méthodes et garde en permanence synchronisés le modèle et le code source. Ingénierie directe Dans ce cas, le travail de modélisation des applications avec Borland Together implique deux grandes étapes : Conception d un modèle Développement d une application basée sur un modèle Habituellement, des spécialistes différents accomplissent ces étapes respectivement, les concepteurs de logiciels (ou architectes) et les développeurs de logiciels. Conception d un modèle Les concepteurs de logiciels créent un modèle dans Together Designer. Together Designer prend en charge les patterns de modélisation, OCL, l impression des diagrammes, la génération automatique de la documentation, l exportation XMI, l intégration aux systèmes de gestion des exigences et de gestion du code source. L utilisateur peut aussi concevoir un modèle dans Together Developer, s il possède à la fois une licence pour Together Designer et une licence pour Together Developer. Dans ce mode, toutes les fonctionnalités de Together Designer sont accessibles à partir de JBuilder 2005. De nombreux types de diagrammes peuvent servir au modèle. Mais finalement, dans tous les cas, un ou plusieurs diagrammes de classes doivent être créés comme base de toute application orientée objet. Le projet du modèle est composé du fichier.tpx principal, une collection de diagrammes, et de fichiers supplémentaires facultatifs. Le chapitre Création et travail avec un nouveau projet, page 43, est un exemple pratique de la conception d un modèle ex nihilo. 12 Introduction à Together Designer
Développement d une application basée sur un modèle Il existe généralement trois façons de passer du modèle au code source : Générer le code source Java dans Together Designer et construire un projet Java complet sur ce code Créer une application et un modèle simultanément dans JBuilder 2005 et Together Developer Créer une application basée sur le modèle créé préalablement dans Together Designer Ces approches sont décrites en détail ci-après. Génération du code source Java dans Together Designer Together Designer, ainsi que Together Developer en mode Concepteur, incluent la fonctionnalité Génération du code source. Cette fonctionnalité sert à créer des fichiers de code source.java pour les classes et les interfaces du modèle en cours. Les développeurs de logiciels peuvent alors les inclure dans leurs projets d applications. Together Developer n est pas nécessaire dans ce cas. Création d une application et d un modèle simultanément Cette méthode convient aux projets simples et de petite taille, car toute la puissance de modélisation ne sera pas disponible. Together Designer n est pas nécessaire dans ce cas. Vous pouvez créer un projet ex-nihilo dans Borland JBuilder 2005 en ayant installé Together Developer. Dans le projet, vous pouvez créer des diagrammes de classes, de séquence et de collaboration. Lorsque vous ajoutez aux diagrammes des éléments de modélisation, ou lorsque vous les modifiez, Together Developer génère ou met à jour immédiatement le source code et l attache à votre projet JBuilder. Le modèle est stocké dans le projet JBuilder (voir Formats de fichiers, page 16.) Voir un exemple pratique dans le document Prise en main de Together Developer. Création d une application basée sur le modèle importé Cette méthode est préférable pour les vastes projets où toutes les fonctionnalités UML et Borland Together sont nécessaires. Dans ce cas, vous créez un nouveau projet dans JBuilder 2005 basé sur le modèle préalablement conçu avec Together Designer. Vous commencez immédiatement avec le squelette de votre future application. Together Developer garde synchronisés le code source et les diagrammes grâce à la technologie LiveSource. Voir un exemple pratique dans le document Prise en main de Together Developer. Prise en main de Borland Together Designer 13
Résumé Le schéma suivant illustre le workflow général de l ingénierie directe avec Borland Together, et indique les formats de fichiers utilisés : Figure 1 Workflow d ingénierie directe avec Borland Together Pour de plus amples informations sur les formats de fichiers, voir Formats de fichiers, page 16. Voir aussi A propos de la gamme de produits, page 5. Rétro-ingénierie La rétro-ingénierie peut s avérer nécessaire lorsque vous devez construire un modèle autour d un projet Java existant (par exemple, un projet créé avec une version antérieure de Borland JBuilder ou avant que Together Developer ne soit installé.) Cette situation peut être gérée par Together Developer. Voir un exemple pratique dans le document Prise en main de Together Developer. A propos de la modélisation dans Borland Together Dans Borland Together, la modélisation des applications logicielles est basée sur UML (Unified Modeling Language). Un modèle Borland Together se compose d une hiérarchie de packages et, dans ces packages, d une collection de diagrammes interconnectés schémas dans lesquels sont représentées les entités, ou éléments de modélisation (classes, objets, acteurs, etc.), et leurs relations. 14 Introduction à Together Designer
Il existe deux sortes de diagrammes : Les diagrammes générant du code Les diagrammes ne générant pas de code Trois types de diagrammes seulement générent du code : les diagrammes de classes, les diagrammes de séquence et les diagrammes de collaboration. Ces diagrammes de bas niveau sont utilisés par Together Developer pour générer le code source Java. D autres types de diagrammes, par exemple, les cas d utilisation, décrivent un comportement de niveau supérieur ou des aspects auxiliaires du modèle. Ils n affectent pas directement le code source de votre application. Eléments de modélisation pris en charge Together Designer prend en charge les versions 1.4 et 2.0 d UML. Les types de diagrammes suivants sont pris en charge : Diagrammes UML 2.0 Classe Cas d utilisation Séquence Communication Etats Activité Composant Déploiement Structure composite Diagrammes UML 1.4 Classe Cas d utilisation Séquence Collaboration Etats Activités Composant Déploiement Vous devez explicitement spécifier la version d UML utilisée dans votre projet. Prise en main de Borland Together Designer 15
Outre les diagrammes UML, Together Designer prend en charge les diagrammes logiques entités-relations (ER) ainsi que les diagrammes de package spéciaux. Pour les diagrammes de la liste, Together Designer prend en charge toutes les entités (éléments de modélisation) et toutes les relations établies entre elles dans la spécification UML en utilisant la notation UML standard. Les quelques fonctionnalités UML mineures non prises en charge par Together Designer sont mentionnées dans les notes de mise à jour (voir Problèmes connus et limites ). Formats de fichiers Remarque Remarque Together Designer stocke les informations générales concernant les projets dans les fichiers.tpx. Les diagrammes sont stockés séparément du fichier projet dans des fichiers au format XML dont l extension est.txv<type_diagramme>. Par exemple, <nom>.txvclassdiagram14 correspond à un diagramme de classe UML 1.4. Tous les produits fournissant la modélisation (Borland Together Edition pour Eclipse, Borland Together Edition pour Microsoft Visual Studio.NET) prennent en charge le même format de diagramme, ce qui assure la compatibilité de ces derniers sur toute la ligne de produits. Vous pouvez copier et réutiliser des diagrammes créés dans les différents produits. Les versions antérieures des produits cités ci-dessus ne prennent pas en charge les diagrammes UML 2.0. En conséquence, vous ne pouvez pas réutiliser les nouveaux diagrammes UML 2.0 avec les anciennes versions de ces produits. Lorsque vous ouvrez un projet conçu avec une ancienne version de Borland Together, il est automatiquement converti dans un nouveau métamodèle d imbrication. Les éléments de modélisation sont stockés dans des fichiers package (default.txapackage) ou dans des fichiers au format XML dont l extension est.txa<type_élément>, selon l option spécifiée dans l expert Projet (voir Utilisation de l expert Projet, page 45.) La seconde méthode est préférable pour plusieurs raisons, notamment pour la compatibilité avec les autres lignes de produits Borland Together. Certains éléments (par exemple, les acteurs dans les diagrammes de séquence) sont toujours inclus dans les fichiers package directement, indépendamment de cette option. Lanceur Together Designer Ce guide suppose que Together Designer est installé sur votre ordinateur. Les instructions d installation de Together Designer se trouvent dans les notes de mise à jour (voir $TGH$\readme\readme.html). 16 Introduction à Together Designer
Pour lancer Together Designer, appuyez sur le bouton Démarrer de la barre des tâches et sélectionnez Programmes Borland Together Designer Borland Together Designer, ou démarrez $TGH$ 1 \bin\together.exe. La fenêtre principale de Together Designer apparaît. Présentation de l interface utilisateur graphique L apparence de Together Designer ressemble à celle de Borland JBuilder 2005, comme illustré Figure 2 : Figure 2 La fenêtre principale de Together Designer L espace de travail de Together Designer est composé d un menu principal, de barres d outils, de volets (sous-fenêtres du programme principal) et de quelques fenêtres supplémentaires. Les éléments présents dans le menu principal et les barres d outils sont très semblables à ceux de Borland JBuilder 2005. 1. Dossier où est installé Together Designer. Prise en main de Borland Together Designer 17
Volets de Together Designer Les volets suivants sont disponibles dans Together Designer : Projet Contenu Structure Messages Barre d état Navigateur de modèle Navigateur de diagrammes Favoris Inspecteur La suite de ce chapitre vous apprendra comment s utilisent ces volets. Si vous vous êtes familiarisé avec l interface de Together Designer, allez directement au chapitre suivant, Travail sur un exemple de projet, page 25. Actions standard portant sur les volets Il est possible de réorganiser la disposition des volets de façons différentes. Vous pouvez voir ces volets, les cacher, les déplacer, les redimensionner, les mettre en icône, les ancrer, les désancrer et les agrandir en plein écran. Together Designer enregistre la configuration de votre disposition et la restaure à la prochaîne exécution. Il est possible d enregistrer plusieurs configurations de disposition comme espaces de travail. Vous pouvez passer de l un à l autre et gérer vos espaces de travail en utilisant le sous-menu Voir Espaces de travail. Affichage ou masquage des volets Par défaut, seuls les volets Projet et Contenu sont visibles. Montrez ou cachez n importe quel volet en choisissant Voir Volets <volet>. Déplacement, empilement et redimensionnement des volets Déplacez un volet vers une nouvelle position sur l écran en cliquant sur sa barre de titre et en le faisant glisser. Quel que soit le moment du déplacement du volet, Together Designer vous aide à comprendre où le volet sera déplacé en : Affichant un rectangle d ombre au-dessus du nouvel emplacement du volet (pour les volets ancrés, voir ci-dessous les informations sur l ancrage/le désancrage) 18 Introduction à Together Designer
Modifiant le curseur : ancrer le volet sur le côté représenté de la fenêtre principale désancrer le volet emplile le volet avec les autres. Chaque volet sera affiché comme onglet. Pour désancrer un volet particulier, cliquez sur son onglet et faites-le glisser jusqu au nouvel emplacement. permuter deux volets impossible de déplacer le volet sur cette position Pour redimensionner un volet, faites glisser une de ses bordures jusqu à la nouvelle position. Mise en icône, ancrage et désancrage des volets Chaque volet (sauf le volet Contenu et la barre d états) est toujours dans une des dispositions suivantes : Remarque Mis en icône (représenté par un petit symbole apparaissant sur la bordure gauche de la zone de travail) Ancré (ouvert à une position fixe, rangé avec les autres volets ancrés) Désancré (à une position libre sur l écran) Le volet Contenu peut aussi être désancré dans un fenêtre de programme séparée et ancré à nouveau à la zone de travail (utilisez les commandes contextuelles Désancrer l éditeur et Ancrer l éditeur.) L état de sa disposition détermine les actions disponibles pour le volet. Volets mis en icônes Pour mettre un volet en icône, effectuez l une des opérations suivantes : Cliquez avec le bouton droit sur la barre de titre et choisissez Mettre en icône dans le menu contextuel, ou : Cliquez sur l icône Mettre en icône dans la barre de titre. Ancrage des volets Pour ancrer un volet, effectuez l une des opérations suivantes : Cliquez avec le bouton droit sur la barre de titre et choisissez Ancrer dans le menu contextuel, ou : Cliquez sur l icône en forme d épingle dans la barre de titre. Prise en main de Borland Together Designer 19
Désancrage des volets Pour désancrer un volet, effectuez l une des opérations suivantes : Cliquez avec le bouton droit sur la barre de titre et choisissez Désancrer dans le menu contextuel, ou : Déplacez le volet (voir ci-dessus comment déplacer les volets) jusqu à une position pour laquelle Together Designer affiche le curseur Désancrer. Agrandissement des volets en plein écran Pour agrandir un volet afin qu il occupe tout l écran, effectuez l une des opérations suivantes : Double-cliquez sur la barre de titre, ou : Cliquez sur l icône dans la barre de titre, ou : Sélectionnez Agrandir dans le menu contextuel de la barre de titre. Pour ramener un volet agrandi à son état précédent, effectuez l une des opérations suivantes : Double-cliquez sur la barre de titre, ou : Cliquez sur l icône dans la barre de titre, ou : Sélectionnez Restaurer dans le menu contextuel de la barre de titre. A propos des principaux volets Cette section décrit brièvement les volets principalement utilisés pour la modélisation. Volet Projet Ce volet affiche la structure de fichiers constituant votre projet. Habituellement, le projet comprend des fichiers de diagrammes et des fichiers supplémentaires (par exemple, des documents au format HTML), comme illustré Figure 3 : Figure 3 Volet Projet En utilisant le volet Projet, vous pouvez ouvrir, ajouter, supprimer et configurer vos diagrammes, ainsi que tout autre fichier. Voir aussi Navigateur de modèle, page 22. 20 Introduction à Together Designer
Volet contenu Le volet contenu est le volet de travail principal, celui où vous modifiez le corps de votre projet. Il est composé d un ou de plusieurs onglets. Chacun présente une vue d une partie du projet. Ces onglets sont ajoutés lorsque vous ouvrez un composant du projet dans le volet Projet (voir Volet Projet, page 20), dans le Navigateur de modèle (voir Navigateur de modèle, page 22) ou dans le Navigateur de diagrammes (voir Navigateur de diagrammes, page 23). La vue principale de Together Designer est l Editeur de diagramme. Pour ouvrir l élément sélectionné dans l éditeur de diagramme, effectuez l une des opérations suivantes : Cliquez avec le bouton droit sur l élément et choisissez Sélectionner sur le diagramme dans le menu contextuel, ou : Double-cliquez sur l élément. Dans l éditeur de diagramme, vous visualisez, modifiez, configurez et créez les nouveaux diagrammes des modèles (voir Eléments de modélisation pris en charge, page 15, pour connaître les types de diagrammes disponibles), comme illustré Figure 4 : Figure 4 Editeur de diagramme La fenêtre de l éditeur de diagramme est composée de la zone de travail du diagramme, de la barre d outils en haut permettant d accéder aux actions générales, et de la boîte à outils à gauche. La boîte à outils contient des outils (fonctions accomplies avec le curseur : sélection, zoom) et les éléments de modélisation (nœuds) pouvant être ajoutés au diagramme en cours. Voir un exemple pratique d utilisation de l éditeur de diagramme dans Utilisation des éléments de modélisation, page 32. Prise en main de Borland Together Designer 21
Navigateur de modèle Le volet Navigateur de modèle donne une vue hiérarchique globale de votre modèle. Il affiche les diagrammes et les éléments de modélisation, et permet de les gérer, comme illustré Figure 5 : Figure 5 Navigateur de modèle En utilisant les menus contextuels du volet Navigateur de modèle, vous pouvez ouvrir, créer et supprimer des diagrammes et des éléments de modélisation. Au contraire de la vue orientée fichier du volet Projet (voir Volet Projet, page 20), le Navigateur de modèle présente votre modèle du point de vue des entités et de leur hiérarchie. Le Navigateur de modèle affiche tous les éléments de modélisation et tous les diagrammes sur un seul niveau de hiérarchie 1. Lors du travail dans l éditeur de diagramme, vous pouvez cliquer avec le bouton droit sur un élément du diagramme et choisir Sélectionner dans le navigateur de modèle pour mettre en évidence cet élément dans le Navigateur de modèle. Voir un exemple pratique d utilisation du Navigateur de modèle dans Ouverture des diagrammes, page 29. 1. Les éléments de modélisation sont répliqués sous les nœuds de diagramme correspondants, si l option Nœuds de diagramme développables est active (voir Propriétés du projet dans le menu Projet, catégorie Modélisation \ Navigateurs ). 22 Introduction à Together Designer
Navigateur de diagrammes Avec une interface identique au volet Navigateur de modèle, ce navigateur fournit une vue légèrement différente de votre modèle. Tous les diagrammes, regroupés par types (classe, séquence, etc.) sont montrés avec, sous chacun d entre eux, les éléments de modélisation, comme dans la Figure 6 : Figure 6 Navigateur de diagrammes Voir un exemple pratique d utilisation du Navigateur de diagrammes dans Navigation dans les éléments, page 32. Inspecteur Le volet Inspecteur vous permet de visualiser et de modifier les paramètres de vos diagrammes et éléments de modélisation. Toutes les définitions sont organisées sous la forme de nœuds développables dont le contenu et la structure varient avec le type de l élément sélectionné. Le volet Inspecteur apparaît dans deux vues : moderne (avec nœuds développables, par défaut dans cette version, voir Figure 7) et classique (avec onglets, comme dans les versions précédentes de Together, voir Figure 8). Prise en main de Borland Together Designer 23
Figure 7 Inspecteur (vue moderne) Figure 8 Inspecteur (vue classique) Pour passer d une vue à l autre : 1 Cliquez sur un nœud (ou sur un onglet) dans le volet Inspecteur. 2 Choisissez Passer en vue classique/moderne dans le menu contextuel. Voir un exemple pratique d utilisation de l Inspecteur dans Etape 5 : Modification des propriétés avec l inspecteur, page 54. 24 Introduction à Together Designer
CHAPITRE 3 A propos de cet exemple et de ce chapitre 3Travail sur un exemple Chapitre de projet Together Designer est livré avec le projet exemple UML Notation 2.0 qui illustre la technologie de modélisation et met en lumière les nouvelles fonctionnalités de UML 2.0. Cet exemple est situé dans le dossier $TGH$\samples. Ce chapitre est une visite guidée pas à pas. En le lisant, vous travaillerez sur l exemple et apprendrez les bases de Together Designer. Après la lecture de ce chapitre, les points suivants devraient vous être devenus familiers : Comment gérer des projets Together Designer Comment configurer votre espace de travail Comment parcourir, modifier et imprimer des diagrammes Comment et pourquoi modifier les propriétés des projets Cette visite guidée comprend les étapes suivantes : Etape 1 : Ouverture du projet exemple, page 26 Etape 2 : Navigation dans les espaces de travail, les projets, les diagrammes et les éléments, page 27 Etape 3 : Apprendre à modifier des diagrammes, page 32 Etape 4 : Impression des diagrammes, page 38 25
Etape 5 : Modification des propriétés générales du projet, page 39 Etape 6 : Fermeture du projet exemple, page 40 Etape 1 : Ouverture du projet exemple Cette étape vous apprendra à ouvrir les projets Together. Il y a plusieurs façons d ouvrir un projet existant. Pour ouvrir le projet exemple UML Notation 2.0 depuis le menu principal, procédez comme suit : 1 Choisissez Fichier Ouvrir un projet dans le menu principal. La boîte de dialogue Ouvrir un projet apparaît, comme illustré Figure 9 : Figure 9 Ouverture du projet exemple UML Notation 2.0 2 Utilisez le raccourci Exemples, sur la gauche de l écran, pour aller directement au dossier $TGH$\samples. (Vous pouvez utiliser le raccourci Home pour aller à votre dossier local..\documents and Settings\<nom utilisateur>.) 3 Naviguez jusqu au dossier $TGH$\samples\UML-Notation-2.0. 4 Sélectionnez le projet UML-2.0.tpx. 5 Cliquez sur OK pour fermer la boîte de dialogue et ouvrir le projet. Autrement, vous pouvez ouvrir le projet à l aide de l icône située dans la barre d outils des fichiers. 26 Travail sur un exemple de projet
Réouverture rapide du projet Lorsque vous avez ouvert un projet, son emplacement et son nom sont ajoutés à la liste située sous Fichier Rouvrir. La prochaine fois, vous pourrez choisir un projet dans cette liste pour l ouvrir. Pour rouvrir le projet sur lequel vous avez travaillé récemment, effectuez l une des opérations suivantes : Astuce Sélectionnez Fichier Rouvrir dans le menu principal, ou : Sélectionnez l icône dans la barre d outils des fichiers. La liste des projets et des fichiers récemment utilisés apparaît. Cliquez sur UML-2.0.tpx pour ouvrir l exemple de projet s il figure dans la liste. Par défaut, à chaque démarrage de Together Designer, tous les projets utilisés lors de votre dernière session Together Designer sont automatiquement ouverts. Etape 2 : Navigation dans les espaces de travail, les projets, les diagrammes et les éléments En utilisant l exemple UML Notation 2.0, cette étape vous apprendra à ouvrir et à fermer des espaces de travail, des projets, des diagrammes, des éléments, ainsi qu à passer des uns aux autres. Prise en main de Borland Together Designer 27
Figure 10 Lorsque le projet UML Notation 2.0 est ouvert, le texte Nouveautés d UML 2.0 apparaît dans le volet Contenu, comme illustré Figure 10 : Projet UML Notation 2.0 ouvert dans Together Designer Remarque Dans votre cas, les volets peuvent être organisés autrement. Cette image représente organisation de l espace de travail par défaut. Pour de plus amples informations sur l organisation des volets, voir Présentation de l interface utilisateur graphique, page 17. Navigation dans les espaces de travail Il est possible de concevoir un ou plusieurs espaces de travail personnalisés. Pour créer un nouvel espace de travail, procédez comme suit : 1 Choisissez Voir Espaces de travail Enregistrer l espace de travail sous dans le menu principal. 2 Dans le dialogue qui s ouvre, entrez le nom du nouvel espace de travail (par exemple, Mon espace ) et cliquez sur OK. Together Designer enregistre la disposition en cours comme nouvel espace de travail. 28 Travail sur un exemple de projet
3 Réorganisez les volets à votre convenance. Par exemple : ouvrez le volet Projet, le Navigateur de modèle, le Navigateur de diagrammes et l Inspecteur, et rendez-les tous visibles simultanément. Together Designer enregistre votre espace de travail automatiquement chaque fois que vous quittez le programme ou passez à un autre espace de travail. Pour passer à un espace de travail différent : choisissez Voir Espaces de travail <espace de travail>. Navigation dans les projets Plusieurs projets peuvent être ouverts simultanément dans Together Designer. Sans fermer l exemple UML Notation 2.0, ouvrez un autre projet (s il en existe), à l aide des instructions énumérées à l étape 1 (voir Etape 1 : Ouverture du projet exemple, page 26.) Pour revenir à UML Notation 2.0 : choisissez Fenêtre Projets UML-2.0.tpx. Navigation dans les diagrammes Cette section vous apprendra les opérations élémentaires sur les diagrammes : Remarque Ouverture des diagrammes Passage d un diagramme à l autre Ouverture des diagrammes parent et enfant Fermeture des diagrammes Une fois le projet ouvert dans Together Designer, sa structure s affiche dans le volet Projet, le Navigateur de modèle et le Navigateur de diagrammes (voir A propos des principaux volets, page 20.) Vous voyez maintenant comment chacun des volets représente un aspect du projet. Ouvrir et fermer ne connecte pas et ne déconnecte pas les diagrammes du projet mais les montre ou les cache dans le volet Contenu. Ouverture des diagrammes Vous pouvez utiliser un des volets de navigation mentionnés ci-dessus pour ouvrir les diagrammes. Cependant, le plus pratique est généralement le Navigateur de modèle. Prise en main de Borland Together Designer 29
Pour ouvrir le diagramme de package usecase, procédez comme suit : 1 Dans le Navigateur de modèle, développez l arborescence des modèles pour trouver le diagramme : UML-2.0 <default> behavior usecase (voir Figure 11) : Figure 11 Sélection du diagramme de package usecase dans le Navigateur de modèle 2 Double-cliquez sur le diagramme usecase, ou choisissez Ouvrir dans le menu contextuel. Résultat : Le diagramme usecase s ouvre sur un nouvel onglet dans l éditeur de diagramme, comme illustré Figure 12 : Figure 12 Le diagramme de package usecase ouvert dans l éditeur de diagramme Pour ouvrir le diagramme Main Use Cases depuis le diagramme usecase, effectuez l une des opérations suivantes : Sur le diagramme usecase, double-cliquez sur le nœud Main Use Cases, ou : Choisissez Ouvrir dans le menu contextuel du nœud Main Use Cases. Le diagramme Main Use Cases s ouvre sur un nouvel onglet dans l éditeur de diagramme. 30 Travail sur un exemple de projet
Passage d un diagramme à l autre Pour revenir au diagramme usecase, effectuez l une des opérations suivantes : Sélectionnez à nouveau le diagramme usecase dans un des volets de navigateur et cliquez sur Ouvrir, ou : Choisissez Fenêtre usecase dans le menu principal, ou : Choisissez Fenêtre Changer... et sélectionnez usecase dans la liste, ou : Cliquez sur l onglet du diagramme usecase dans l éditeur de diagramme. Ouverture des diagrammes parent et enfant Together Designer prend en charge la structure hiérarchisée des modèles. Chaque diagramme, sauf le diagramme <default>, a un et un seul diagramme parent 1. Pour ouvrir le diagramme parent du diagramme usecase, effectuez l une des opérations suivantes : Cliquez sur l icône dans la barre d outils de l éditeur de diagramme, ou : Choisissez Diagramme Ouvrir le diagramme parent dans le menu principal, ou : Appuyez sur Ctrl+Retour arrière. Le diagramme behavior s ouvre. La hiérarchie des diagrammes s affiche dans le Navigateur de modèle. Pour ouvrir un diagramme enfant, double-cliquez sur le nœud (usecase) qui le représente dans le diagramme parent. La hiérarchie du modèle est décrite en détail dans le chapitre suivant, voir Etape 6 : Ajout d un package enfant, page 54. Fermeture des diagrammes Pour fermer le diagramme Main Use Cases, effectuez l une des opérations suivantes : Cliquez sur l icône de fermeture dans la barre de titre du diagramme, ou : Choisissez Fermer Main Use Cases dans le menu contextuel de la barre de titre du diagramme, ou : Choisissez Fermer... dans le menu contextuel de l en-tête du volet Contenu et sélectionnez Main Use Cases dans la liste. 1. Tout diagramme peut inclure un ou plusieurs raccourcis vers d autres diagrammes. Cependant, les diagrammes liés par un raccourci ne sont ni enfant ni parent. Voir Etape 7 : Création de raccourcis, page 55. Prise en main de Borland Together Designer 31
Navigation dans les éléments Pour trouver l acteur Customer, procédez comme suit : 1 Ouvrez le Navigateur de diagrammes. 2 Développez l arborescence du modèle jusqu au nœud Cas d utilisation Main Use Cases Customer. 3 Double-cliquez sur ce nœud ou choisissez Sélectionner sur le diagramme dans le menu contextuel. Résultat : Le diagramme Main Use Cases s ouvre, l acteur Customer est sélectionné dans le diagramme. Autrement, vous pouvez naviguer vers l élément en utilisant le Navigateur de modèle ou en ouvrant les nœuds dans l éditeur de diagramme. Etape 3 : Apprendre à modifier des diagrammes Cette étape vous apprendra les opérations de modification élémentaires suivantes, en utilisant l exemple du diagramme behavior : Utilisation des éléments de modélisation Utilisation de la vue globale Zoom Affichage et masquage des éléments Nous supposons que le diagramme behavior est affiché dans l éditeur de diagramme, comme illustré Figure 12. Utilisation des éléments de modélisation Tout diagramme se présente sous la forme d un champ comportant des nœuds (qui représentent les éléments de modélisation) et des relations (liens). Vous pouvez effectuer les opérations élémentaires suivantes sur ces éléments : Déplacer ou redimensionner des nœuds en faisant glisser les nœuds concernés et leurs bordures dans le volet Editeur de diagramme à l aide de la souris (voir Volet contenu, page 21) Couper, copier, coller, cloner, renommer ou supprimer un nœud ou un groupe de nœuds en choisissant les commandes appropriées dans le menu contextuel ou dans le menu Edition 32 Travail sur un exemple de projet
Renommer ou modifier le contenu d un nœud en effectuant l une des opérations suivantes : Double-cliquer sur le nom du nœud, ou : Appuyer sur F2, ou : Utiliser le volet Inspecteur (voir Inspecteur, page 23) Ouvrir les nœuds des sous-packages (par exemple, activity) 1 en effectuant l une des opérations suivantes : Double-cliquer sur le nœud, ou : Cliquer avec le bouton droit sur le nœud et choisir Ouvrir dans le menu contextuel. Aligner plusieurs nœuds les uns par rapport aux autres. Par exemple : a. Sélectionnez les nœuds activity et usecase dans le diagramme behavior. b. Choisissez Aligner à gauche dans la liste des alignements ( ) sur la barre d outils de l éditeur de diagramme, ou choisissez Diagramme Aligner Aligner à gauche dans le menu principal. Résultat : Ces deux nœuds sont centrés horizontalement. Vous pouvez choisir d aligner en haut, à droite, en bas, ou de centrer horizontalement ou verticalement. Arranger la disposition générale du diagramme. Par exemple : a. Sélectionnez tous les éléments dans le diagramme behavior en choisissant Edition Tout sélectionner dans le menu principal. b. Choisissez Disposer tout pour impression dans la liste des dispositions ( ) sur la barre d outils de l éditeur de diagramme ou choisissez Diagramme Disposition Disposer tout pour impression dans le menu principal. Résultat : Tous les nœuds du diagramme sont réorganisés pour améliorer l impression 2. Vous pouvez disposer automatiquement tout, les éléments sélectionnés ou tout à l exception des éléments sélectionnés, disposer la sous-structure inner ou optimiser la taille du ou des éléments. Rediriger manuellement les relations et les liens. Par exemple : Basculez sur le diagramme Main Use Cases. Cliquez sur la ligne qui relie Customer au nœud Manage Preferences. Faites glisser la ligne. Together Designer reforme automatiquement le lien selon vos souhaits, comme par exemple dans la Figure 13 : 1. Pour de plus amples informations sur les packages, voir le chapitre suivant, Etape 6 : Ajout d un package enfant, page 54. 2. L algorithme servant à la réorganisation est configuré d après la catégorie Disposition des propriétés de modélisation du projet. Voir Etape 5 : Modification des propriétés générales du projet, page 39. Prise en main de Borland Together Designer 33
Figure 13 Redirection d un lien sur le diagramme Main Use Cases Annulation et rétablissement des modifications Together Designer prend en charge l annulation/le rétablissement multiple des opérations pour toutes les modifications que vous avez apportées aux diagrammes. Choisissez Edition Annuler/Rétablir dans le menu principal ou dans la barre d outils, ou appuyez sur les touches Ctrl+Z/Ctrl+Maj+Z. Utilisation de la vue globale Il se peut que le diagramme Main Use Cases ne tienne pas entièrement dans votre écran. Bien qu il soit possible de faire défiler les diagrammes et de zoomer (voir Zoom, page 35), l éditeur de diagramme propose une autre fonctionnalité utile : la Vue globale. Cette fonctionnalité montre le diagramme en cours sous la forme d une vignette. L exemple suivant montre comment parcourir le diagramme Main Use Cases dans la Vue globale. 34 Travail sur un exemple de projet
Pour parcourir le diagramme Main Use Cases dans la Vue globale, procédez comme suit : 1 Pour ouvrir la fenêtre de la Vue globale, effectuez l une des opérations suivantes : Cliquez sur le bouton dans le coin inférieur droit de l éditeur de diagrammes, ou : Choisissez Diagramme Vue globale dans le menu principal, ou : Appuyez sur Ctrl+Maj+O. 2 La fenêtre Vue globale apparaît, comme illustré Figure 14 : Figure 14 Vue globale dans le diagramme Main Use Cases 3 Cliquez sur la zone ombrée. Remarquez l apparition du curseur sous la forme d une petite main dans la zone ombrée, comme illustré Figure 14. 4 Faites glisser la zone ombrée dans la fenêtre Vue globale. Le volet Contenu suit le déplacement en affichant la partie ombrée du diagramme Main Use Cases. 5 Cliquez sur la zone non ombrée. La focalisation de la vue se déplace et se centre sur ce point. 6 Modifiez la taille de la fenêtre Vue globale en cliquant sur un coin de la fenêtre et en faisant glisser la souris pour la redimensionner. 7 Appuyez sur Echap ou cliquez sur l icône de fermeture dans la barre de titre de la fenêtre ou n importe où sur le diagramme pour fermer la Vue globale. Zoom Plusieurs moyens permettent d obtenir l agrandissement souhaité dans l éditeur de diagrammes : Utiliser les boutons de zoom dans la barre d outils de l éditeur de diagramme (zoom avant, zoom arrière, taille réelle ou ajustée à la fenêtre) Utiliser Zoom dans la boîte à outils de l éditeur de diagramme (un clic gauche fait un zoom avant, un clic droit, un zoom arrière) Prise en main de Borland Together Designer 35
Choisir les commandes Diagramme Zoom... dans le menu principal Appuyez sur les touches +/- du clavier numérique Affichage et masquage des éléments Si vous travaillez sur un gros projet, la quantité d informations affichées dans un diagramme peut devenir envahissante. Dans l éditeur de diagramme, vous pouvez sélectivement afficher ou masquer des informations. L exemple suivant démontre comment cacher et afficher les parties du diagramme Main Use Cases (vérifiez qu il est affiché actuellement.) Pour cacher et afficher l acteur Customer, procédez comme suit : 1 Dans l éditeur de diagramme, cliquez avec le bouton droit sur le nœud Customer. 2 Choisissez Cacher dans le menu contextuel 1, comme illustré Figure 15 : Figure 15 Masquage de l acteur Customer 1. Pour les diagrammes de classe ou de package, il est également possible de cacher tous les attributs de classe, toutes les opérations, les classes inner ou même tous les éléments. 36 Travail sur un exemple de projet
Résultat : Le nœud Customer disparaît du diagramme, comme illustré Figure 16 : Figure 16 L acteur Customer est caché Remarque Toutes les parties cachées continuent d être traitées par Together Designer et par Together Developer. 3 Pour afficher un élément masqué, cliquez avec le bouton droit dans l arrière-plan du diagramme et choisissez Afficher les éléments cachés dans le menu contextuel. La boîte de dialogue Afficher les éléments cachés pour : Main Use Cases apparaît. 4 La partie gauche de la boîte de dialogue contient la liste des éléments cachés et la partie droite la liste des éléments visibles. Placez l élément Customer dans la liste de droite. 5 Cliquez sur OK. L acteur Customer réapparaît à la même place. Prise en main de Borland Together Designer 37
Etape 4 : Impression des diagrammes Dans cette étape, vous imprimerez sur papier le diagramme behavior. Pour imprimer le diagramme behavior, procédez comme suit : 1 Basculez sur le diagramme behavior. Le diagramme est déjà optimisé pour l impression (voir page 3-33). 2 Choisissez Fichier Aperçu avant impression... dans le menu principal. La boîte de dialogue Aperçu apparaît et affiche le diagramme en cours tel qu il sera sur le papier, comme illustré Figure 17 : Figure 17 Prévisualisation de l impression du diagramme behavior 3 Examinez la prévisualisation et cliquez sur Fermer. 4 Si quelque chose ne vous convient pas dans la prévisualisation du diagramme, retouchez sa disposition (voir Etape 3 : Apprendre à modifier des diagrammes, page 32). 38 Travail sur un exemple de projet
5 Choisissez Fichier Imprimer behavior dans le menu principal. La boîte de dialogue Impression d un diagramme s ouvre. 6 Dans cette boîte de dialogue, spécifiez les paramètres suivants : Portée : Choisissez la portée des diagrammes à imprimer. Sélectionnez Diagramme en cours. Nombre de copies Etendue de pages : Choisissez Toutes. Imprimer dans un fichier : Cette option sert à créer des fichiers Adobe PDF ou PostScript au lieu de réelles impressions sur papier. Laissez-la non cochée. Bouton Options : Cliquez pour spécifier les paramètres d impression, comme le format de la feuille. 7 Cliquez sur OK. La boîte de dialogue standard de l impression apparaît. 8 Dans cette boîte de dialogue, sélectionnez l imprimante et définissez ses propriétés spécifiques. 9 Cliquer sur OK. Together Designer imprime le diagramme behavior. Etape 5 : Modification des propriétés générales du projet Cette étape vous apprendra à modifier les propriétés globales des projets. Les propriétés d un projet comprennent les chemins d'accès, les préférences de modélisation (par exemple, la police utilisée dans les diagrammes), les préférences du niveau de détails ou des filtres d'affichage, etc. Vous pouvez voir et modifier les propriétés d un projet dans la boîte de dialogue Propriétés du projet. Pour accéder à la boîte de dialogue Propriétés du projet, effectuez l une des opérations suivantes : Sélectionnez Projet Propriétés du projet... dans le menu principal, ou : Dans le volet Projet (voir Volet Projet, page 20) ou le Navigateur de modèle (voir Navigateur de modèle, page 22), cliquez avec le bouton droit sur le nom du projet et sélectionnez Propriétés...dans le menu contextuel. Prise en main de Borland Together Designer 39
Résultat : La boîte de dialogue Propriétés du projet s ouvre, comme illustré Figure 18 : Figure 18 Boîte de dialogue Propriétés du projet Astuce Parcourez les propriétés. Elles sont organisées en trois catégories et sous-catégories. Alors que nombre d entre elles personnalisent l apparence et le niveau de détail des diagrammes et des volets sur l écran, d autres agissent sur le comportement de Together Designer pour le projet en cours. Les modifications apportées aux propriétés du projet sont enregistrées lorsque vous quittez ou enregistrez le projet. Pour de plus amples informations sur les propriétés, consultez les conseils s affichant avec chaque option, ou cliquez sur le bouton Aide. Etape 6 : Fermeture du projet exemple Il est recommandé que vous exploriez maintenant l exemple UML Notation 2.0 par vous-même. Utilisez les techniques apprises dans ce chapitre et lisez les notes fournies sur les diagrammes. Lisez le fichier readme New In UML 2.0.html (Nouveautés d UML 2.0). 40 Travail sur un exemple de projet
Remarque Lorsque vous avez fini, effectuez l une des opérations suivantes pour fermer les projets exemple : Choisissez Fichier Fermer les projets... dans le menu principal et sélectionnez tous les projets de la liste, ou : Cliquez sur l icône dans le volet Projet ou le Navigateur de modèle (vous devrez faire cela pour chacun des projets ouverts). La boîte de dialogue Enregistrement des fichiers modifiés apparaît. Désélectionnez tous les projets pour ne pas enregistrer les modifications que vous avez apportées aux exemples. Cliquez sur OK. Lorsque vous forcez Together Designer à enregistrer votre projet, il enregistre uniquement le fichier principal du projet (.tpx). Tous les autres fichiers liés au projet (par exemple, vos diagrammes) sont enregistrés immédiatement à chaque modification effectuée. Résultat : Le projet exemple est maintenant fermé. Prise en main de Borland Together Designer 41
42 Travail sur un exemple de projet
CHAPITRE 4 A propos de cet exemple et de ce chapitre 4Création et travail avec Chapitre un nouveau projet Ce chapitre est une autre visite guidée pas à pas. En le suivant, vous allez créer un nouveau projet simple dans Together Designer ex nihilo et apprendre les bases de la modélisation. Vous construirez le modèle d une application qui planifie les rendez-vous avec des clients. Après la lecture de ce chapitre, les points suivants devraient vous être devenus familiers : Comment concevoir de nouveaux projets et comment construire des modèles UML Comment gérer les packages et la hiérarchie d un modèle Comment créer des hyperliens et des raccourcis (deux façons de lier les éléments) Cette visite guidée comprend les étapes suivantes : Etape 1 : Création d un nouveau projet UML 2.0, page 44 Etape 2 : Conception d un diagramme cas d utilisation, page 46 Etape 3 : Conception d un diagramme d activité, page 49 Etape 4 : Conception d un diagramme de classes, page 51 Etape 5 : Modification des propriétés avec l inspecteur, page 54 Etape 6 : Ajout d un package enfant, page 54 43
Etape 7 : Création de raccourcis, page 55 Etape 8 : Création d hyperliens, page 56 et Résumé, page 57 Etape1: Création d un nouveau projet UML 2.0 Dans cet exemple, vous allez créer un nouveau projet UML 2.0. Lancement de l expert Projet L expert Projet est utilisé pour créer de nouveaux projets. La Galerie d objets est utilisée pour créer les nouvelles entités : projets, diagrammes, éléments. Pour lancer l expert Projet en utilisant la Galerie d objets depuis le menu principal, procédez comme suit : 1 Choisissez Fichier Nouveau dans le menu principal. La fenêtre Galerie d objets s ouvre, comme illustré Figure 19 : Figure 19 La galerie d objets 2 Choisissez la catégorie Projet. Choisissez l élément Projet UML 2.0. Cliquez sur OK. Autrement, vous pouvez lancer l expert Projet en effectuant l une des opérations suivantes : Cliquez sur l icône Nouveau dans la barre d outils principale (ouvre la Galerie d objets), ou : Choisir le type de projet depuis la boîte liste Nouveau ( ), ou : Choisissez Fichier Nouveau projet... dans le menu principal. 44 Cré ation et travail avec un nouveau projet
Utilisation de l expert Projet La fenêtre de l expert Projet s affiche, comme illustré Figure 20 : Figure 20 Expert Projet Etape 1 1 Entrez ProjetExemple comme nom du projet. 2 Naviguez jusqu au répertoire où vous souhaitez stocker vos projets. 3 Cochez Créer les éléments de modélisation dans des fichiers distincts (voir Formats de fichiers, page 16.) 4 Acceptez les autres valeurs par défaut, cliquez sur Suivant >. Expert Projet Etape 2 s ouvre, comme illustré Figure 21. Prise en main de Borland Together Designer 45
Figure 21 L expert Projet Etape 2 5 Spécifiez les chemins d accès pour Diagramme et Documentation. Il est recommandé de laisser ces valeurs inchangées. Cliquez sur Terminer. Le nouveau ProjetExemple est créé (cela peut prendre un peu de temps) et affiché à l écran. A cet instant, il contient uniquement le package <default> et le diagramme du package <default>. Etape 2 : Conception d un diagramme cas d utilisation Habituellement, la conception d un modèle commence par le diagramme cas d utilisation principal. Dans ce diagramme, vous modélisez les situations générales dans lesquelles sera utilisée votre future application. Nous ferons de même avec notre exemple. Dans cette étape, vous allez créer le diagramme cas d utilisation GestionRdV. Pour créer le diagramme GestionRdV, procédez comme suit : 1 Utilisez la barre d outils de l éditeur de diagramme pour créer un diagramme cas d utilisation. Cliquez sur l icône Nouveau diagramme. La galerie d objets s ouvre. 2 Sélectionnez la catégorie Diagramme UML 2.0. 3 Dans la liste de droite, sélectionnez Cas d utilisation, cliquez sur OK. Une boîte de dialogue s ouvre. 4 Dans la boîte de dialogue, nommez le diagramme GestionRdV, acceptez les autres valeurs par défaut et cliquez sur OK. 46 Cré ation et travail avec un nouveau projet
Résultat : Le diagramme de cas d utilisation GestionRdV s ouvre dans l éditeur de diagramme, comme illustré Figure 22 : Figure 22 Diagramme de cas d utilisation GestionRdV Autrement, vous pouvez créer un nouveau diagramme en effectuant l une des opérations suivantes : Utiliser les commandes du menu Diagramme, ou : Utiliser l icône Nouveau de la barre d outils principale, ou : Utiliser les commandes de menu contextuel A propos du placement des éléments et de leur modification Quand vous créez un nouveau diagramme, l'éditeur de diagramme présente un arrière-plan vide. Vous placez les divers éléments de modélisation (comme les classes, les acteurs, etc.) sur ce fond et y dessinez les liens relationnels existant entre eux. Les principaux outils pour dessiner et modifier des éléments du diagramme sont : Boîte à outils Editeur de diagramme. Utilisez les icônes de la boîte à outils pour placer les éléments et tracer les liens qui les connectent. Menu contextuel du diagramme. Cliquez avec le bouton droit sur le fond du diagramme pour afficher le menu contextuel du diagramme. Utilisez-le pour créer de nouveaux éléments, afficher les objets cachés, gérer la disposition, configurer les options de niveau diagramme, ainsi que pour actualiser diagrammes et hyperliens. Menus contextuels des éléments. Cliquez avec le bouton droit sur les divers éléments et les divers liens pour afficher les commandes du menu contextuel qui leur est spécifique. Inspecteur. Utilisez le volet Inspecteur pour modifier les propriétés du diagramme ou des éléments. Vous pouvez aussi créer des hyperliens vers des diagrammes, des éléments, des fichiers ou des URL. Prise en main de Borland Together Designer 47
Voir Volet contenu, page 21 et Inspecteur, page 23 pour de plus amples informations. Ajout d acteurs et de cas d utilisation Maintenant, vous allez ajouter des acteurs et des cas d utilisation au diagramme GestionRdV. Astuce Pour créer les éléments du diagramme GestionRdV, procédez comme suit : 1 Cliquez sur l icône Acteur et sur le fond du diagramme. Un nouveau nœud d acteur est créé. 2 Nommez-le Client et appuyez sur Entrée. Pour activer l éditeur in-situ pour des éléments de diagramme, cliquez deux fois sur le libellé texte de l élément ou appuyez sur F2. 3 Cliquez sur l icône Cas d utilisation et créez deux cas d utilisation en les nommant Gérer RdV et Vérifier Dispo. 4 Sur la droite, créez un autre acteur en le nommant Réceptionniste. Votre diagramme doit ressembler à celui illustré Figure 23. Figure 23 Le diagramme GestionRdV Interconnexion des éléments du diagramme Vous allez maintenant connecter des acteurs aux éléments cas d utilisation au moyen de liens relationnels. Utilisez la boîte à outils pour dessiner ces liens. 48 Cré ation et travail avec un nouveau projet
Pour interconnecter les éléments du diagramme, procédez comme suit : 1 Cliquez sur l icône Association et reliez l acteur Client au cas d utilisation Gérer RdV. 2 Cliquez sur l icône Association et reliez l acteur Réceptionniste au cas d utilisation Gérer RdV. 3 Répétez la dernière étape pour créer un lien avec le cas d utilisation Vérifier Dispo. 4 Cliquez sur l icône Inclusion et reliez le cas d utilisation Gérer RdV au cas d utilisation Vérifier Dispo. Votre diagramme doit ressembler à celui illustré Figure 24 : Figure 24 Le diagramme GestionRdV avec les liens relationnels Etape 3 : Conception d un diagramme d activité Nous allons créer un diagramme d activité qui modélise le comportement dynamique du système. La modification la plus remarquable apportée par UML 2.0 s applique aux diagrammes d activité. En fait, ce type de diagrammes a été complètement renouvelé. Prise en main de Borland Together Designer 49
D abord, vous devez créer un nouveau diagramme d activité. Créez un nouveau diagramme selon les instructions de l étape 2 (voir Etape 2 : Conception d un diagramme cas d utilisation, page 46) mais choisissez le type de diagramme Activité. Entrez Comportement général comme nom du diagramme. Ajout des éléments de modélisation Pour ajouter des éléments de modélisation au diagramme Comportement général, procédez comme suit : 1 Dans la boîte à outils de l éditeur de diagramme, cliquez sur l icône Initial. 2 Cliquez sur la partie gauche du fond du diagramme pour créer le point de départ. 3 Dans la boîte à outils de l éditeur de diagramme, cliquez sur l icône Nœud final d activité. 4 Cliquez sur la partie droite du fond du diagramme pour créer le point d arrivée. 5 Dans la boîte à outils de l éditeur de diagramme, cliquez sur l icône Activité. 6 Cliquez sur la partie centrale du fond du diagramme, tracez un grand rectangle pour créer une zone d activité principale et nommez-la Procédure standard. 7 Dans la boîte à outils de l éditeur de diagramme, cliquez sur l icône Paramètre d activité. 8 Cliquez sur la bordure gauche de l activité pour créer un paramètre et nommez-le NomClient. 9 Dans la boîte à outils de l éditeur de diagramme, cliquez sur l icône Action. 10 Cliquez sur le fond de l activité pour créer une action et nommez-la Réceptionner un client. 11 Répétez les étapes 9 et 10 pour créer des actions supplémentaires en les nommant : Vérifier les données du client et la disponibilité du patron, Proposer un Rdv au client et Inscrire le RdV. 12 Dans la boîte à outils de l éditeur de diagramme, cliquez sur l icône Jointure. 13 Cliquez sur la partie gauche du fond du diagramme pour créer un point de jointure. 14 Dans la boîte à outils de l éditeur de diagramme, cliquez sur l icône Branchement conditionnel. 15 Cliquez sur la partie droite du fond du diagramme pour créer un point de branchement. 16 Connectez les éléments par des liens de flot de contrôle, comme illustré Figure 25 : 50 Cré ation et travail avec un nouveau projet
Figure 25 Le diagramme d activité Comportement général Résultat : Le diagramme d activité principal de notre ProjetExemple est terminé. Etape 4 : Conception d un diagramme de classes Lorsque vous avez décrit le comportement de votre application dans des diagrammes cas d utilisation et activités, vous pouvez concevoir son infrastructure dans un diagramme de classes de base. Dans cette étape, vous allez concevoir les classes de base de l application ProjetExemple. D abord, vous devez créer un nouveau diagramme de classes. Bien qu il soit possible de placer des classes dans les diagrammes de packages, il vaut mieux créer des diagrammes de classes séparés. Créez un nouveau diagramme selon les instructions de l étape 2 (voir Etape 2 : Conception d un diagramme cas d utilisation, page 46) mais choisissez le type de diagramme Classes. Entrez ClassesBase comme nom du diagramme. Ajout d éléments classe Il est supposé que le diagramme ClassesBase est en cours d affichage dans l éditeur de diagramme. Pour ajouter des éléments classe au diagramme ClassesBase, procédez comme suit : 1 Dans la boîte à outils de l éditeur de diagramme, cliquez sur l icône Classe. Prise en main de Borland Together Designer 51
2 Cliquez sur le fond du diagramme pour créer une classe et nommez-la Première. 3 Répétez les étapes 1 et 2 pour créer deux autres classes en les nommant, respectivement, Deuxième et Troisième. Autrement, vous pouvez créer une classe en effectuant l une des opérations suivantes : Cliquez avec le bouton droit sur le fond du diagramme et choisissez Nouveau Classe, ou : Dans le Navigateur de modèle, cliquez avec le bouton droit sur le diagramme ClassesBase et choisissez Nouveau Classe. Résultat : L éditeur de diagramme et le Navigateur de modèle affichent les nouvelles classes. Dans le Navigateur de modèle, vous pouvez développer le nœud du package ClassesBase pour voir les classes. Création de membres pour les éléments classe Astuce Astuce Pour créer les membres des éléments classe, procédez comme suit : 1 Cliquez avec le bouton droit sur la classe Deuxième et choisissez Nouveau Attribut dans le menu contextuel. Nommez l attribut attr. Quand vous utilisez l éditeur in-situ pour nommer un membre de classe, vous pouvez également spécifier un type, par exemple attr : String. 2 Cliquez avec le bouton droit sur la classe Première et choisissez Nouveau Opération dans le menu contextuel. Nommez l opération foo:void. Vous pouvez ajouter aux classes des constructeurs, des ports et tout autres membres. Ajout d interfaces et de liens Vous allez créer un modèle pour l API (application programming interface) de notre projet exemple. Pour ajouter l interface, procédez comme suit : 1 Cliquez sur l icône Interface dans la boîte d outils de l éditeur de diagramme. 2 Cliquez sur le fond du diagramme pour créer l interface. Nommez l interface API. 3 Cliquez sur l icône Interface fournie. Cliquez sur Première et faites glisser le lien jusqu à API. 4 Cliquez sur l icône Interface requise. Cliquez sur Deuxième et faites glisser le lien jusqu à API. 52 Cré ation et travail avec un nouveau projet
5 Répétez la dernière étape pour Troisième. Résultat : Vous avez créé un modèle de l interface qui est implémentée dans la classe Première et utilisée par les classes Deuxième et Troisième. Ajout des liens d héritage Astuce Pour créer des exemples de lien d héritage, cliquez sur l icône du lien Généralisation/Implémentation. Cliquez sur Deuxième et faites glisser le lien jusqu à Troisième. Résultat : Cette action établit la relation d extension. Troisième est désormais la classe parent de Deuxième. Lorsque vous déplacez la souris au-dessus d une classe, une bordure met en évidence l emplacement que Together Designer reconnaît comme destination correcte pour l extrémité du lien, comme illustré Figure 26 : Figure 26 Utilisation du glisser-déplacer pour créer un lien d héritage Résultat : Votre diagramme doit ressembler à celui illustré Figure 27 : Figure 27 La vue finale du diagramme ClassesBase L aide en ligne de Together Designer décrit d autres types de liens relationnels. Prise en main de Borland Together Designer 53
Etape 5 : Modification des propriétés avec l inspecteur Dans cette étape, vous utiliserez l inspecteur (voir aussi Inspecteur, page 23) pour personnaliser l attribut qui vient d être créé pour la classe Deuxième. Pour ajouter des détails à attr, procédez comme suit : 1 Ouvrez le volet Inspecteur. 2 Sélectionnez attr dans la classe Deuxième. 3 Développez le nœud Propriétés de l inspecteur. 4 Dans le champ initial value, entrez 23. 5 Cochez les champs static et final. Vous pouvez modifier les valeurs de l alias, du nom, de la visibilité et d autres propriétés, comme illustré Figure 28 : Figure 28 Inspecteur des propriétés de attr Etape6: Ajout d un package enfant La hiérarchie du modèle se construit à l aide de packages. Un package est un ensemble pouvant contenir des diagrammes, des éléments de modélisation et des sous-packages. Chaque package inclut le diagramme du package où sont affichés tous les éléments. Habituellement, cette technique sert à concevoir de vastes modèles bien organisés, dans lesquels les diagrammes des sous-packages enfant détaillent les packages parent. 54 Cré ation et travail avec un nouveau projet
Dans cette étape, vous allez ajouter le sous-package DétailsRdV au package <default>. Pour ajouter ce sous-package, procédez comme suit : 1 Passez au diagramme du package <default> (voir Passage d un diagramme à l autre, page 31). 2 Dans la boîte à outils de l éditeur de diagramme, cliquez sur l icône Package. 3 Cliquez sur le fond du diagramme pour créer un nœud de package et nommez-le DétailsRdV. L éditeur de diagramme et le Navigateur de modèle affichent le nouveau nœud de package DétailsRdV, comme illustré Figure 29 : Figure 29 Ajout du sous-package DétailsRdV Autrement, vous pouvez ajouter un package en cliquant sur le package parent dans le Navigateur de modèle et en choisissant Nouveau Package dans le menu contextuel. Etape7: Création de raccourcis En utilisant les raccourcis, vous créez dans un diagramme un pseudo-nœud qui représente un autre nœud, de sorte que les raccourcis peuvent servir à lier des diagrammes. Prise en main de Borland Together Designer 55
Dans cette étape, vous allez créer un raccourci depuis le diagramme ClassesBase vers le package DétailsRdV. Pour créer ce raccourci, procédez comme suit : 1 Basculez sur le diagramme ClassesBase. 2 Cliquez avec le bouton droit sur le fond du diagramme et choisissez Nouveau Raccourcis... dans le menu contextuel. La boîte de dialogue Ajouter des raccourcis pour : ClassesBase s ouvre. 3 Choisissez ProjetExemple <default> DétailsRdV dans l arborescence Contenu disponible. 4 Ajoutez-le à la liste des éléments existants et/ou prêts à être ajoutés. Cliquez sur OK. Astuce Résultat : Le nœud DétailsRdV apparaît dans le diagramme ClassesBase. Tous les nœuds qui sont des raccourcis s affichent avec un symbole spécial en bas :. Dans le métamodèle d imbrication institué par cette version de Together, tous les éléments appartiennent directement à des packages, non à des diagrammes. Lorsque vous placez un élément sur un diagramme, il est ajouté au package et un raccourci apparaît sur le diagramme. C est pourquoi, par exemple dans les Figure 23 et Figure 27, tous les éléments sont des raccourcis. Etape8: Création d hyperliens En utilisant des hyperliens, vous liez deux éléments de modélisation ou un élément et un diagramme pour exprimer une connexion logique. Un hyperlien n est pas une relation établie entre éléments, il est sans influence sur le code source. Seul un commentaire est ajouté par Together Developer. Il s agit d un supplément d information destiné au concepteur de l application, lui permettant de connecter, par exemple, des cas d utilisation et des diagrammes de classes. Dans cette étape, vous allez créer un hyperlien entre le cas d utilisation GestionRdV et la méthode foo du diagramme de classes. Pour créer cet hyperlien, procédez comme suit : 1 Passez au diagramme cas d utilisation GestionRdV. 2 Cliquez avec le bouton droit sur l élément cas d utilisation Gérer RdV et choisissez Hyperlien vers Elément existant dans le menu contextuel. La boîte de dialogue Sélectionner des éléments s affiche. 3 Dans la liste située à gauche de la boîte de dialogue, sélectionnez ProjetExemple <default> ClassesBase Première foo. 56 Cré ation et travail avec un nouveau projet
4 Cliquez sur Ajouter pour ajouter la méthode foo à la liste de droite. Cliquez sur OK. Résultat : Un hyperlien est créé. Le cas d utilisation est maintenant affiché en police bleue pour indiquer qu un hyperlien existe, comme illustré Figure 30 : Figure 30 Le diagramme GestionRdV avec un hyperlien 5 Pour tester l hyperlien, cliquez avec le bouton droit sur le cas d utilisation et choisissez Hyperlien vers foo. Le diagramme du package contenant la méthode correspondante s affiche avec la méthode sélectionnée. Résumé Félicitations. La visite est terminée! Si vous avez effectué toutes les étapes avec précision, vous avez la base de votre modèle ProjetExemple et connaissez les principes de la construction des modèles UML avec Together Designer. Nous vous recommandons de terminer tous les détails du modèle par vous-même en utilisant les techniques décrites dans ce guide. Notez que le métamodèle UML 2.0 prescrit une syntaxe. Apprenez le métamodèle en apprenant la syntaxe. Consultez l aide en ligne (accessible dans le menu principal en choisissant Aide Rubriques d aide, ou en appuyant sur le bouton Aide dans les boîtes de dialogue) pour de plus amples informations sur les fonctionnalités du produit et son intégration aux autres systèmes (gestion des exigences, gestion du code source). Et maintenant, bonne chance! Prise en main de Borland Together Designer 57
Borland Software Corporation 11 novembre 2004