Lernprogramm: JUnit-Beispielprojekt von Rational Team Concert kennenlernen

Dieser kurze Leitfaden dient als Ergänzung zum JUnit-Beispielprojekt in Rational Team Concert. Er stellt Ihnen eine allgemeine Ü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 auf dem 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-Projekt-Sprints und geplante Arbeit

    4. JUnit-Projektquellcode

    5. JUnit-Projektbuilds

    6. JUnit-Projektberichte (nur Standard Edition)

    7. JUnit-Projekt in der Webschnittstelle kennenlernen

Erforderliche Zeit

20 Minuten

1. JUnit-Beispielprojekt erstellen

Um das 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äß den 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 Aufgabenbereiche 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 Pläne konfiguriert und ist Eigner mehrerer Arbeitselemente der oberen Ebene für dieses Release.
Build build / build Benutzer mit Sonderberechtigung zur Ausführung von Builds.
Freddy Freund freddy / freddy  
Jason Mitchell jason / jason JUnit-Teammitglied. Jason sind mehrere Arbeitselemente zugeordnet.
Jennifer Ginness jennifer / jennifer  
Markus Kent markus / markus JUnit-Teammitglied. Markus sind mehrere Arbeitselemente 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 Arbeitselemente erstellen, die meisten anderen Artefakte jedoch nur anzeigen kann.

Weitere Informationen finden Sie in Rational Team Concert 2.0.0.2 - 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 Ansicht 'Teamorganisation' (Fenster > Ansicht anzeigen > Teamorganisation) mit der rechten Maustaste auf Markus Kent und klicken Sie dann auf Öffnen.
  3. Wählen Sie im Editor für Benutzer unter Clientzugriffslizenzen die Option Rational Team Concert - Developer aus und klicken Sie dann auf Speichern.

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

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

Abschnitt 'Benutzerverwaltung' der Webschnittstelle des Jazz-Team-Servers

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-Projekt-Sprints und geplante Arbeit

Das JUnit-Projekt verwendet Scrum als seinen Prozess. Scrum ist ein gängiger Ansatz für das flexible (agile) Projektmanagement. Für jede Iteration, Sprint genannt, hat das Team ein Plandokument erstellt und Arbeitselemente für diesen Sprint erstellt.

  1. Die Prozess-Sprints 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 Ansicht 'Teamartefakte'.

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

  3. Sehen Sie sich den JUnit 4.4 s2-Sprint-Rückstandsplan an. Auf der Registerkarte Geplante Elemente verfügt der Planeditor über einen Vorschaumodus für Arbeitselemente, der Ihnen einen integrierten Arbeitselementeditor bietet, um die Planung wichtiger Attribute anzuzeigen.

    JUnit 4.4 s2-Sprint-Rückstandsplan

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

    Priorität eines Arbeitselements im Planeditor ändern

  4. Wenn Sie die Details eines Arbeitselements anzeigen möchten, klicken Sie auf der Seite 'Geplante Elemente' doppelt auf das Element. Er wird in einem Editor für Arbeitselemente 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 Arbeitselement hinzuzufügen:

    Editor für Arbeitselemente mit Diskussion

4. JUnit-Projektquellcode

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

In der Ansicht '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 Ansicht 'Teamartefakte'

Im Screenshot oben hat der aktuelle Benutzer einen Repository-Arbeitsbereich mit der Bezeichnung 'JUnit' geladen. Sie können nach den Repository-Arbeitsbereichen anderer Benutzer suchen, anschließend die Repository-Arbeitsbereiche anderer Benutzer kopieren und 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 Paket-Explorer 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 die Rational Team Concert-Quellcodeverwaltung, wenn Sie weitere Informationen zu Datenströmen, Komponenten, Repository-Arbeitsbereichen und weiteren Konzepten erhalten möchten.

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

5. JUnit-Projektbuilds

Das JUnit-Projekt umfasst eine Builddefinition und eine Build-Engine. Um die JUnit-Builds kennenzulernen und mit ihnen zu experimentieren, müssen Sie mithilfe des separat installierten Build-Toolkits eine Build-Engine konfigurieren und starten.

  • Damit Sie eine Build-Engine ausführen können, muss das Toolkit für Buildsysteme von Toolkit für Buildsysteme 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 Buildsysteme zugeordnet sein.
