Lernprogramm: Das JUnit-Beispielprojekt von Rational Team Concert kennenlernen

Dieser kurze Leitfaden dient als Begleiter für das JUnit-Beispielprojekt in Rational Team Concert. Er stellt Ihnen auf hoher Ebene eine Übersicht zur Verfügung, sodass Sie das Beispiel eigenständig kennenlernen können.
Das JUnit-Projekt basiert auf einem realistischen Softwareentwicklungsprojekt, dessen Ziel die Bereitstellung von JUnit 4.4 ist. Das Team verwendet Rational Team Concert für das Planen, Verfolgen, Zusammenarbeiten und Übergeben des Release. Wenn das JUnit-Beispielprojekt in Jazz-Team-Server erstellt wird, werden vorhandene Artefakte so angezeigt, als hätte das Team bereits mit der Arbeit begonnen.

Lernziele

Wenn Sie diesen Leitfaden lesen, sollten Sie dabei ausreichend Kenntnisse erlangen, um mit dem Experimentieren und weiteren Lernen beginnen zu können, Sie werden jedoch nicht Schritt für Schritt durch das Projekt geführt.

    1. JUnit-Beispielprojekt erstellen
    2. JUnit-Projektbereichsbenutzer und Clientzugriffslizenzen
    3. JUnit-Projektiterationen und geplante Arbeit
    4. JUnit-Projektquellcode
    5. JUnit-Projekterstellungen
    6. JUnit-Projektberichte (nur Standard Edition)
    7. JUnit-Projekt in der Webschnittstelle kennenlernen

Erforderliche Zeit

20 Minuten

1. JUnit-Beispielprojekt erstellen

Um ein JUnit-Beispielprojekt auf einem Jazz-Team-Server erstellen zu können, müssen Sie über Berechtigungen des Typs 'JazzAdmin' verfügen und es muss Ihnen eine Clientzugriffslizenz für Entwickler zugeordnet sein.
Öffnen Sie den Installationsassistenten für das Team Concert-Beispielprojekt: Klicken Sie auf Datei > Neu > Beispiel und gehen Sie gemäß der Eingabeaufforderungen zur Installation des Team Concert-Beispielprojekts vor.

2. JUnit-Projektbereichsbenutzer und Clientzugriffslizenzen

Das JUnit-Beispielprojekt besteht aus acht Benutzern. Sie können sich als eines dieser Teammitglieder anmelden, um unterschiedliche Perspektiven in Bezug auf Aufgabenbereich und Zuordnungen zu erhalten. Damit der Benutzer das JUnit-Projekt jedoch vollständig als einer dieser Benutzer kennenlernen kann, muss dem Benutzer eine Clientzugriffslizenz für Entwickler zugeordnet sein. Die Anzahl der Lizenzen, die Sie für dieses Beispiel zuordnen können, ist durch die Anzahl der Lizenzen begrenzt, die auf dem Server vorhanden sind.
Tipp: Das Anfangskennwort jedes Benutzers ist mit seiner Benutzer-ID identisch. Das Kennwort von Bill ist zum Beispiel "bill". Wenn Sie beabsichtigen, auf einem Testserver umfassende Untersuchungen durchzuführen, kann es sinnvoll sein, diese Anfangskennwörter zu ändern.
Tabelle 1. Benutzer im JUnit-Projektbereich
Benutzer Benutzer-ID / Kennwort Aufgabenbereich/Beschreibung
Bill Cassavelli bill / bill JUnit-Teamleiter. Bill ist der Komponentenleiter für das JUnit-Team. Er hat die Iterationspläne konfiguriert und ist Eigner mehrerer Arbeitsschritte der oberen Ebene für dieses Release.
Build build / build Benutzer mit Sonderberechtigung zur Ausführung von Erstellungen
Freddy Freund freddy / freddy  
Jason Mitchell jason / jason JUnit-Teammitglied. Jason sind mehrere Arbeitsschritte zugeordnet.
Jennifer Ginness jennifer / jennifer  
Markus Kent markus / markus JUnit-Teammitglied. Markus sind mehrere Arbeitsschritte zugeordnet.
Marlene Stamp marlene / marlene  
Rick Yuen rick / rick  
Weitere Informationen zu Clientzugriffslizenzen
Clientzugriffslizenzen steuern, welche Benutzer Zugriff auf bestimmte Features auf dem Jazz-Team-Server erhalten. Die Anzahl der verfügbaren Clientzugriffslizenzen hängt von der Edition von Rational Team Concert ab, die Sie verwenden. Im Allgemeinen verfügt ein Benutzer, der eine Clientzugriffslizenz für Entwickler besitzt, über die Berechtigung zur Erstellung von Artefakten, während ein Benutzer mit einer Clientzugriffslizenz für Kontributoren zwar Arbeitsschritte erstellen, die meisten anderen Artefakte jedoch nur anzeigen kann.

