Auf Arbeitselementen basierende Anforderungen migrieren

In diesem Artikel sind die erforderlichen Schritte für die Migration von auf Arbeitselementen basierenden Anforderungen aus früheren Versionen von IBM® Rational Quality Manager beschrieben. Bis Rational Quality Manager Version 3.0.1 wurden Anforderungen lokal in Rational Quality Manager oder in einem externen Anforderungsprovider wie IBM Rational RequisitePro, IBM Rational DOORS oder IBM Rational Requirements Composer verwaltet. Ab Version 3.0.1 werden Anforderungen nicht mehr lokal verwaltet. Wenn Sie ein Upgrade für Version 2 durchführen, müssen Sie Ihre lokalen, auf Arbeitselementen basierenden Anforderungen explizit in die Anwendung Requirements Management verlagern, die Sie in Version 3.0.1 zur Installation auswählen können.

Vorbereitende Schritte

Der Benutzer, der die Migration von auf Arbeitselementen basierenden Anforderungen durchführt, muss die folgenden Voraussetzungen erfüllen:

Jeder Quality-Management-Projektbereich, aus dem Sie Anforderungen migrieren möchten, muss eine Beziehung "Verwendung von" und eine Anforderungsbeziehung zu einem Requirements-Management-Projektbereich haben. Ein Requirements-Management-Projektbereich kann Beziehungen zu mehreren Quality-Management-Projektbereichen haben.

Der kombinierte Einsatz der Anwendungen Quality Management und Requirements Management macht zwei definierte Artefakttypen in Requirements Management erforderlich, den Typ Anforderung und den Typ Testplansammlung. Diese Typen werden während der Migration modifiziert. Manuelle Aktualisierungen dieser Typen können dazu führen, dass der Migrationsprozess und der nachfolgende kombinierte Einsatz fehlschlagen. Einzelheiten zur Arbeit mit Artefakttypen enthält der Artikel Artefakttyp.

Informationen zu diesem Vorgang

In der folgenden Tabelle sind die von der Migration unterstützten und nicht unterstützten Punkte aufgelistet.

Tabelle 1.
Von der Migration auf Version 3 unterstützt Nicht von der Migration auf Version 3 unterstützt
Im Anforderungstyp von Rational Quality Manager Version 2 definierte Attribute Links und Anhänge
Angepasste Attribute mit Zeichenfolgedatentyp Angepasste Attribute anderer Typen als dem Zeichenfolgedatentyp
Kommentare Prüfung (Genehmigende Person, Prüfer usw.)
Beziehung zwischen einem Testfall und einer Anforderung Abonnenten
Beziehung zwischen einem Testplan und einer Anforderung (siehe Hinweis) Verlaufsprotokoll
Anmerkung: Die migrierte Anforderung wird Teil einer Testplansammlung in der Anwendung Requirements Management. Die Testplansammlung wird mit einem Testplan verlinkt. In dieser Prozedur erstellen Sie die Testplansammlung und den Testplan.

Vorgehensweise

  1. Installieren Sie Version 3 und migrieren Sie Ihre Daten von Version 2 wie im Artikel Upgrade auf Rational Quality Manager 3.0.1 mit dem Upgrade-Script beschrieben.
  2. Führen Sie den Konfigurationsassistenten für Jazz Team Server aus und registrieren Sie die Anwendungen. Ausführliche Informationen hierzu enthält der Artikel Jazz Team Server und die erste Anwendung nach dem Upgrade konfigurieren.
  3. Erstellen Sie, sofern erforderlich, im Requirements Management Client ein Anforderungsprojekt. Verwenden Sie dazu die Basisprojektschablone. Eine Beschreibung der Vorgehensweise enthält der Artikel Anforderungsprojekte erstellen.
  4. Verlinken Sie Ihren Quality-Management-Projektbereich mit dem Requirements-Management-Projektbereich.

    Gehen Sie wie folgt vor, um die Projektbereiche zu verlinken:

    1. Konfigurieren Sie eine Freundschaftsbeziehung zwischen den beiden Projektbereichen. Einzelheiten finden Sie im Artikel Freundschaftsbeziehungen aufbauen.
    2. Fügen Sie eine Beziehung zwischen den beiden Projektbereichen hinzu. Lesen Sie hierzu den Artikel Projektbereiche erstellen.
  5. Setzen Sie Requirements Management auf den Importmodus. Dazu müssen Sie die folgende Eigenschaft in der Datei <Jazz-Installationsverzeichnis>/server/conf/rm/fronting.properties auf true setzen:
    com.ibm.rdm.fronting.server.import.mode=true

    Starten Sie nach diesem Schritt den Requirements Management Server neu.

  6. Führen Sie den Befehl repotools-jazz -refactorRequirements aus, um die Anforderungen zu migrieren. Dabei müssen die Anwendungen Quality Management und Requirements Management aktiv sein.
    Wichtig: Öffnen Sie für die Ausführung der repotools-Befehle für Version 2 und Version 3 Befehlszeilenfenster. Durch die Verwendung getrennter Befehlszeilenfenster stellen Sie sicher, dass es keine Konflikte bei den von den Versionen 2 und 3 verwendeten Umgebungsvariablen gibt.

    Dieser Befehl kann nur für jeweils ein Paar aus einem Quality-Management- und einem Requirements-Management-Projektbereich ausgeführt werden.

    Der Befehl -refactorRequirements hat viele erforderliche Argumente. Hier sehen Sie einen Beispielbefehl:

    repotools-jazz -refactorRequirements adminUserId=Administrator adminPassword=Administratorkennwort
    projectArea=QM-Projektname rmProvider=RM-Projektname rmUserId=RM-Administrator rmPassword=RM-Administratorkennwort

    Details der Befehlssyntax enthält der Artikel -refactorRequirements.

  7. Nach der Migration müssen Sie den Requirements Management Server neu starten, Schritt 5 rückgängig machen und den Importmodus inaktivieren. Setzen Sie dazu die folgende Eigenschaft in der Datei <Jazz-Installationsverzeichnis>/server/conf/rm/fronting.properties auf false:
    com.ibm.rdm.fronting.server.import.mode=false

Feedback