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