Tutoriel : Découverte du modèle de projet Rational Team Concert JUnit

Le présent document accompagne le modèle 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 est un projet de développement d'application visant à publier le logiciel JUnit version 4.4. L'équipe utilise Rational Team Concert pour planifier et suivre les travaux, collaborer et publier la nouvelle version. Quand le projet JUnit est créé sur le serveur Jazz Team, vous voyez des artefacts comme si l'équipe avait déjà commencé à travailler.

Objectifs pédagogiques

Ce document vous donnera assez d'informations pour commencer à travailler. Toutefois, il ne détaille pas individuellement les étapes du projet.

    1. Création du modèle de projet JUnit
    2. Utilisateurs de la zone de projet JUnit et licences d'accès client
    3. Travaux planifiés et itérations du projet JUnit
    4. Code source du projet JUnit
    5. Générations du 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 du modèle de projet JUnit

Pour créer le projet JUnit sur un serveur Jazz Team, vous devez détenir des droits d'accès JazzAdmin et une licence d'accès client de niveau Développeur.
Ouverture de l'assistant de configuration des modèles de projet Team Concert : Cliquez sur Fichier > Nouveau > Exemple et suivre les invites pour installer le modèle de projet Team Concert.

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

Le modèle de projet JUnit comprend huit utilisateurs. Vous pouvez vous connecter au projet JUnit comme équipier pour voir les rôles et les affectations sous différents angles. Toutefois, pour explorer tous les aspects du projet JUnit, vous devez disposer d'une licence d'accès client de type Développeur. Le nombre de licences que vous pouvez affecter pour cet exemple est limité par le nombre de licences restant sur votre serveur.
Pourquoi et quand exécuter cette tâche
Conseil : Le mot de passe initial de chaque utilisateur est identique à son ID utilisateur. Par exemple, le mot de passe de l'utilisateur Bill est "bill". Si vous désirez faire des recherches poussées sur un serveur de test, vous pouvez modifier ces mots de passe initiaux.
Tableau 1. Utilisateurs de la zone de projet JUnit
Utilisateur ID utilisateur / mot de passe Rôle / description
Bill Cassavelli bill / bill Chef de l'équipe JUnit. Bill est responsable de l'équipe du projet JUnit. Il doit configurer les plans d'itération et réaliser des éléments de travail de haut niveau pour la publication de la nouvelle version.
Génération build / build Utilisateur spécial chargé d'exécuter les générations.
Freddy Freund freddy / freddy  
Jason Mitchell jason / jason Membre de l'équipe du projet JUnit. Plusieurs éléments de travail sont attribués à Jason.
Jennifer Ginness jennifer / jennifer  
Markus Kent markus / markus Membre de l'équipe du projet JUnit. Plusieurs éléments de travail sont attribués à Markus.
Marlene Stamp marlene / marlene  
Rick Yuen rick / rick  
En savoir plus sur les licences d'accès client
Les licences d'accès client (CAL) définissent les utilisateurs qui peuvent accéder à certaines fonctions du serveur Jazz Team. Le nombre de licences d'accès client disponibles dépend de l'édition de Rational Team Concert que vous utilisez. En général, un utilisateur doté d'une licence d'accès client Développeur peut créer des artefacts et un utilisateur doté d'une licence d'accès client Contributeur peut créer des éléments de travail et voir la plupart des artefacts mais ni les modifier ni en créer.

Pour plus d'informations, reportez-vous aux documents Rational Team Concert 1.0.1 - Editions et licences et Gestion des licences d'accès client.

Pour affecter des licences aux utilisateurs :

  1. Connectez-vous à la zone du projet JUnit en tant qu'utilisateur doté de 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 d'utilisateur, sous Licences d'accès client, sélectionnez Rational Team Concert - Développeur puis cliquez sur Enregistrer.

    Editeur d'utilisateur avec licences d'accès client en cours de définition

Résultats

La vue Organisation de l'équipe ne montre que les utilisateurs membres de l'équipe JUnit. Pour affecter des licences d'accès aux autres utilisateurs, utilisez l'interface Web du serveur Jazz Team (cliquez sur Admin > Gestion des utilisateurs). Cette interface répertorie tous les utilisateurs du serveur :

Section Gestion des utilisateurs de l'interface Web du serveur Jazz Team

Conseil :

Pour vous connecter sous un autre nom d'utilisateur, modifiez les propriétés de la connexion au référentiel et indiquez un autre ID utilisateur.