Weitere Informationen hierzu finden Sie unter Rational Team Concert 1.0.1 - Editionen und Lizenzen und Clientzugriffslizenzen verwalten.

So ordnen Sie Benutzern Lizenzen zu:

  1. Melden Sie sich am JUnit-Projektbereich als Benutzer an, der über Administratorrechte verfügt (ADMIN/ADMIN bei einer neuen Serverinstallation).
  2. Klicken Sie in der Sicht 'Teamorganisation' (Fenster > Sicht anzeigen > Teamorganisation) mit der rechten Maustaste auf Markus Kent und klicken Sie auf Öffnen.
  3. Wählen Sie im Editor für Benutzer unter Clientzugriffslizenzen die Option Rational Team Concert - Developer aus und klicken sie auf Speichern.

    In dieser Grafik wird der Editor für Benutzer mit den definierten Clientzugriffslizenzen angezeigt

In der Sicht Teamorganisation werden nur die Benutzer angezeigt, die Mitglied des JUnit-Teams sind. Verwenden Sie zum Zuordnen der Clientzugriffslizenzen für weitere Benutzer die Webschnittstelle von Jazz-Team-Server (klicken sie auf Verwaltung > Benutzerverwaltung). In dieser Schnittstelle werden alle Benutzer auf dem Server aufgelistet:

Abschnitt 'Benutzerverwaltung' der Webschnittstelle von Jazz-Team-Server

Tipp:

Um sich als anderer Benutzer anmelden zu können, ändern Sie die Eigenschaften Ihrer Repository-Verbindung und geben eine andere Benutzer-ID an:

Verbindungseigenschaften für Anmeldung als anderer Benutzer ändern

3. JUnit-Projektiterationen und geplante Arbeit

Das JUnit-Projekt ist ein dynamischer iterativer Ansatz zur Fertigstellung des Release 4.4 von JUnit. Das Team orientiert sich am Eclipse-Prozess und hat einige Iterationen definiert. Für jede Iteration hat das Team ein Plandokument erstellt und Arbeitsschritte für diese Iteration erstellt.
  1. Die Prozessiterationen werden angezeigt, wenn Sie das JUnit-Projekt im Editor für den Projektbereich öffnen:

    JUnit-Prozessiterationen

  2. Öffnen Sie zum Kennenlernen der Iterationspläne einen Plan in der Sicht 'Teamartefakte'.

    Knoten 'Pläne' in der Sicht 'Teamartefakte' und den JUnit-Plänen

  3. Sehen Sie sich den JUnit 4.4M2-Iterationsplan an. In der Registerkarte Geplante Schritte werden alle Arbeitsschritte angezeigt, die für diese Iteration geplant sind.

    Tipp: Im Editor für die Pläne können Sie mithilfe der Dropdown-Menüs schnell bestimmte Attribute der Arbeitsschritte ändern:

    Priorität eines Arbeitsschritts im Planeditor ändern

  4. Wenn Sie die Details eines Arbeitsschritts anzeigen möchten, klicken Sie auf der Seite Geplante Schritte doppelt auf den Schritt. Er wird in einem Editor für Arbeitsschritte geöffnet, in dem Sie abhängig von Ihrem Aufgabenbereich und der Prozesskonfiguration Änderungen vornehmen können.

    Versuchen Sie, wenn Sie zum Beispiel als das JUnit-Teammitglied Markus Kent angemeldet sind, mithilfe des Abschnitts Diskussion einen Kommentar zum Arbeitsschritt hinzuzufügen:

    Editor für Arbeitsschritte mit Diskussion

4. JUnit-Projektquellcode

Der JUnit-Code befindet sich unter der Quellcodeverwaltung im Repository von Jazz-Team-Server. Markus und andere Teammitglieder (denen Sie die Clientzugriffslizenz für Entwickler zugeordnet haben) können Änderungen an den Datenstrom übergeben.

In der Sicht Teamartefakte können Sie feststellen, dass das JUnit-Projekt einen einzelnen Datenstrom für die Quellcodeverwaltung mit der Bezeichnung 'JUnit' umfasst, dessen Eigner das JUnit-Team ist. Der Datenstrom besteht aus einer einzelnen Komponente mit der Bezeichnung 'JUnit'. Im folgenden Screenshot befindet sich die Komponente 'JUnit' auf dem ersten Ausgangsniveau.

JUnit-Datenströme, JUnit-Komponenten und geladene Repository-Arbeitsbereiche in der Sicht 'Teamartefakte'

