Tutoriel : exploration de l'exemple de projet Rational Team Concert JUnit

Ce bref manuel accompagne l'exemple de projet Rational Team Concert JUnit. Il fournit une présentation générale qui vous permet d'explorer par vous même le logiciel.
Le projet JUnit repose sur un projet de développement d'application réaliste dont l'objectif consiste à livrer JUnit Version 4.4. L'équipe utilise Rational Team Concert pour planifier, suivre, collaborer et livrer l'édition. Si l'exemple de projet JUnit est créé sur le Jazz Team Server, un artefact existant apparaît comme si l'équipe avait déjà commencé le travail.

Objectifs de l'apprentissage

La lecture de ce manuel va vous permettre d'apprendre et d'expérimenter, mais il ne vous indiquera pas la procédure à suivre pour mener à bien le projet.

    1. Création de l'exemple de projet JUnit

    2. Utilisateurs Zone de projet JUnit et licences d'accès client

    3. Sprints du projet JUnit et travail planifié

    4. Code source du projet JUnit

    5. Générations de projet JUnit

    6. Rapports du projet JUnit (édition Standard uniquement)

    7. Exploration du projet JUnit dans l'interface Web

Temps requis

20 minutes

1. Création de l'exemple de projet JUnit

Pour créer l'exemple de projet JUnit sur un Jazz Team Server, vous devez détenir les droits d'accès JazzAdmin et une licence d'accès client Developer.
Ouvrez l'assistant de configuration de l'exemple de projet Team Concert : cliquez sur Fichier > Nouveau > Exemple et suivez les indications de l'invite pour installer l'exemple de projet Team Concert

2. Utilisateurs Zone de projet JUnit et licences d'accès client

L'exemple de projet JUnit contient huit utilisateurs. Vous pouvez vous connecter au projet JUnit en tant que membre de l'équipe pour obtenir différentes perspectives sur les rôles et affectations. Toutefois, pour explorer la totalité du projet JUnit comme l'un de ces utilisateurs, vous devez détenir une licence d'accès client Developer. Le nombre de licences que vous pouvez attribuer pour cet exemple est limité par le nombre de licences restantes sur votre serveur.
Conseil : Le mot de passe initial de l'utilisateur est identique à son ID utilisateur. Par exemple, le mot de passe de Paul est "paul". Si vous prévoyez de procéder à une exploration extensive sur un serveur de test, vous pouvez modifier ces mots de passe initiaux.
Tableau 1. Utilisateurs dans la zone de projet JUnit
Utilisateur ID utilisateur / mot de passe Rôle/Description
Bill Cassavelli bill / bill Chef d'équipe JUnit. Bill est le chef de l'équipe JUnit. Il doit configurer les plans et réaliser des éléments de travail de haut niveau pour la publication de la nouvelle version.
Génération génération / génération Utilisateur spécial exécutant les générations
Freddy Freund freddy / freddy  
Jason Mitchell jason / jason Membre de l'équipe JUnit. Un certain nombre d'éléments de travail est attribué à Jason.
Jennifer Ginness jennifer / jennifer  
Markus Kent markus / markus Membre de l'équipe JUnit. Un certain nombre d'éléments de travail est attribué à Markus.
Marlene Stamp marlene / marlene  
Rick Yuen rick / rick  
Les licences d'accès client déterminent les utilisateur auxquels sont accordés les droits d'accès sur le Jazz Team Server. Le nombre de licences d'accès client disponibles dépend de l'édition du Rational Team Concert que vous utilisez. D'une manière générale, un utilisateur qui détient une licence d'accès client Developer a le droit de créer des artefacts, alors que ceux qui détiennent une licence d'accès client Contributor peuvent créer des éléments de travail, mais peut uniquement afficher la plupart des autres artefacts.

Pour plus d'informations, voir Editions et licences Rational Team Concert 2.0.0.2 et Gestion des licences d'accès client.

Pour attribuer des licences aux utilisateurs, procédez comme suit :

  1. Connectez-vous à la zone de projet JUnit en tant qu'utilisateur détenant les droits d'administrateur (ADMIN/ADMIN sur une nouvelle installation de serveur).
  2. Dans la vue Organisation de l'équipe (Fenêtre > Afficher la vue > Organisation de l'équipe), cliquez avec le bouton droit sur Markus Kent, puis cliquez sur Ouvrir.
  3. Dans l'éditeur Utilisateur, sous Licences d'accès client, sélectionnez Rational Team Concert - Développeur et cliquez sur Sauvegarder.

    Cette image illustre l'éditeur Utilisateur dont les licences d'accès client sont définies

La vue Organisation de l'équipe montre également les utilisateurs qui composent l'équipe JUnit. Pour attribuer des licences d'accès client à d'autres utilisateurs, utilisez l'interface Web du Jazz Team Server (cliquez sur Admin > Gestion des utilisateurs). Cette interface répertorie tous les utilisateurs présents sur le serveur :

section Gestion des utilisateurs de l'interface Web du Jazz Team Server

Conseil :