Modification des propriétés de la connexion pour se connecter sous un autre nom d'utilisateur

3. Travaux planifiés et itérations du projet JUnit

Le projet JUnit applique une approche souple et itérative pour finaliser la version 4.4 du logiciel JUnit. L'équipe suit le processus Eclipse Way et a défini plusieurs itérations. Pour chaque itération, l'équipe a créé un plan et défini des éléments de travail.
  1. Pour voir les itérations du processus, ouvrez le projet JUnit dans l'éditeur de zone de projet.

    Itérations du processus JUnit

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

    Vue Artefacts de l'équipe avec le noeud des plans et les plans JUnit

  3. Examinez le plan d'itération JUnit 4.4M2. Dans l'onglet Eléments prévus, vous pouvez voir tous les éléments de travail planifiés pour cette itération.

    Conseil : Dans l'éditeur de plan, vous pouvez changer rapidement certains attributs d'élément de travail grâce aux 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, double-cliquez dessus dans la page Eléments prévus. L'élément de travail apparaît dans l'éditeur d'élément de travail et vous pouvez le modifier selon votre rôle et la configuration du processus.

    Par exemple, si vous êtes connecté sous le nom d'équipier Markus Kent, utilisez la section Discussion pour ajouter un commentaire à l'élément de travail.

    Vue de l'éditeur d'élément de travail et de la section Discussion

4. Code source du projet JUnit

Le code du projet JUnit fait l'objet d'un contrôle des sources dans le référentiel du serveur Jazz Team. Markus et d'autres équipiers (à qui vous avez affecté une licence d'accès client Développeur) peuvent publier des modifications dans le flux.
Pourquoi et quand exécuter cette tâche

Dans la vue Artefacts de l'équipe, vous pouvez voir que le projet JUnit ne comprend qu'un seul flux de contrôle des sources appelé JUnit, qui est possédé par l'équipe JUnit. Le flux ne compte qu'un seul composant, également appelé JUnit. Dans la capture d'écran suivante, le composant JUnit en est à son stade initial.

Vue Artefacts de l'équipe contenant le flux du projet JUnit, les composants et l'espace de travail du référentiel chargé

Notez également dans la capture d'écran ci-dessus que l'utilisateur a chargé un espace de travail de référentiel nommé JUnit. Vous pouvez rechercher et charger des espaces de travail de référentiel appartenant à d'autres utilisateurs ou créer le vôtre.

Quand vous chargez un espace de travail de référentiel, vous pouvez utiliser les projets qui font 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 la vue Package
En savoir plus sur le contrôle des sources Jazz
Après ces premiers pas, vous souhaiterez peut-être mieux connaître les principes du contrôle des sources de Jazz et les tâches associées.

Pour en savoir plus sur les flux, les composants, les espaces de travail des référentiels et d'autres concepts, lisez la section Présentation du contrôle des sources Jazz.

Découvrez comment modifier un fichier Java et publier cette modification dans la vue Modifications en attente. La meilleure méthode consiste à associer la modification à l'élément de travail associé.
Publication d'un ensemble d'artefacts modifiés dans la vue Modifications en attente

5. Générations du projet JUnit

Le projet JUnit contient une définition de génération et un moteur de génération. Pour étudier et utiliser les générations du projet JUnit, vous devrez configurer et démarrer un moteur de génération à l'aide du kit de génération installé séparément.
Avant de commencer
  • Pour exécuter un moteur de génération, vous devez d'abord installer Rational Team Concert Build System Toolkit. Ce kit peut s'installer depuis le panneau de commande d'installation ou être téléchargé sur le site jazz.net. S'il est installé, vous devez avoir un dossier nommé installdir/buildsystem.
  • Pour cet exemple, une licence d'accès client de génération système doit être affectée à l'ID utilisateur "build".
Pourquoi et quand exécuter cette tâche
Pour démarrer un moteur de génération pour le projet JUnit :
  1. Depuis une ligne de commande, naviguez jusqu'à l'emplacement installdir/buildsystem/buildengine/eclipse, où installdir est le répertoire 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 le kit de génération, le moteur attend l'arrivée des requêtes. Seules les définitions de génération conçues pour s'exécuter sur ce moteur sont prises en charge.

    Fenêtre de commande avec un moteur de génération actif et en attente des requêtes

  3. Demandez une génération junit :

    Requête d'une génération

  4. Une fois la génération terminée, affichez les résultats depuis la vue Générations. Dans la vue des résultats de la génération, regardez le contenu des onglets Récapitulatif, Compilation et JUnit pour voir les différents types d'informations disponibles.