Aus dem obigen Screenshot geht auch hervor, dass der aktuelle Benutzer einen Repository-Arbeitsbereich mit der Bezeichnung 'JUnit' geladen hat. Sie können nach den Repository-Arbeitsbereichen anderer Benutzer suchen, die Repository-Arbeitsbereich anderer Benutzer laden oder einen eigenen Repository-Arbeitsbereich erstellen.

Wenn ein Repository-Arbeitsbereich geladen ist, stehen Ihnen die Projekte, die Bestandteil der geladenen Komponenten sind, für die Arbeit in Ihrer Entwicklungsumgebung zur Verfügung. In der Komponente 'JUnit' gibt es drei Projekte:

Die JUnit-Quellcodeprojekte, die geladen und im Paketexplorer sichtbar sind
Weitere Informationen zur Jazz-Quellcodeverwaltung
Nachdem Sie einen ersten Teil kennengelernt haben, sind für Sie möglicherweise weitere Konzepte und Tasks der Jazz-Quellcodeverwaltung von Interesse.

Lesen Sie den Abschnitt Übersicht über Jazz-Quellcodeverwaltung, wenn Sie weitere Informationen zu Datenströmen, Komponenten, Repository-Arbeitsbereichen und weiteren Begriffen erhalten möchten.

Experimentieren Sie durch Ändern der Java-Datei und Übergeben der Änderung in der Sicht 'Anstehende Änderungen'. Die empfohlene Methode ist die Zuordnung der Änderung zum zugehörigen Arbeitsschritt.
Bereitstellung eines Änderungssets in der Sicht 'Anstehende Änderungen'

5. JUnit-Projekterstellungen

Das JUnit-Projekt umfasst eine Erstellungsdefinition und eine Erstellungsengine. Um die JUnit-Erstellungen kennenzulernen und mit ihnen zu experimentieren, müssen Sie mithilfe des separat installierten Erstellungstoolkits eine Erstellungsengine konfigurieren und starten.
  • Damit Sie eine Erstellungsengine ausführen können, muss das Toolkit für Erstellungssysteme von Rational Team Concert installiert sein. Das Toolkit kann im Installationsassistenten installiert oder von jazz.net heruntergeladen werden. Wenn es installiert ist, verfügen Sie über den Ordner 'installdir/buildsystem'.
  • In diesem JUnit-Beispiel muss der Benutzer-ID "build" eine Clientzugriffslizenz für Erstellungssysteme zugeordnet sein.
So starten Sie eine Erstellungsengine für das JUnit-Projekt:
  1. Navigieren Sie in einer Befehlszeile zu 'installdir/buildsystem/buildengine/eclipse', wobei 'installdir' das Installationsverzeichnis ist.
  2. Geben Sie den folgenden Befehl ein: 
    jbe -repository https://localhost:9443/jazz -userId build -pass build -engineId junit -sleeptime 5
    Wenn Sie die Engine mit dem Erstellungstoolkit erfolgreich starten, befindet sich diese dann im Wartestatus. Nur Erstellungsdefinitionen, die für die Ausführung mit dieser konkreten Erstellungsengine definiert sind, werden unterstützt.

    Befehlsfenster mit Erstellungsengine, die ausgeführt wird und auf Anforderungen wartet

  3. Fordern Sie eine JUnit-Erstellung an:

    Erstellung anfordern

  4. Wenn die Erstellung ausgeführt ist, öffnen Sie die Erstellungsergebnisse in der Sicht Erstellungen. Sehen Sie sich die Registerkarten Zusammenfassung, Kompilierung und JUnit der Erstellungsergebnisse an, um einen Eindruck von der Art der Informationen zu erhalten, die als Erstellungsergebnisse angezeigt werden.
Tipp: Versuchen Sie, einen Zeitplan zu erstellen, in dem definiert ist, dass die Erstellung junit automatisch in Abständen von 30 Minuten ausgeführt wird. Bearbeiten Sie hierzu die Registerkarte Zeitplan der Erstellungsdefinition (klicken Sie mit der rechten Maustaste auf die Erstellung junit in der Sicht 'Teamartefakte' und klicken Sie auf Erstellungsdefinition öffnen).

Weitere Informationen zu Teamerstellungen
Weitere Informationen zu Teamerstellungen und zur Vorgehensweise zur Steuerung und Verwaltung von Erstellungen finden Sie in der Hilfe im Abschnitt Erstellung mit Jazz. Sie können auch erste Informationen zu Ant-Erstellungstasks erhalten, die Sie beim Schreiben von eigenen Erstellungsscripts verwenden können.

6. JUnit-Projektberichte (nur Standard Edition)