Pour se connecter en tant qu'utilisateur différent, modifiez les propriétés de votre connexion de référentiel et indiquez un ID utilisateur différent :

Modification des propriétés de connexion pour se connecter en tant qu'utilisateur différent

3. Sprints du projet JUnit et travail planifié

Le projet JUnit utilise Scrum comme processus. Scrum est une approche répandue qui permet de gérer les projets avec souplesse. Pour chaque itération, appelée un Sprint, l'équipe a créé un plan et défini des éléments de travail.
  1. Pour voir les Sprints du processus, ouvrez le projet JUnit dans l'éditeur de zone de projet.

    Itérations de processus JUnit

  2. Pour examiner les plans d'itération, dans la vue Artefacts de l'équipe, ouvrez un plan :

    Noeud des plans de la vue Artefacts de l'équipe affichant les plans JUnit

  3. Examinez le plan du Journal des éléments en attente du Sprint JUnit 4.4 s2. Dans l'onglet Eléments planifiés, l'éditeur de plan comporte un mode aperçu de l'élément de travail qui vous donne accès à un éditeur d'élément de travail indiquant les attributs de planification importants.

    Journal des éléments en attente du Sprint JUnit 4.4 s2

    Conseil : Dans l'éditeur de plan, vous pouvez rapidement modifier certains attributs des éléments de travail à l'aide des menus déroulants :

    Modification de la priorité d'un élément de travail dans l'éditeur de plan

  4. Pour afficher le détail d'un élément de travail, cliquez deux fois dessus dans la page Eléments planifiés. L'élément s'ouvre dans l'éditeur d'élément de travail, dans lequel vous pouvez procéder à des modifications en fonction de votre rôle et de la configuration du processus.

    Par exemple, si vous êtes connectés en tant que Markus Kent, ajoutez un commentaire à l'élément de travail dans la section Discussion :

    Editeur d'élément de travail affichant la discussion

4. Code source du projet JUnit

Le code JUnit est sous le contrôle des sources du référentiel du Jazz Team Server. Markus et les autres membres de l'équipe (auxquels sont attribuées les licences d'accès client Developer) peuvent apporter des modifications au flux.

Dans la vue Artefacts de l'équipe, vous pouvez voir que le projet JUnit contient un seul flux de contrôle des sources appelé JUnit, détenu par l'équipe JUnit. Le flux contient un seul composant, également appelé JUnit. Dans la capture d'écran ci-dessous, le composant JUnit se trouve au niveau de la version de référence initiale.

Flux, composants et espace de travail de référentiel chargé JUnit dans la vue Artefacts de l'équipe

Dans la capture d'écran ci-dessus, l'utilisateur en cours a chargé un espace de travail de référentiel appelé JUnit. Vous pouvez rechercher et charger des espaces de travail de référentiel appartenant à d'autres utilisateurs, puis les dupliquer et les charger, ou créer le vôtre.

Si un espace de travail de référentiel est chargé, vous pouvez utiliser les projets faisant partie des composants chargés dans votre environnement de développement. Le composant JUnit contient trois projets :

Projets de code source JUnit chargés et visibles dans l'explorateur de packages
Après l'exploration d'un bit, vous pouvez en savoir plus sur certains concepts et tâches de Jazz Source Control.

Lisez la section Présentation du contrôle des sources Rational Team Concert pour en savoir plus sur les flux, les composants, les espaces de travail de référentiel et d'autres concepts.

Découvrez comment modifier un fichier Java™ et publier cette modification dans la vue Modifications en attente. La meilleure pratique consiste à associer votre modification à l'élément de travail associé.
Répercussion d'un ensemble de modifications dans la vue Modifications en attente

5. Générations de projet JUnit

Le projet JUnit comprend une définition de génération et un moteur de génération. Pour explorer et essayer les générations JUnit, vous devez configurer et démarrer un moteur de générations à l'aide du kit de génération installé séparément.
  • Pour exécuter un moteur de génération, vous devez avoir installé Build System Toolkit L'outil de développement peut être installé à partir du panneau de commande d'installation ou téléchargé depuis jazz.net. S'il est installé, un dossier installdir/buildsystem s'affiche.
  • Pour cet exemple, une licence d'accès client de génération système doit être affectée à l'ID utilisateur "build".
Pour lancer un moteur de génération pour le projet JUnit, procédez comme suit :
  1. Dans une ligne de commande, naviguez vers rép_install/buildsystem/buildengine/eclipse, où rép_install est le répertorie d'installation.
  2. Entrez la commande suivante :
    jbe -repository https://localhost:9443/jazz -userId build -pass build -engineId junit -sleeptime 5
    Une fois démarré avec l'outil de développement de génération, le moteur attend l'entrée de requêtes. Seules les définitions de génération devant s'exécuter sur ce moteur de génération particulier sont prises en charge.

    Fenêtre de commande présentant un moteur de génération en cours d'exécution et en attente d'une requête

  3. Demandez une génération junit :

    Demande de génération

  4. A l'issue de la génération, ouvrez les résultats dans la vue Générations. Affichez les onglets Présentation, Compilation et JUnit du résultat de la génération pour connaître les types d'informations que vous pouvez afficher.
  5. Facultatif : Pour planifier l'exécution automatique de la génération junit toutes les 30 minutes, procédez comme suit :
    1. Dans la vue Artefacts de l'équipe, cliquez à l'aide du bouton droit de la souris sur la génération junit, puis cliquez sur Ouvrir une définition de génération.
    2. Dans l'éditeur Définition de génération, cliquez sur l'onglet Planifier.
    3. Cochez la case Activé.
    4. Dans la zone Intervalle continu en minutes, entrez 30.
    5. Cliquez sur Sauvegarder.
    Onglet Planifier de la définition de génération