Que faire ensuite
Conseil : Essayez de programmer l'exécution automatique d'une génération de junit toutes les 30 minutes. Pour cela, sélectionnez l'onglet Planification de la définition de génération (cliquez avec le bouton droit sur la génération junit dans la vue Artefacts de l'équipe puis cliquez sur Ouvrir une définition de génération).

En savoir plus sur les générations d'équipe
Pour en savoir sur les générations d'équipe et sur la gestion des générations, lisez la section de l'aide intitulée Construction avec Jazz. Vous pouvez aussi commencer à étudier les tâches de génération Ant que vous pouvez utiliser pour écrire des scripts de génération.

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

Si vous désirez étudier le projet JUnit en détails, vous pourrez utiliser des rapports pour surveiller et suivre la progression des zones et des équipes du projet JUnit. Notez toutefois que, dans la mesure où les rapports requièrent des données historiques agrégées, le projet JUnit ne contient pas de points de départ des données pour élaborer des rapports.
Pourquoi et quand exécuter cette tâche
Les rapports utilisent un entrepôt de données qui, habituellement, fait des relevés quotidiens des données des référentiels. Ces relevés fournissent les points de données historiques requis pour les rapports. Pour voir les rapports du projet JUnit, vous devrez initialiser un ou plusieurs relevés sur une période donnée. Par exemple, vous pouvez faire un relevé maintenant, puis réaliser des modifications sur le code, exécuter quelques générations ou ouvrir certains éléments de travail, puis faire un nouveau relevé.

Pour lancer manuellement un relevé des données :

  1. Assurez-vous que l'utilisateur Markus Kent a les droits d'accès JazzDWAdmin puis connectez-vous à l'interface Web de Rational Team Concert sous le nom Markus.
    Remarque : Si vous avez affecté à Markus Kent les droits d'accès JazzAdmin, il peut s'affecter lui-même les droits d'accès JazzDWAdmin. Sinon, vous devez vous connecter sous votre propre ID utilisateur puis affecter les droits d'accès JazzDWAdmin à Markus.
  2. Affichez la page Rapports puis cliquez sur Administer Data Warehouse.
  3. Cliquez sur Update All Snapshot Data.
Résultats
Lorsque vous disposerez de plusieurs relevés faits à différents moments, vous commencerez à voir plus de valeurs dans les rapports du projet JUnit.
Que faire ensuite
Vous pouvez produire des rapports à deux emplacements :
  • La page Rapports de l'interface Web :

    Page Rapports de l'interface Web

  • Noeud Rapports du projet JUnit dans la vue Artefacts de l'équipe :

    Rapports ouverts dans la vue Artefacts de l'équipe

En savoir plus sur la création et l'affichage des rapports
Pour en savoir sur les fonctions de génération de rapports, lisez la section de l'aide intitulée Suivi de données avec des rapports.

7. Exploration du projet JUnit dans l'interface Web

Nous avons essentiellement vu jusqu'ici les fonctions du programme client. L'interface Web de Rational Team Concert contient aussi un environnement sophistiqué dans lequel vous pouvez aussi collaborer avec votre équipe.
Pourquoi et quand exécuter cette tâche

Projet JUnit dans l'interface Web

Pour explorer la zone du projet JUnit dans l'interface Web :
  1. Ouvrez un navigateur pour accéder à l'interface Web. Si vous travaillez en mode local, l'adresse URL par défaut est la suivante :

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

  2. Examinez d'abord l'interface Web. Par exemple :
    • Recherchez et créez des éléments de travail dans la page Eléments de travail.
    • Parcourez le code source dans le référentiel, dans la page Contrôle des sources.
    • Consultez les plans du projet dans la page Plans d'itération.
    • Utilisez votre tableau de bord et celui de l'équipe dans la page Tableaux de bord (édition Standard uniquement).
    • Regardez le statut et la progression du projet dans la page Rapports (édition Standard uniquement).

Récapitulatif

Ce tutoriel vous a expliqué les concepts de base du modèle de projet JUnit. Le modèle de projet JUnit vous apprend comment explorer et utiliser Rational Team Concert pour collaborer avec une équipe sur un projet de développement d'application.
A faire : Une fois votre étude du projet JUnit terminée, retirez les licences d'accès client affectées aux utilisateurs de cet exemple. Les licences libérées pourront alors être affectées à des utilisateurs réels.
Pour plus d'informations, consultez les rubriques d'initiation suivantes :
Commentaires