Wenn Sie beabsichtigen, ein JUnit-Projekt ausführlicher kennenzulernen, können Sie hierzu Berichte verwenden, um den Fortschritt zu überwachen und die JUnit-Projektbereiche und -Teams zu überwachen. Da für Berichte jedoch zusammengefasste Langzeitdaten erforderlich sind, verfügt das JUnit-Projekt nicht über Anfangspunktdaten zum Starten der Berichtserstellung.
Von Berichten wird ein Data-Warehouse verwendet, von dem in der Regel täglich Momentaufnahmen der Repository-Daten gespeichert werden. Diese Momentaufnahmen stellen die Langzeitdatenpunkte dar, die für Berichte erforderlich sind. Wenn Sie Berichte für JUnit anzeigen möchten, müssen Sie im Lauf der Zeit mindestens eine Momentaufnahme erstellen. Sie könnten zum Beispiel jetzt eine Momentaufnahme erstellen, anschließend einige Codeänderungen übergeben, einige Erstellungen ausführen oder einige Arbeitsschritte ausführen und anschließend eine weitere Momentaufnahme erstellen.

So erstellen Sie eine Momentaufnahme der Daten manuell:

  1. Stellen Sie sicher, dass Markus Kent über die Berechtigung JazzDWAdmin verfügt und melden Sie sich anschließend an der Webschnittstelle von Rational Team Concert als Markus an.
    Anmerkung: Wenn Sie Markus Kent die Berechtigung JazzAdmin zugeordnet haben, kann er sich die Berechtigung JazzDWAdmin selbst zuordnen. Andernfalls müssen Sie sich mit Ihrer eigenen Benutzer-ID anmelden, um Markus die Berechtigung JazzDWAdmin zuzuordnen.
  2. Wechseln Sie zur Seite Berichte und klicken Sie auf Data-Warehouse verwalten.
  3. Klicken Sie auf Alle Momentaufnahmedaten aktualisieren.
Wenn Sie über mehrere Momentaufnahmen verfügen, die Datenpunkte in der Vergangenheit darstellen, werden in den Berichten für das JUnit-Projekt mehr Werte angezeigt.
Sie können die Berichte an zwei Stellen ausführen:
  • Auf der Seite Berichte der Webschnittstelle:

    Seite 'Berichte' der Webschnittstelle

  • Auf dem Knoten Berichte unter dem JUnit-Projekt in der Sicht Teamartefakte:

    In der Sicht 'Teamartefakte' geöffnete Berichte

Weitere Informationen zum Erstellen und Anzeigen von Berichten
Weitere Informationen zu den Berichtsfeatures finden Sie in der Hilfe im Abschnitt Daten mit Berichten protokollieren.

7. JUnit-Projekt in der Webschnittstelle kennenlernen

In diesem Leitfaden wurde bisher meistens der Rich Client erläutert. Von der Webschnittstelle von Rational Team Concert wird auch eine vielfältige Umgebung bereitgestellt, in der Sie viele derselben Ziele in Bezug auf die Zusammenarbeit mit Ihrem Team erreichen können.

JUnit-Projekt in der Webschnittstelle

So lernen Sie den JUnit-Projektbereich in der Webschnittstelle kennen:
  1. Öffnen Sie Die Webschnittstelle in einem Browser. Wenn die Ausführung lokal erfolgt, lautet die URL folgendermaßen:

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

  2. Sehen Sie sich die Webschnittstelle an. Beispiele:
    • Arbeitsschritte auf der Seite Arbeitsschritte suchen und erstellen
    • Im Quellcode im Repository auf der Seite Quellcodeverwaltung blättern
    • Projektpläne auf der Seite Iterationspläne lesen
    • Mit Teamdashboards und persönlichen Dashboards auf der Seite Dashboards arbeiten (nur Standard Edition)
    • Projektstatus und Fortschritt auf der Seite Berichte anzeigen (nur Standard Edition)

Zusammenfassung

In diesem kleinen Lernprogramm haben Sie die Grundlagen des JUnit-Beispielprojekts kennengelernt. Das JUnit-Projekt ist ein guter Einstieg, um Rational Team Concert kennenzulernen und erste Einblicke in die Verwendung des Produkts zur Zusammenarbeit mit einem Team in einem Softwareentwicklungsprojekt zu erhalten.
Hinweis: Nehmen Sie die Zuordnung der Clientzugriffslizenzen zu Beispielbenutzern zurück, wenn Sie die Arbeit am JUnit-Beispielprojekt beenden. So können die Lizenzen wieder realen Benutzern zugeordnet werden.
Weitere hilfreiche Verweise finden Sie in den folgenden Einführungsthemen:
Feedback