Lisez la section Génération avec Jazz Team Build de l'Aide pour en savoir plus sur la génération d'équipe et sur la manière de gérer et d'administrer les générations. Vous pouvez également en savoir plus sur les tâches Ant de génération que vous pouvez utiliser lors de l'écriture de vos scripts de génération personnels.

6. Rapports du projet JUnit (édition Standard uniquement)

Si vous prévoyez d'étudier le projet JUnit en détails, vous pouvez utiliser des rapports pour surveiller et suivre la progression des zones et des équipes du projet JUnit. Toutefois, étant donné que les rapports requièrent des données historiques agrégées, le projet JUnit ne comporte pas de points de données initial pour commencer la génération des rapports.
Les rapports utilisent un entrepôt de données prenant généralement des clichés quotidiens des données de référentiel. Ces clichés donnent les points de données historiques requises pour les rapports. Si vous souhaitez afficher les rapports de JUnit, vous devez lancer un ou plusieurs clichés. Par exemple, vous pouvez prendre un cliché dès à présent, apporter quelques modification au code, exécuter des générations ou ouvrir des éléments de travail, puis prendre un autre cliché.

Pour prendre manuellement un cliché des données, procédez comme suit :

  1. Assurez-vous que l'utilisateur Markus Kent détient les droits d'accès JazzDWAdmin, puis connectez-vous à l'interface Web de Rational Team Concert sous le nom Markus.
    Remarque : Si vous donnez les droits d'accès JazzAdmin à Markus Kent, il peut lui-même s'attribuer les droits JazzDWAdmin. Sinon, vous devez vous connecter avec votre ID utilisateur pour attribuer les droits JazzDWAdmin à Markus.
  2. Ouvrez la page Rapports et cliquez sur Administrer l'entrepôt des données.
  3. Cliquez sur Mettre à jour toutes les données d'image instantanée.
Maintenant que vous disposez de plusieurs clichés représentant des points dans le temps, vous pouvez voir plus de valeurs dans les rapports que vous affichez pour le projet JUnit.
Vous pouvez exécuter des rapports à partir de deux endroits :
  • La page Rapports de l'interface Web :

    Page Rapports de l'interface Web

  • Dans la vue Artefacts de l'équipe, dans le noeud Rapports du projet JUnit :

    Rapports ouverts à partir de la vue Artefacts de l'équipe

Lisez la section Suivi de données à l'aide de rapports de l'Aide pour en savoir plus sur les fonctions de génération de rapports.

7. Exploration du projet JUnit dans l'interface Web

L'ensemble de ce manuel vous fait découvrir le client enrichi. L'interface Web de Rational Team Concert offre également un environnement enrichi dans lequel vous pouvez atteindre les mêmes objectifs de collaboration avec votre équipe.

Projet JUnit de l'interface Web

Pour explorer la zone de projet JUnit dans l'interface Web, procédez comme suit :
  1. Ouvrez un navigateur vers l'interface Web. Si vous travaillez en local, l'URL par défaut est la suivante :

    https://localhost:9443/jazz/web/projects/JUnit%20Project

  2. Naviguez dans l'interface Web. Par exemple :
    • Dans la page Eléments de travail, recherchez et créez les éléments de travail.
    • Dans la page Contrôle des sources, parcourez le code source dans le référentiel.
    • Dans la plage Plans, examinez les plans de projet.
    • Dans la page Tableaux de bord, utilisez le tableau de bord de l'équipe et le tableau de bord personnel (édition Standard uniquement).
    • Dans la page Générations, affichez les définitions et les résultats de génération, et demandez des générations.
    • Dans la page Rapports, affichez l'état et la progression du projet (édition Standard uniquement).

Récapitulatif

Dans ce mini tutoriel, vous avez appris les bases de l'exemple de projet JUnit. Le projet JUnit est un bon moyen d'explorer et d'apprendre à utiliser Rational Team Concert pour collaborer avec une équipe sur un projet de développement d'application.
A faire : Lorsque vous avez fini de travailler sur l'exemple de projet JUnit, supprimez les licences d'accès client des utilisateurs de l'exemple. Cela permet de libérer des licences et de les attribuer à de véritables utilisateurs.

Commentaire

Etes-vous satisfait ? Envoyez vos commentaires sur Jazz.net (inscription requise) : Entrez vos remarques dans les forums ou soumettez un incident