So starten Sie eine Build-Engine 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 Build-Toolkit erfolgreich starten, befindet sich diese dann im Wartestatus. Nur Builddefinitionen, die für die Ausführung mit dieser konkreten Build-Engine definiert sind, werden unterstützt.

    Befehlsfenster mit Build-Engine, die ausgeführt wird und auf Anforderungen wartet

  3. Fordern Sie ein JUnit-Build an:

    Build anfordern

  4. Wenn das Build abgeschlossen ist, öffnen Sie die Buildergebnisse in der Ansicht 'Builds'. Zeigen Sie die Registerkarten Zusammenfassung, Kompilierung und JUnit der Buildergebnisse an, um zu verstehen, welche Art von Informationen in den Buildergebnissen angezeigt wird.
  5. Optional: Gehen Sie wie folgt vor, um einen Zeitplan zu erstellen, in dem definiert ist, dass das Build junit alle 30 Minuten automatisch ausgeführt wird.
    1. Klicken Sie in der Ansicht 'Teamartefakte' mit der rechten Maustaste auf das Build junit und klicken Sie anschließend auf Builddefinition öffnen.
    2. Klicken Sie im Editor für Builddefinitionen auf die Registerkarte Zeitplan.
    3. Wählen Sie das Kontrollkästchen Aktiviert aus.
    4. Geben Sie 30 in das Feld Fortlaufendes Intervall in Minuten ein.
    5. Klicken Sie auf Speichern.
    Registerkarte 'Zeitplan für Builddefinition'
Weitere Informationen zu Teambuilds: Weitere Informationen zu Teambuilds und zur Vorgehensweise zur Steuerung und Verwaltung von Builds finden Sie in der Hilfe im Abschnitt Builds mit Jazz Team Build durchführen. Sie können auch erste Informationen zu Ant-Build-Tasks erhalten, die Sie beim Schreiben von eigenen Build-Scripts 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 verfolgen und die JUnit-Projektbereiche und -Teams zu überwachen. Da für Berichte jedoch zusammengefasste Langzeitdaten erforderlich sind, verfügt das JUnit-Projekt nicht über Anfangsdatenpunkte 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 bereit, die für Berichte erforderlich sind. Wenn Sie Berichte für JUnit anzeigen möchten, müssen Sie im Zeitverlauf mindestens eine Momentaufnahme erstellen. Sie könnten zum Beispiel jetzt eine Momentaufnahme erstellen, anschließend einige Codeänderungen übergeben, einige Builds ausführen oder einige Arbeitselemente 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 für verschiedene Zeitpunkte in der Vergangenheit verfügen, 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

  • In der Ansicht 'Teamartefakte', unter dem JUnit-Projekt und unter dem Knoten 'Berichte':

    In der Ansicht 'Teamartefakte' geöffnete Berichte

Weitere Informationen zum Builden 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 entsprechende 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 standardmäßig wie folgt:

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

  2. Navigieren Sie durch die Webschnittstelle. Führen Sie beispielsweise die folgenden Aktionen aus:
    • Suchen Sie auf der Seite 'Arbeitselemente' nach Arbeitselementen und erstellen Sie Arbeitselemente.
    • Suchen Sie auf der Seite 'Quellcodeverwaltung' nach dem Quellcode im Repository.
    • Prüfen Sie auf der Seite 'Pläne' Projektpläne.
    • Arbeiten Sie auf der Seite 'Dashboards' mit Team- und mit persönlichen Dashboards (nur Standard Edition).
    • Zeigen Sie auf der Seite 'Builds' Builddefinitionen und -ergebnisse an und fordern Sie Builds an.
    • Zeigen Sie auf der Seite 'Berichte' den Projektstatus und den Projektfortschritt an (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 an einem Softwareentwicklungsprojekt zu erhalten.

Hinweis: Nehmen Sie die Zuordnung der Clientzugriffslizenzen zu den Beispielbenutzern zurück, wenn Sie die Arbeit am JUnit-Beispielprojekt beenden. So können die Lizenzen wieder realen Benutzern zugeordnet werden.

Feedback

War dies eine Hilfe? Sie können Ihr Feedback bei Jazz.net (Registrierung erforderlich) geben: Geben Sie Ihre Kommentare in den Foren oder senden Sie einen Bug.