Guide de l utilisateur de Borland Together Developer 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. tdevelug 1E0R1204 0405060708-987654321 PDF
Table des matières Borland Together Developer 2005 1 Fonctionnalités prises en charge........... 1 Documentation.................... 2 Obtention et utilisation de l aide.......... 3 Conventions...................... 3 Chapitre 1 Visite de Together 5 Composants de l interface utilisateur de Together.. 5 Menus et barre d outils............... 6 Volets de Together................. 6 Affichage ou masquage des volets....... 7 Redimensionnement ou agrandissement des volets en plein écran........... 7 Ancrage, désancrage, déplacement et mise en icône de volets............... 7 Volets de navigation................ 8 Navigateur de modèle............. 9 Navigateur de favoris.............. 9 Navigateur de diagrammes........... 10 Volet projet..................... 10 Volet contenu................... 11 Editeur de diagramme............. 11 Inspecteur..................... 12 Basculement entre les vues de l inspecteur.. 12 Utilisation du volet Inspecteur......... 13 Nœuds de l inspecteur............. 14 Recherche des emplacements de nœuds, fichiers et dossiers.................... 16 Préférences de configuration............. 17 Affichage et modification des options..... 17 Chapitre 2 Utilisation de projets dans Together 19 Notions fondamentales sur les projets........ 20 Répertoire racine du projet............ 20 Fichier projet.................... 20 Le diagramme <default>.............. 20 Métamodèle d imbrication............... 21 Stockage physique des diagrammes et des éléments de modélisation......... 21 Eléments de modélisation autonomes..... 22 Filemates.................... 22 Comportement des opérations liées au Presse-papiers................ 22 Création de projets.................. 23 Création d un projet Together classique...... 23 Création d un projet UML 2.0 à partir d un projet UML 1.4....................... 24 Création d un projet à partir d un modèle MDL.. 25 Création d un projet à partir d un modèle XMI... 26 Projet JBuilder à partir d un modèle Designer... 26 Projet JBuilder avec diagrammes UML 1.4 créé ex-nihilo................... 27 Ouverture, fermeture et sélection de projets..... 27 Modification des propriétés du projet......... 28 Gestion des ressources d un projet......... 29 Conversion de projets UML 1.4 en projets UML 2.0. 30 Conversion d un élément Etat sur un diagramme d activité..................... 31 Conversion de l élément Composant sur un diagramme de déploiement....... 31 Conversion des éléments de modélisation Périmètre du système et Travée.............. 32 Conversion de débranchements et de jointures. 33 Utilisation de fichiers et de dossiers......... 34 Ajout et suppression de fichiers......... 34 Ouverture et fermeture de fichiers........ 34 Passage d un fichier à l autre........... 35 Utilisation des systèmes de contrôle de version pour les fichiers et les dossiers de Together.. 35 Utilisation de favoris................. 35 Chapitre 3 Utilisation des diagrammes 37 Création de diagrammes dans des projets..... 37 Création de diagramme à l aide du menu principal ou de la barre d outils.............. 38 Utilisation de la fonction hyperlien pour créer des diagrammes................ 38 Clonage de diagrammes............. 39 Renommer des diagrammes........... 39 Suppression de diagrammes........... 39 Ouverture et fermeture de diagrammes....... 39 Affichage et organisation de diagrammes...... 40 Visualisation................... 40 Vue globale.................. 41 Affichage et masquage d éléments........ 41 Zoom....................... 42 Gestion de la disposition d un diagramme.... 42 Création d une disposition personnalisée.... 43 Alignement des éléments de modélisation.... 44 Dessin d éléments de modélisation......... 44 Dessin des éléments d un nœud......... 45 Dessin de liens de relation............ 45 Dessin de liens avec des points de courbure. 46 Dessin d un lien réflexif............ 46 Création de raccourcis.............. 46 Manipulation d éléments de nœuds et de liens... 47 Utilisation de la grille............... 47 Sélection d éléments de nœuds et de liens... 47 Menus contextuels................ 48 Modification des propriétés............ 48 Modifications dans l Inspecteur........ 48 Edition in-situ................. 49 Déplacement et copie d éléments par glisser-déposer............... 49 Prise en charge complète du glisser-déposer.. 50 Copie, clonage et déplacement d éléments et raccourcis.................. 50 Utilisation du presse-papiers et du glisser-déposer sur des raccourcis.. 51 Redimensionnement des éléments d un nœud. 51 i
Réacheminement et classement des liens.... 52 Utilisation des liens d association......... 53 Définition du type de lien............ 53 Libellés de lien................. 54 Rôle client et fournisseur............ 55 Cardinalité client et fournisseur........ 55 Qualificateurs client et fournisseur....... 55 Ajouts de qualificateurs d attributs....... 55 Synchronisation avec le navigateur de modèle.. 56 Annuler Rétablir................. 56 Dépendances de package.............. 56 Annotation de diagrammes.............. 57 Utilisation des notes................ 57 Modification des notes et de leurs propriétés... 57 Enregistrement et copie des images des diagrammes.................. 58 Copie de l image................. 58 Enregistrement d une image........... 58 Hyperliens et diagrammes.............. 59 Création d hyperliens............... 59 Visualisation des hyperliens............ 60 Navigation dans les hyperliens......... 60 Suppression d hyperliens........... 60 Hyperliens entre projets.............. 61 Utilisation des fonctions de recherche........ 61 Recherche sur les diagrammes.......... 61 Recherche par requête.............. 61 Résultat de la recherche............. 63 Recherche rapide................. 64 Recherche d un élément référencé........ 65 Chapitre 4 Modélisation 67 Types de diagramme pris en charge......... 67 Prise en charge OCL (Object Constraint Language). 68 Editeur OCL.................... 69 Diagrammes UML 1.4................ 70 Utilisation des diagrammes UML 1.4 de packages et de classes................... 70 Diagramme de classes............. 70 Diagramme de packages............ 71 Eléments des diagrammes de classes et de packages................ 73 Définition de classes internes (classes inner). 74 Création des liens d implémentation...... 74 Création d associations, d agrégations et de compositions.............. 74 Classes d associations et associations n-aire. 75 Création de membres............. 76 Modification des propriétés des éléments de diagramme et des membres....... 76 Configuration des contrôles du compartiment. 77 Prise en charge de Java 5.0 dans les diagrammes de classes UML 1.4............. 78 Génériques................... 78 Enumérations................. 79 Type d annotation............... 80 Utilisation des diagrammes de séquence et de collaboration (interaction) UML 1.4.... 80 Diagramme de séquence........... 80 Diagrammes de collaboration..........81 Eléments du diagramme............82 Conversion entre diagrammes de séquence et de collaboration...............82 Options du diagramme de séquence......83 Instanciation des classes............83 Importation de classes.............83 Utilisation des messages............84 Création de blocs d instructions.........87 Utilisation des objets et des lignes de vie....87 Utilisation du code d implémentation dans un diagramme de séquence.......88 Utilisation des diagrammes de cas d utilisation UML 1.4.....................90 Eléments du diagramme............91 Création de séquences de navigation dans les diagrammes de cas d utilisation...91 Utilisation des diagrammes d états UML 1.4....92 Eléments du diagramme............93 Dessin de transitions réflexives.........93 Création de transitions internes.........93 Spécification des actions d entrée et de sortie.93 Création d éléments différés..........94 Création de sous-états imbriqués........94 Affichage de plusieurs sources de transition..94 Création d un historique.............95 Modélisation d états complexes.........95 Utilisation des diagrammes d activité UML 1.4...95 Eléments des diagrammes d activité UML 1.4.96 Création de transitions internes.........97 Création d éléments différés..........97 Spécification des actions d entrée/sortie pour un état..................98 Création de sous-états imbriqués........98 Création de transitions à sources et cibles multiples....................98 Utilisation des diagrammes de composants UML 1.4.....................99 Eléments du diagramme............99 Modélisation des diagrammes de composants............... 100 Utilisation des diagrammes de déploiement UML 1.4.................... 100 Eléments du diagramme........... 101 Modélisation des diagrammes de déploiement............... 101 Diagrammes UML 2.0................ 101 Utilisation des diagrammes UML 2.0 de packages et de classes........... 101 Eléments des diagrammes de classes UML 2.0................... 102 Utilisation d interfaces............. 103 Utilisation des diagrammes d interaction (séquence et communication) UML 2.0.... 106 Utilisation d interactions............ 106 Eléments du diagramme........... 108 Lignes de vie................. 109 Invariants d état................ 114 Fragments combinés............. 116 ii
Références aux interactions. Utilisation de l interaction................ 119 Vérificateur d intégrité............ 121 Utilisation des diagrammes de cas d utilisation UML 2.0.................... 122 Eléments du diagramme........... 123 Utilisation des cas d utilisation........ 123 Création de séquences de navigation dans les diagrammes de cas d utilisation.. 124 Utilisation des diagrammes d états UML 2.0... 124 Eléments du diagramme........... 125 Création d états................ 126 Modification d états.............. 126 Création de membres d états et de régions. 127 Création de transitions pour connecter des états.................. 127 Modification des transitions.......... 127 Création d un historique........... 128 Utilisation des diagrammes d activité UML 2.0. 128 Eléments des diagrammes d activité UML 2.0................... 129 Création, regroupement et décomposition d actions et d activités............ 130 Création de paramètres d activités...... 131 Création de connecteurs d entrée, de sortie et de valeur................. 131 Création de liens pour les flots de contrôle et les flots d objets............. 131 Création de flots de contrôle à plusieurs sources ou cibles................... 132 Création de branchements conditionnels et de fusions................ 132 Utilisation des diagrammes de composants UML 2.0.................... 132 Eléments du diagramme........... 133 Notation.................... 133 Utilisation des spécifications d instances... 134 Utilisation des diagrammes de déploiement UML 2.0.................... 135 Eléments du diagramme........... 136 Modélisation des diagrammes de déploiement............... 137 Utilisation des diagrammes de structures composites UML 2.0.............. 137 Eléments du diagramme........... 138 Création d une structure interne et de ports. 138 Définition d instances de collaboration.... 139 Liaison de rôle................ 140 Utilisation d interfaces............ 140 Diagrammes (relations-entités) de modélisation de données.................... 141 Utilisation des diagrammes relations-entités (ERD)..................... 141 Modèles de données logique et physique.. 142 Création de diagrammes relations-entités.. 142 Notation.................... 142 Niveaux d affichage.............. 142 Eléments du diagramme........... 143 Vérification du modèle logique........ 148 Comparaison de modèles.............. 148 Notions de base de la comparaison....... 148 Configuration des types d éléments de modèle.................. 149 Utilisation de configurations multiples..... 149 Utilisation de la comparaison de modèles.... 150 Comparaison d entités avec les propriétés personnalisées................. 151 Analyse des résultats de la comparaison.... 151 Schéma de couleur................ 151 Profilage UML.................... 152 Profils disponibles................ 153 Activation et désactivation de profils....... 153 Profil Together 6.0................ 154 Profil UML en couleur.............. 154 Profil UML de processus métier......... 155 Profil UML de processus de développement de logiciel.................... 156 Chapitre 5 Génération du code source 157 Expert Génération de code source......... 157 Chapitre 6 Génération de la documentation 159 Génération de la documentation des projets.... 159 Génération de la documentation d un projet ouvert...................... 159 Génération de la documentation HTML.... 159 Génération de la documentation à l aide d un template................ 160 Paramètres de la boîte de dialogue...... 161 Automatisation de la génération de documentation. 163 Lancement du générateur de documentation à partir de la ligne de commande........ 163 Options de génération de la documentation... 164 Option de génération de documentation à l aide d un template............ 164 Option de génération de la documentation HTML.................... 165 Chapitre 7 Patterns 167 Notions de base sur les patterns.......... 167 Registre de patterns et gestionnaire de patterns.. 168 Synchronisation des patterns........... 169 Filtrage et tri des patterns............ 169 Modification des noms.............. 169 Création de groupes logiques de patterns.... 170 Patterns de code source............... 170 Catégories de patterns de code source..... 171 Propriétés du pattern............... 171 Utilisation des macros de patterns...... 172 Macros définies par l utilisateur........ 173 Création de patterns de code........... 173 Modification des patterns de code........ 177 Suppression des patterns de code et des dossiers................ 177 iii
Patterns binaires.................. 178 Comportement des patterns.......... 178 Création de patterns binaires en utilisant l API ouverte..................... 178 Création de descriptions de patterns..... 179 Création d un exemple de pattern personnalisé................ 179 Patterns de modélisation.............. 181 Création de patterns de modélisation...... 181 Patterns de première classe............ 183 Reconnaissance des patterns........... 183 Application des patterns.............. 185 Migration de patterns utilisateur.......... 186 Copiez les patterns existants dans le dossier template.................... 186 Utilisation des anciens patterns binaires.... 186 Chapitre 8 Exécution des audits et métriques 189 Audits........................ 189 Exécution des audits.............. 189 Affichage du résultat des audits....... 190 Utilisation du rapport des résultats....... 191 Navigation jusqu au code source....... 192 Tri des résultats............... 192 Mise à jour des résultats........... 192 Impression des résultats des audits..... 193 Exportation des résultats d audits...... 193 Correction automatique des violations d audit.. 194 Enregistrement d ensembles d audits à exécuter................... 194 Métriques...................... 196 Comment utiliser les métriques?........ 196 Exécution des métriques............ 197 Résultats des métriques............. 198 Tri des résultats dans le tableau....... 198 Filtrage des résultats............. 199 Affichage des graphiques de résultats.... 199 Graphe de Kiviat............... 201 Impression des résultats............ 202 Impression des résultats à partir du tableau. 202 Impression des résultats graphiques..... 203 Exportation des résultats des métriques.... 203 Création de rapports HTML avec hyperliens pour les métriques............. 204 Enregistrement et chargement des résultats des métriques............... 204 Comparaison des résultats des métriques.. 205 Enregistrement d ensembles de métriques à exécuter................... 207 Sources d information supplémentaires..... 207 Définitions des audits................ 208 Audits de révision de code........... 210 Fragments de code similaires (LIKE)..... 210 Audits sur le style de codage.......... 212 L instruction switch devrait inclure un case default (SSSIDC).............. 212 Accès aux membres statiques par le nom de classe d un descendant (ASMDCN)... 212 Accès aux membres statiques via des objets (ASMO)................... 213 Affectations de paramètres formels (AFP).. 214 Affectations complexes (CA)......... 214 Clauses d initialisation ou de mise à jour complexes dans une boucle for (CIUCFL). 215 Fichiers longs (LF).............. 215 Lignes longues (LL).............. 215 Instructions multiples sur une ligne (MSOL). 215 Opérateur de négation dans une instruction if (NOIS).................... 216 Attribut statique non final (NFSA)....... 216 Littéraux numériques dans le code (NLC).. 216 L opérateur?: ne devrait pas être utilisé (OSNBU).................. 216 Mettre la condition entre parenthèses dans l opérateur?: (PCO)......... 217 Placer les déclarations au début des blocs (PDBB)................... 217 Fournir l incrément dans l instruction for ou utiliser l instruction while (PIFS)..... 217 Référencement des packages d implémentation (RIP)..................... 218 Littéraux chaîne (SL)............. 218 Utilisation explicite de this pour accéder aux membres de classe (UTE)....... 218 Utiliser un opérateur d affectation abrégé (UAAO)................... 219 Audits d erreurs critiques............. 219 Séparation commande/requête (CQS).... 219 Masquage des attributs hérités (HIA)..... 220 Masquage des méthodes statiques héritées (HISM).................... 220 Masquage des noms (HN).......... 220 Constructeurs ou méthodes correspondants inaccessibles (IMCM)............ 221 Multiples déclarations visibles avec le même nom (MVDSN).................. 222 Surcharge dans une sous-classe (OWS)... 222 Redéfinition de méthode non abstraite par une méthode abstraite (ONAMAM)... 223 Redéfinition de méthode privée (OPM).... 223 Attribut statique utilisé pour l initialisation (SAUI).................... 223 Audits sur le style de déclaration......... 224 Emplacement incorrect des déclarateurs de tableau (BLAD).............. 224 Les attributs privés constants doivent être correctibles (CPASBF)............ 224 Les variables constantes devraient être déclarées final (CVSBF)................ 225 Déclaration de chaque variable dans une instruction séparée (DVSS)....... 225 Les classes instanciées devraient être déclarées final (ICSBF)................. 226 Lister en premier les membres publics et package (LPPMF)................... 226 Ordre de déclaration des membres de classe (ODCM)................... 227 iv
Ordre des modificateurs (OM)........ 227 Placer en dernier la fonction Main (PMFL).. 227 Placer d abord la classe publique (PPCF).. 228 Audits de documentation............ 228 Balise incorrecte dans des commentaires Javadoc (BTJC)............... 228 Détection des associations basées sur des collections (DCBA)......... 229 Fournir des commentaires de fichier (PFC). 230 Fournir des commentaires Javadoc (PFC).. 230 Audits sur le style de nommage......... 230 Un nom de classe devrait correspondre à un nom de fichier (CNSMFN)....... 230 Noms des classes d exception (NEC).... 230 Conventions de nommage (NC)....... 231 Rassemblement des opérations de même nom (POSNT).................. 232 Utiliser des noms de variable conventionnels (UCVN)................... 232 Audits de performances............. 233 Ajout à une chaîne dans une boucle (ASWL) 233 Expressions de boucles complexes (CLE).. 233 Déclaration de variables dans des boucles (DVIL).................... 234 Concaténations de chaînes multiples (MSC). 235 Trop de case dans l instruction Switch (TMSSC).................. 235 Audits d erreurs possibles............ 235 Modificateur synchronized (SM)....... 235 Affectations dans une expression conditionnelle (ACE).................... 236 Affectation de variables de boucle for (AFLV).................... 236 Appel à super.finalize() à partir de finalize (CSF).................... 236 Comparaison entre types à virgule flottante (CFPT)................... 237 Constantes avec valeurs égales (CEV).... 237 Blocs catch vides (ECB)........... 237 Corps dans un bloc (EBWB)......... 238 Initialisation explicite de toutes les variables (EIAV).................... 238 Mélange d opérateurs logiques sans parenthèse (MLOWP).................. 238 Attributs publics et de package (PPA).... 239 Renvoi d une valeur Null au lieu d une collection vide (RNEC)................ 239 Instruction avec un corps vide (SEB)..... 240 Instruction break ou commentaire dans l instruction Case (SBCCS)......... 240 Utiliser equals au lieu de = = (UE)..... 241 Utilisation de L au lieu de l à la fin des constantes entières (UL).......... 241 Audits de contenu superflu........... 242 Opérations d égalité sur des arguments booléens (EOBA)................... 242 Construction de liste d importation (ILC)... 242 Modificateurs d interface obsolètes (OIM).. 243 Evaluations instanceof superflues (UIOE).. 243 Casts superflus (UC)............. 244 Modificateurs de membres d interface inutiles (UIMM).................... 244 Parenthèses d instruction return inutiles (URSP)................... 245 Variables locales et paramètres formels inutilisés (ULVFP)................... 245 Membres de classes privés non utilisés (UPCM)................... 245 Définitions des métriques.............. 246 Métriques de base................ 248 Lines of Code (LOC) (lignes de code)..... 248 Number of Attributes (NOA) (nombre d attributs)............. 248 Number of Classes (NOC) (nombre de classes)............. 248 Number of Constructors (NOCON) (nombre de constructeurs).......... 248 Number of Members (NOM) (nombre de membres)............ 248 Number of Operations (NOO) (nombre d opérations)............ 248 Number of Import Statements (NOIS) (nombre d instructions Import)........ 249 Métriques de cohésion.............. 249 Lack of Cohesion of Methods 1 (LOCOM1) (manque de cohésion des méthodes 1)... 249 Lack of Cohesion of Methods 2 (LOCOM2) (manque de cohésion des méthodes 2)... 249 Lack of Cohesion of Methods 3 (LOCOM3) (manque de cohésion des méthodes 3)... 250 Métriques de complexité............. 250 Attribute Complexity (AC) (complexité des attributs).......... 250 Cyclomatic Complexity (CC) (complexité cyclomatique).......... 250 Number of Remote Methods (NORM) (nombre de méthodes Remote)....... 251 Response for Class (RFC) (réponse pour la classe)........... 251 Weighted Methods Per Class 1 (WMPC1) (méthodes pondérées par classe 1)..... 252 Weighted Methods Per Class 2 (WMPC2) (méthodes pondérées par classe 2)..... 252 Métriques de couplage.............. 252 Change Dependency Between Classes (CDBC) (modification de la dépendance entre classes)................ 252 Coupling Between Objects (CBO) (couplage entre objets)........... 253 Coupling Factor (CF) (facteur de couplage).. 253 Data Abstraction Coupling (DAC) (couplage avec abstraction de données)........ 254 FanOut (FO) (déploiement).......... 254 Method Invocation Coupling (MIC) (couplage des appels de méthode)........... 254 Violations of Demeters Law (VOD) (violations de la loi de Demeters)............ 254 v
Métriques d encapsulation........... 256 Attribute Hiding Factor (AHF) (facteur de masquage des attributs)......... 256 Method Hiding Factor (MHF) (facteur de masquage des méthodes)....... 257 Métriques Halstead............... 257 Halstead Difficulty (HDiff) (difficulté Halstead)............. 257 Halstead Effort (HEff) (travail Halstead)... 257 Halstead Program Length (HPLen) (longueur de programme Halstead).... 257 Halstead Program Vocabulary (HPVoc) (vocabulaire du programme Halstead)... 257 Halstead Program Volume (HPVol) (volume du programme Halstead)..... 258 Number of Operands (NOprnd) (nombre d opérandes)........... 258 Number of Operators (NOprtr) (nombre d opérateurs)........... 259 Number of Unique Operands (NUOprnd) (nombre d opérandes uniques)....... 260 Number of Unique Operators (NUOprtr) (nombre d opérateurs uniques)....... 261 Métriques sur l héritage............. 262 Attribute Inheritance Factor (AIF) (facteur d héritage des attributs)...... 262 Method Inheritance Factor (MIF) (facteur d héritage des méthodes)..... 262 Depth of Inheritance Hierarchy (DOIH) (profondeur de la hiérarchie des héritages) 262 Number of Child Classes (NOCC) (nombre de classes enfant)......... 262 Métriques sur le couplage fondé sur l héritage. 263 Total Reuse in Descendants Unitary (TRDu) (total des réutilisations dans l unitaire des descendants).............. 263 Total Reuse in Descendants percentage (TRDp) (total des réutilisations dans le pourcentage de descendants).............. 264 Total Reuse from Ancestors unitary (TRAu) (total des réutilisations depuis l unitaire des ancêtres)................ 266 Total Reuse from Ancestors percentage (TRAp) (total des réutilisations depuis le pourcentage des ancêtres)................ 267 Métriques du maximum............. 268 Maximum Number of Levels (MNOL) (nombre maximal de niveaux)....... 268 Maximum Number of Parameters (MNOP) (nombre maximal de paramètres)..... 269 Maximum Size of Operation (MSOO) (taille maximale de l opération)....... 269 Métriques relatives au polymorphisme..... 269 Number of Added Methods (NOAM) (nombre de méthodes ajoutées)...... 269 Number of Overridden Methods (NOOM) (nombre de méthodes remplacées).... 269 Polymorphism Factor (PF) (facteur de polymorphisme)........ 270 Métriques sur les ratios............. 270 Comment Ratio (CR) (ratio de commentaire)........... 270 True Comment Ratio (TCR) (ratio des commentaires véritables)..... 270 Percentage of Package Members (PPkgM) (pourcentage de membres du package).. 271 Percentage of Private Members (PPrivM) (pourcentage de membres privés)..... 271 Percentage of Protected Members (PProtM) (pourcentage de membres protégés).... 271 Percentage of Public Members (PPubM) (pourcentage de membres publics)..... 271 Chapitre 9 Importation et exportation de modèles 273 Importation et exportation de modèles XMI..... 273 Exportation de modèles XMI........... 273 Importation de modèles XMI........... 274 Importation de modèles IBM Rational Rose (MDL). 274 Importation de modèles MDL via la ligne de commande................... 274 Chapitre 10 Intégration des outils de gestion des exigences 277 Présentation de l intégration de CaliberRM..... 277 Utilisation de l intégration de CaliberRM..... 278 Ajout d une connexion CaliberRM à un projet Together............. 278 Ouverture d un projet CaliberRM....... 279 Gestion des traces.............. 279 Utilisation de l inspecteur........... 280 Navigation entre des exigences et des éléments............... 281 Génération de la documentation....... 281 Création de cas d utilisation à partir d exigences 281 Création d exigences sur le serveur....... 282 Présentation de l intégration de RequisitePro.... 282 Utilisation de l intégration de RequisitePro.... 282 Activation de l intégration........... 283 Modification des paramètres d un projet Together............. 283 Gestion de traces vers des éléments de modélisation............... 284 Navigation entre les exigences et les diagrammes.............. 285 Génération de la documentation....... 286 Création de diagrammes de cas d utilisation... 286 Annexe A Raccourcis clavier 287 Navigation entre vues et volets........... 287 Navigation entre les onglets internes........ 287 Manipulation des éléments de diagramme..... 287 Récapitulatif des raccourcis clavier......... 288 vi
Annexe B Préférences de modélisation 291 Préférences de base................ 291 Préférences de liens................ 293 Préférences des détails d affichage......... 295 Onglets Membres, Elément de modélisation et Package................... 296 Préférences des Filtres d affichage......... 296 Cacher...................... 296 Destinations exclues............... 297 Notations UML................... 298 Préférences de diagrammes de séquence 1.4... 298 Préférences de diagrammes de séquence 2.0... 299 Préférences de disposition............. 300 Préférences d impression.............. 303 Préférences de génération de la documentation.. 303 Préférences de génération du HTML........ 303 Préférences de génération du HTML..... 303 Préférences Javadoc............. 304 Préférences des profils............... 305 Préférences du code source............. 305 Préférences des navigateurs............ 306 Options de tri................... 306 Préférences de comparaison des modèles..... 307 Index 309 vii
viii
0Borland Together Developer 2005 Chapitre Borland Together Developer est une extension du studio de développement JBuilder 2005. Ce produit vous permet de créer des logiciels ultra-efficaces à partir de modèles générés avec Borland Together Designer. Together Developer est un kit de développement Java comprenant des fonctionnalités appréciées et demandées comme les audits, les métriques, les patterns et bien d autres. Fonctionnalités prises en charge Le tableau suivant indique les fonctionnalités prises en charge par chaque 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 ER 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 - Borland Together Developer 2005 1
Documentation 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 charges. 2. La prise en charge SCM est fournie par JBuilder 2005. Together Developer comprend toutes les fonctionnalités de Together Designer, si vous disposez également d une licence pour Designer. Toutes les descriptions des fonctionnalités soumises à cette condition sont signalées par des notes spéciales en rouge. Documentation La documentation de Together inclut : Elément Description Emplacement Aide en ligne (Guide de l utilisateur) Prise en main Informations complètes particulièrement adaptées à l utilisateur, comprenant : Visite d introduction à Together Définition des préférences personnelles et des options Des instructions détaillées pour l utilisation des fonctionnalités de Together Des informations de référence sur les commandes, les macros et les raccourcis clavier Présentation de la modélisation avec Together ; descriptions de l utilisation de projets exemple. Readme.html Informations de dernière minute, comprenant : Notes de licence Configuration système nécessaire Installation et démarrage de Together Problèmes connus Les correctifs importants Dossier /doc sous l installation de Together $TGH$/getting_started.pdf $TGH$/readme/ readme.html Pour en savoir plus sur les produits Together et les mises à jour à venir, consultez le site Together community et la Documentation Together de Borland. 2 Guide de l utilisateur de Borland Together Developer 2005
Conventions Obtention et utilisation de l aide Les rubriques et astuces d aide fournies avec Together vous aident à accomplir vos tâches. Pour obtenir de l assistance pendant votre travail, procédez comme suit : Pour voir une description du rôle joué par un élément d une boîte de dialogue ouverte, appuyez sur F1 ou cliquez sur Aide. Pour ouvrir des rubriques d aide dans Together, cliquez sur Rubriques d aide dans le menu Aide ou cliquez sur dans la barre d outils. Pour rechercher des rubriques, des mots ou des phrases spécifiques, utilisez l onglet Index ou Recherche. Pour plus d informations sur l utilisation de l aide, consultez la rubrique Utilisation de l aide en ligne que vous pouvez ouvrir en sélectionnant Comment utiliser l aide dans le menu Aide du visualiseur d aide. Conventions La documentation Together suit les conventions suivantes : Elément $TGH$ Répertoire home de l utilisateur Séparateur dans les procédures Description Le répertoire d installation de Together. L emplacement du répertoire de base dépend de la plate-forme : Pour UNIX et Linux, le répertoire de base peut varier. Par exemple, il peut s agir de /user/<nomutilisateur> ou /home/<nomutilisateur> Pour Windows NT, le répertoire de base est C:\Winnt\Profiles\ <nomutilisateur> Pour Windows 2000, 2003 et XP, le répertoire de base est C:\Documents and Settings\<nomutilisateur> : dans la documentation Together, ce symbole sert à séparer les étapes d une procédure. Borland Together Developer 2005 3
4 Guide de l utilisateur de Borland Together Developer 2005
Chapitre 1 1Visite de Together Chapitre Avant de commencer à travailler, familiarisez-vous avec les composants de Together. Visitez les fenêtres, volets et menus de Together et apprenez à ancrer, désancrer, redimensionner ou réduire en icône les composants de Together. Avec les divers arrangements de ces composants, vous créez des espaces de travail mieux adaptés à certains projets et tâches. Avec la boîte de dialogue Préférences, apprenez à configurer l environnement de Together selon vos besoins. Rubriques de cette section : Composants de l interface utilisateur de Together Gestion des espaces de travail Préférences de configuration Composants de l interface utilisateur de Together La fenêtre principale réunit un ensemble de composants importants : Menus et barre d outils de Together Volets de Together Volets de navigation : Navigateur de modèle Navigateur de favoris Navigateur de diagrammes Volet Projet Volet contenu Editeur de diagramme Inspecteur Volet Messages Chapitre 1 : Visite de Together 5
Composants de l interface utilisateur de Together Les éléments de modélisation de Together sont des composants individuels du projet et de l interface utilisateur. Les éléments peuvent être des diagrammes, des fichiers, des éléments de diagrammes comme les nœuds ou les liens, des noms, des messages d erreur, etc. Un clic droit sur un élément de Together affiche un menu de commandes pour cet élément. Les menus contextuels varient en fonction du type d élément. Menus et barre d outils Le menu principal et la barre d outils se trouvent en haut de la fenêtre principale. Le menu principal se compose d un ensemble de menus dont la liste dépend de l espace de travail, de l état et des options du projet ouvert et de l élément sélectionné. Les commandes sont, pour la plupart, dupliquées dans les menus contextuels des éléments et dans la barre d outils principale située sous le menu principal. Les boutons et commandes non disponibles sont grisés dans la barre d outils et les menus. La barre d outils principale se compose de plusieurs barres d outils différentes selon les groupes de fonctions proposés. Il est possible d afficher ou de masquer des barres d outils individuelles pour accélérer l accès aux contrôles ou libérer de la place. Chaque bouton de la barre d outils principale s accompagne d une info-bulle qui s affiche lorsque vous passez le pointeur de la souris dessus. Pour afficher ou masquer des barres d outils : 1 Dans le menu principal, choisissez Voir Barres d outils ou cliquez avec le bouton droit sur la barre d outils principale pour afficher son menu contextuel. 2 Dans le sous-menu, cochez les cases des barres d outils à afficher et désactivez les autres. Pour afficher ou masquer la barre d outils principale en entier : 1 Dans le menu principal, choisissez Voir Barres d outils ou cliquez avec le bouton droit sur la barre d outils principale pour afficher son menu contextuel. 2 Choisissez Tout afficher (ou Tout cacher). De nombreuses commandes peuvent être exécutées sans passer par les contrôles de l interface utilisateur. Vous pouvez utiliser les raccourcis clavier. Les combinaisons de touches qui y correspondent sont spécifiées dans le menu principal. Vous trouverez la liste complète des raccourcis clavier disponibles dans l Annexe A, Raccourcis clavier. Volets de Together Chaque volet contient une barre de titre. Dans le menu contextuel de la barre de titre, des commandes permettent de fermer, redimensionner et ancrer/désancrer le volet, ou encore de le réduire en icône. Outre les commandes de la barre de titre, vous pouvez utiliser le glisser-déposer. Le volet focalisation, avec la barre de titre en bleu clair, est le site de l activité la plus récente. Vous pouvez réorganiser le fenêtrage et la disposition des volets. Vous pouvez masquer des volets, les redimensionner, les afficher en plein écran ou en icône, les déplacer ou les désancrer dans la fenêtre principale. 6 Guide de l utilisateur de Borland Together Developer 2005
Composants de l interface utilisateur de Together Astuce Affichage ou masquage des volets Pour afficher ou cacher un volet : 1 Dans le menu principal, choisissez Voir Volets. 2 Dans le sous-menu, cochez les options des volets à afficher et désactivez les options des volets à masquer. Utilisez les raccourcis clavier du volet. Les raccourcis clavier des divers volets sont présentés dans le menu en cascade Voir Volets. Redimensionnement ou agrandissement des volets en plein écran Pour redimensionner des volets ancrés, faites glisser leurs barres de séparation. Pour sélectionner la barre de séparation souhaitée, vous avez le choix entre : Déplacer le pointeur de la souris au-dessus de la barre jusqu à ce qu il prenne la forme d une flèche double. Utiliser la commande Voir Diviseur de navigateur du menu principal, puis choisir la barre dans la liste déroulante. Pour redimensionner des volets désancrés, faites glisser leurs bords ou leurs coins jusqu à obtenir la forme souhaitée. Pour qu un volet ancré s affiche en plein écran, vous avez le choix entre : Sélectionner Agrandir dans le menu contextuel de sa barre de titre Double-cliquer sur la barre de titre. Un volet désancré ne peut pas être affiché en plein écran. Répétez une des actions ci-dessus pour revenir à l état précédent du volet. Ancrage, désancrage, déplacement et mise en icône de volets Pour désancrer un volet, effectuez l une des opérations suivantes : Dans le menu contextuel de la barre de titre, choisissez Désancrer Faites glisser la barre de titre et déposez-la lorsque le pointeur de la souris prend la forme d un rectangle blanc. Pour ancrer un volet, effectuez l une des opérations suivantes : Dans le menu contextuel de la barre de titre, choisissez Ancrer Cliquez sur le bouton en forme d épingle dans la barre de titre. Astuce Quand vous ancrez un volet, Together met en évidence la nouvelle position du volet à l aide d un rectangle ombré gris. Pour mettre un volet en icône, effectuez l une des opérations suivantes : Dans le menu contextuel de la barre de titre, choisissez Mettre en icône Cliquez sur le bouton de mise en icône dans la barre de titre. Astuce Utilisez la commande Actions de la fenêtre du menu principal Voir pour ouvrir le menu contextuel de la barre de titre de la fenêtre active. Utilisez la barre de titre pour déplacer des volets ancrés vers l emplacement voulu. Vous pouvez organiser les volets de manière à choisir pour la fenêtre principale la présentation qui vous met la plus à l aise. Dans cette organisation est compris un espace de travail. Lorsque vous faites glisser un volet au-dessus des différentes parties de la fenêtre principale, remarquez la forme du pointeur de la souris. Elle change suivant l emplacement auquel le volet sera ancré. Par exemple, une flèche noire indique qu un volet sera ancré dans une vue séparée. Son emplacement futur est indiqué par un Chapitre 1 : Visite de Together 7
Composants de l interface utilisateur de Together rectangle gris. Une pile indique qu il s ancrera en haut d une vue en tant que page à onglets. Un rectangle blanc indique que le volet sera désancré. Le tableau suivant montre les formes que prend le pointeur et les emplacements cible correspondants des composants : Curseur Résultat d un glisser-déposer Impossible de déposer le composant. Une fois déposé, le composant s ancre à l emplacement marqué par une ombre grise. Les composants permutent Le composant s ancre en haut d une pile de pages à onglets. Le composant se désancre. Volets de navigation Les navigateurs de modèle, de diagrammes et de favoris proposent un moyen pratique de visualiser et d organiser les modèles. Ces trois volets ont des boutons de barre d outils similaires qui autorisent les actions suivantes : Fermer le projet en cours Actualiser la vue Sélectionner l un des projets ouverts dans la boîte liste du sélecteur de projet Utilisez la fonction de recherche rapide pour trouver rapidement l emplacement souhaité dans le modèle. Pour ce faire, commencez à saisir le nom recherché et la mise en surbrillance se déplace dans l arborescence. Pour de plus amples informations, voir la section Recherche rapide, page 64. Cette fonctionnalité est également disponible dans la vue projet et dans l éditeur de diagramme. Les volets de navigation sont configurables aux niveaux global, projet par défaut et projet en cours. Vous pouvez configurer le format d affichage des noms, le comportement des nœuds développables, etc. en changeant les préférences de modélisation. Dans les volets de navigation, vous pouvez trier les différents types d éléments par nom, par type ou par modificateur. Pour trier les éléments dans les volets de navigation : 1 Depuis le menu principal, choisissez Projet Propriétés du projet. 2 Sous la catégorie Modélisation, sélectionnez Navigateurs. 3 Dans la section Tri, cochez l option Trier les éléments. 4 Spécifiez les options de tri pour les classes, les méthodes et les attributs. 5 Si vous souhaitez afficher les packages en haut de la vue arborescente, cochez l option Afficher d abord les nœuds de package. 6 Cliquez sur OK pour appliquer les modifications. Les menus contextuels des volets de navigation contiennent des commandes spécifiques aux types de vues et de nœuds. En utilisant les menus contextuels, vous pouvez ouvrir des diagrammes, atteindre des éléments dans l éditeur de diagramme, créer, renommer ou supprimer des diagrammes, des éléments et des raccourcis, lier des diagrammes à des éléments, appliquer des patterns, etc. Pour une description détaillée de ces fonctionnalités, voir Chapitre 3, Utilisation des diagrammes. 8 Guide de l utilisateur de Borland Together Developer 2005
Composants de l interface utilisateur de Together Examinez les menus contextuels par vous-même pour connaître les commandes disponibles. Navigateur de modèle Le Navigateur de modèle affiche une vue logique des éléments qui constituent le modèle du projet. Il affiche les packages de niveau racine de votre projet, vous permettant de naviguer de manière logique parmi le contenu pour voir les sous-packages, les diagrammes et les éléments de diagrammes dans chacun d eux. Utilisez le menu contextuel pour ouvrir des fichiers diagrammes depuis le Navigateur de modèle. Pour ouvrir le Navigateur de modèle : 1 Dans le menu principal, choisissez Voir Volets. 2 Cliquez sur la case à cocher Navigateur de modèle dans le sous-menu des vues disponibles. Dans le navigateur de modèle, vous pouvez regrouper dans le même conteneur des éléments appartenant à la même métaclasse. Cela signifie que si, par exemple, un package contient plusieurs classes, ces dernières peuvent être renvoyées dans le navigateur de modèle sous forme de groupe au lieu d apparaître chacune en tant que nœud distinct dans l arborescence. Ce comportement est contrôlé par les options de regroupement. Pour obtenir un regroupement selon une métaclasse : 1 Dans le menu principal, choisissez Outils Préférences. 2 Dans les options de Modélisation Navigateurs, cochez Regrouper les éléments par métaclasse et Replier le groupe par défaut. 3 Dans le champ Nombre minimum d éléments par groupe, spécifiez le nombre minimal d éléments d une même métaclasse à atteindre pour autoriser le regroupement. Résultat : Les éléments de la même métaclasse apparaissent dans un nœud qui peut être développé, accompagné du nom de la métaclasse. A gauche de l arborescence du modèle, une barre verticale affiche un signe plus à côté de chaque groupe réduit. Si un groupe est développé, un signe moins remplace le signe plus. Cette fonctionnalité est disponible dans le navigateur de diagramme et dans le navigateur de favoris. Navigateur de favoris Le Navigateur de favoris peut afficher les nœuds du modèle auquel vous voulez accéder sans naviguer dans la hiérarchie de projet logique du Navigateur de modèle ou d un diagramme. Ces nœuds peuvent représenter des diagrammes et leurs éléments. Le Navigateur de favoris est particulièrement utile pour les grands projets. Vous pouvez ajouter un élément aux favoris à partir de l éditeur de diagramme, ainsi qu à partir du Navigateur de modèle. Pour ouvrir le Navigateur de favoris : 1 Dans le menu principal, choisissez Voir Volets. 2 Cliquez sur la case à cocher Favoris dans le sous-menu des vues disponibles. Pour ajouter un élément aux favoris : 1 Dans le Navigateur de modèle ou l éditeur de diagramme, sélectionnez les diagrammes ou les éléments à ajouter aux favoris. 2 Effectuez un clic droit sur l élément et choisissez Ajouter aux Favoris. Chapitre 1 : Visite de Together 9
Composants de l interface utilisateur de Together Pour retirer un élément des favoris : 1 Sélectionnez un élément dans les favoris. 2 Effectuez un clic droit et choisissez Retirer des Favoris. Pour ouvrir un élément appartenant aux favoris dans l éditeur de diagramme : 1 Sélectionnez un élément dans les favoris. 2 Effectuez un clic droit et choisissez Ouvrir. Résultat : Le diagramme s ouvre dans l éditeur de diagramme et l élément référencé est en évidence. Pour rechercher un élément favori dans le navigateur de projets : 1 Sélectionnez un élément dans les favoris. 2 Effectuez un clic droit et choisissez Sélectionner dans le navigateur de projets. Résultat : Le navigateur de projets s ouvre et l élément référencé y est en évidence. Pour ajouter un favori en tant que raccourci : 1 Sélectionnez un élément dans les favoris. 2 Effectuez un clic droit et choisissez Ajouter comme raccourci. Résultat : Le raccourci vers l élément sélectionné apparaît dans le diagramme actif Remarque Navigateur de diagrammes Le Navigateur de diagrammes affiche la liste de tous les types de diagrammes logiques disponibles dans Together. Les diagrammes sont répertoriés selon leurs types. L ouverture des fichiers de diagrammes s effectue de la même manière dans le navigateur de diagrammes et dans le navigateur de modèle. Le Navigateur de diagrammes n affiche pas les diagrammes package. Ce sont des diagrammes physiques et non des diagrammes logiques. Vous pouvez développer chaque nœud de diagramme pour voir ses éléments. Les éléments des diagrammes qui ne sont pas réellement contenus dans les diagrammes apparaissent comme des raccourcis. Par exemple, si un diagramme de classes affiche les classes qui résident en dehors du package du diagramme de classes, les nœuds de ces classes ont des symboles de raccourci à la fois dans la vue arborescente et dans le diagramme. Les diagrammes de classes peuvent présenter les classes et interfaces des packages qui résident sur le chemin de classes ou sur d autres chemins définis dans les propriétés du projet. Pour ouvrir le Navigateur de diagrammes : 1 Dans le menu principal, choisissez Voir Volets. 2 Cliquez sur la case à cocher Navigateur de diagrammes dans le sous-menu des vues disponibles. Volet projet Le volet Projet montre la structure des fichiers d un projet. En utilisant le volet Projet, vous pouvez ajouter ou retirer des fichiers. Pour ouvrir le volet Projet : 1 Dans le menu principal, choisissez Voir Volets. 2 Cochez la case Projet dans le sous-menu des volets disponibles. 10 Guide de l utilisateur de Borland Together Developer 2005