Freigeben über

Exemplarische Vorgehensweise: Migrieren von ClearQuest-Arbeitsaufgaben zu Team Foundation

  • Artikel

Aktualisiert: November 2007

In dieser exemplarischen Vorgehensweise wird das Verschieben von ClearQuest-Arbeitsaufgaben zu Arbeitsaufgabenverfolgung in Team Foundation erläutert. Team Foundation enthält das Konvertierungsdienstprogramm CQConverter.exe, mit dem Sie diese Migration durchführen können.

Im Verlauf dieser exemplarischen Vorgehensweise führen Sie folgende Aufgaben aus:

  • Konfigurieren des Migrationsprozesses   Bearbeiten Sie die Konfigurationsdateien zum Steuern des Migrationsprozesses.

  • Analysieren der ClearQuest-Datenbank   Führen Sie das ClearQuest-Konvertierungsdienstprogramm aus, um die aktuelle ClearQuest-Datenbank zu analysieren. Durch die Analyse werden ein Bericht und eine Reihe von Dateien erzeugt, die die Arbeitsaufgabentypen in ClearQuest beschreiben.

  • Definieren der Migrationszuordnung   Bearbeiten Sie die während der Analyse der ClearQuest-Datenbank generierten XML-Dateien, um den Migrationsprozess anzupassen.

  • Migrieren der ClearQuest-Datenbank zu Arbeitsaufgabenverfolgung in Team Foundation   Verwenden Sie die während der Analyse der Datenbank generierten Konfigurations- und Zuordnungsdateien zum Migrieren der Daten.

  • Überprüfen des Migrationsberichts   Untersuchen Sie die Ursache von Fehlern und Warnungen während der Migration, und überprüfen Sie den Migrationsstatus.

Vorbereitungsmaßnahmen

Um diese exemplarische Vorgehensweise auszuführen, muss die folgende Software auf dem Computer installiert sein, auf dem CQConverter.exe ausgeführt werden soll:

  • Team Explorer

  • ClearQuest, Version 2003.06.00 (eigenständiger Client)

    Hinweis:

    Die Versionen 2002.05.20 und 2003.05.00 funktionieren möglicherweise auch, wurden aber nicht getestet.

Notieren Sie in einer Liste, wie Sie die Benutzernamen in ClearQuest den von Arbeitsaufgabenverfolgung in Team Foundation verwendeten Windows-Domänennamen zuordnen möchten. Stellen Sie sicher, dass Sie auch Benutzernamen berücksichtigen, die nicht mehr verwendet werden.

Die folgenden Informationen und Kenntnisse sind hilfreich:

  • Ein grundlegendes Verständnis von XML.

  • Eine Liste der Zuordnungsweise von Arbeitsaufgabenfeldern in ClearQuest zu Arbeitsaufgabenverfolgung in Team Foundation. Berücksichtigen Sie Informationen über erforderliche Transformationen. Beispielsweise können Sie ein Zeichenfolgenfeld in ClearQuest einem Ganzzahlfeld in Arbeitsaufgabenverfolgung in Team Foundation zuordnen.

Erforderliche Berechtigungen

Um diese exemplarische Vorgehensweise ausführen zu können, müssen Sie Mitglied der Sicherheitsgruppe Dienstkonten sein. Außerdem müssen Sie entweder Mitglied der Sicherheitsgruppe Readers sein, oder die Berechtigung Arbeitsaufgaben in diesem Knoten anzeigen auf die Option Zulassen festlegen. Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen. Sie müssen zudem über die Berechtigung Administrator für die ClearQuest-Datenbank verfügen. Weitere Informationen finden Sie im ClearQuest-Administratorhandbuch.

Aufgaben zur Vorbereitung der Migration

Bevor Sie mit der Migration beginnen, müssen Sie die folgenden Aufgaben ausführen:

  • Festlegen des Zeitpunkts zum Sperren der ClearQuest-Datenbank   Sperren Sie die Datenbank, damit Benutzer während des Migrationsprozesses keine neuen Arbeitsaufgaben erstellen können. Der ClearQuest-Konverter erkennt während der Konvertierung keine Änderungen von Arbeitsaufgaben. Weitere Informationen zum Sperren der ClearQuest-Datenbank finden Sie in der ClearQuest-Dokumentation.

  • Erstellen von Visual Studio-Teamprojekten für die Problembehandlung   Erstellen Sie Teamprojekte, und legen Sie fest, welche Arbeitsaufgaben zu welchem Teamprojekt gehören. Weitere Informationen zum Erstellen von Arbeitsaufgabenverfolgung in Team Foundation-Teamprojekten finden Sie unter Exemplarische Vorgehensweise: Erstellen eines neuen Teamprojekts.

  • Hinzufügen des von Ihnen verwendeten Benutzerkontos zur Dienstkontengruppe, um das Konvertierungsprogramm auszuführen   Für das Ausführen von CQConverter sind Dienstkontenberechtigungen erforderlich. Fügen Sie der Gruppe Dienstkonten auf dem Team Foundation Server mithilfe des Dienstprogramms TFSSecurity das Benutzerkonto hinzu, unter dem das Konvertierungsprogramm ausgeführt wird. Weitere Informationen finden Sie unter Befehle des Befehlszeilendienstprogramms "TFSSecurity".

Konvertierungseinschränkungen

Machen Sie sich vor der Migration mit den Einschränkungen des ClearQuest-Konvertierungsprogramms sowie mit den möglichen Auswirkungen dieser Einschränkungen auf Benutzer in der Organisation vertraut. Weitere Informationen hierzu finden Sie unter CQConverter-Befehlszeilendienstprogramm für die ClearQuest-Datenbankmigration.

Definitionen

Die folgenden Begriffe werden in dieser exemplarischen Vorgehensweise verwendet:

  • Arbeitsaufgabentyp   Arbeitsaufgabentypen sind die grundlegenden Bausteine eines Systems zur Arbeitsaufgabenverfolgung. Beispiele für Arbeitsaufgabentypen sind Fehler, Anforderungen und Aufgaben.

  • Entitäten   Die grundlegende Dateneinheit in ClearQuest. Beispielsweise kann ein Fehler mit einem Kunden verknüpft sein und zu einem bestimmten Projekt gehören. Bei dem Fehler, dem Kunden und dem Projekt handelt es sich jeweils um Entitäten.

  • Feld   Arbeitsaufgaben enthalten Felder, die Informationen über die Arbeitsaufgabe enthalten. Beispielsweise kann eine fehlerhafte Arbeitsaufgabe die Felder Geöffnet von, Status, Auflösung, Versionsgeschichte, Links und Anlagen enthalten.

  • Zustände   Der Zustand bezeichnet die Position einer Arbeitsaufgabe in einem Prozess. Fehler können z. B. Geöffnet, Zugewiesen, Behoben oder Zurückgestellt sein.

  • Feldverhalten (Feldregeln)   Das Feldverhalten gibt an, wie sich die Felder im jeweiligen Zustand verhalten. Beispielsweise kann das Feld Behoben in beim Erstellen eines neuen Fehlers nicht bearbeitet werden. Das Feld Behoben in erfordert jedoch einen Wert, wenn Sie den Zustand des Fehlers in Behoben ändern.

Konfigurieren des Migrationsprozesses

Während der Konfiguration des Migrationsprozesses ändern Sie die Konfigurationsdateien des ClearQuest-Konvertierungsprogramms, um den Migrationsprozess zu steuern.

Die Konfigurationsdatei

Die Konfigurationsdatei ist eine XML-Datei, die Einstellungen für das ClearQuest-Konvertierungsprogramm bereitstellt. Die Einstellungen werden in den folgenden Abschnitten der XML-Datei angegeben:

<ClearQuest>

Der Abschnitt ClearQuest enthält Informationen zur ClearQuest-Datenbank, die Sie migrieren möchten.

  • ConnectionName   Der Name der ClearQuest-Verbindung.

  • UserDatabase   Der Name der ClearQuest-Benutzerdatenbank.

  • QueryName   Der Name einer in ClearQuest gespeicherten Abfrage.

  • UserID   ClearQuest-Benutzer-ID. Die angegebene Benutzer-ID muss über die Administratorberechtigung für die ClearQuest-Datenbank verfügen.

<VSTS>

Der Abschnitt VSTS enthält Informationen zum Arbeitsaufgabenverfolgung in Team Foundation-Server sowie zum Teamprojekt, die das Ziel Ihrer Migration darstellen.

  • URI   Der angezeigte Name von Team Foundation Server oder der vollständige URI. Beispielsweise "MyAtServer" oder "http://MyAtServer:8080".

  • ProjectName   Der Arbeitsaufgabenverfolgung in Team Foundation-Teamprojektname.

Andere Konfigurationseinstellungen

In den anderen Abschnitten der XML-Datei können Sie folgende Einstellungen angeben:

  • ExitOnError   Der Wert dieses Abschnitts kann entweder True oder False sein. Geben Sie True an, wenn das ClearQuest-Konvertierungsprogramm angehalten werden soll, wenn während der Migration einer Arbeitsaufgabe ein Fehler auftritt.

    Hinweis:

    Diese Einstellung gilt nur für nicht schwerwiegende Fehler. Bei schwerwiegenden Fehlern, etwa wenn das ClearQuest-Konvertierungsprogramm keine Verbindung mit ClearQuest herstellen kann, wird das Konvertierungsprogramm immer beendet. Dies ist auch dann der Fall, wenn False angegeben ist.

  • OutputDirectory   OutputDirectory gibt das Verzeichnis für die generierten Dateien an. Wenn Sie kein Ausgabeverzeichnis angeben, erstellt das Konvertierungsprogramm ein Verzeichnis mit dem Namen der Basisentität für das Generieren von Ausgabedateien. Wenn das Verzeichnis bereits vorhanden ist, überschreibt das Konvertierungsprogramm die Dateien in diesem Verzeichnis.

Erstellen der Konfigurationsdatei

Das Erstellen der Konfigurationsdatei kann in jedem Text-Editor erfolgen, z. B. in Editor.

So erstellen Sie die Konfigurationsdatei

  1. Stellen Sie sicher, dass Sie über folgende Informationen verfügen:

    • Name der ClearQuest-Verbindung

    • Name der ClearQuest-Datenbank

    • Benutzer-ID und Kennwort des ClearQuest-Administrators. Stellen Sie sicher, dass der Benutzer "Admin" über Berechtigungen für das Eingeben von Problemen in ClearQuest verfügt.

    • Name des Arbeitsaufgabenverfolgung in Team Foundation-Servers

    • Name des Arbeitsaufgabenverfolgung in Team Foundation-Teamprojekts (das Teamprojekt, zu dem Sie die Arbeitsaufgaben migrieren möchten).

  2. Erstellen Sie eine Abfrage in ClearQuest, um die Arbeitsaufgaben auszuwählen, die Sie zu Arbeitsaufgabenverfolgung in Team Foundation migrieren möchten, und speichern Sie die Abfrage. Speichern Sie die Abfrage unter einem beliebigen Namen, z. B. TransitionQuery.

  3. Legen Sie ein Verzeichnis fest, in dem die während der Analyse erzeugten Dateien gespeichert werden.

  4. Kopieren Sie die folgende XML-Konfigurationsdatei in einen Text-Editor.

    <?xml version="1.0" encoding="utf-8"?>
<WorkItemConverter>
  <Source id="ClearQuest">
    <ClearQuest>
      <ConnectionName>CQRep</ConnectionName> 
      <UserDatabase>TEST</UserDatabase> 
      <QueryName>Public Queries/All Defects</QueryName> 
      <UserID>admin</UserID>
    </ClearQuest>
  </Source>
  <VSTS>
    <URI>AdventureWorksServer</URI>
    <ProjectName>AdventureWorksProject</ProjectName> 
  </VSTS>
  <ExitOnError>true</ExitOnError>
  <OutputDirectory>DefectSchema</OutputDirectory>
</WorkItemConverter>

  5. Ändern Sie die Datei, um die Einstellungen mithilfe der zuvor gesammelten Informationen anzugeben. Geben Sie beispielsweise unter <QueryName> den Abfragenamen mit TransitionQuery an, und geben Sie außerdem den Abfragepfad ein. Weitere Informationen über die für jeden Abschnitt erforderlichen Angaben finden Sie unter "Die Konfigurationsdatei" weiter oben in diesem Dokument.

    Hinweis:

    Das Kennwort wird nicht in die Datei eingetragen, sondern vom ClearQuest-Konvertierungstool im späteren Verlauf des Migrationsprozesses angefordert.

  6. Speichern Sie die Datei.

    Beispielsweise können Sie die Datei als CqConverterConfig.xml speichern.

Analysieren der ClearQuest-Datenbank

Während der Analyse analysiert das ClearQuest-Team Foundation-Konvertierungsprogramm die ClearQuest-Datenbank und erstellt folgende XML-Dateien:

  • Eine WTID (Work Item Type Definition, Arbeitsaufgabentypdefinition)-Datei für Arbeitsaufgabenverfolgung in Team Foundation für jeden ClearQuest-Entitätstyp, der Zustand, Zustandsübergänge, Felder, Feldtypen und Feldverhalten wie erforderlich oder optional aufweist.

  • Eine Standard-Feldzuordnungsdatei, die Arbeitsaufgabenverfolgung in Team Foundation-Feldern und -Werten ClearQuest-Felder und -Werte zuordnet.

  • Eine Benutzerzuordnungsdatei, die Windows-Benutzern ClearQuest-Benutzer zuordnet. Diese Datei gilt für das gesamte System.

  • Eine Schemazuordnungsdatei, die Verweise auf andere XML-Dateien enthält, z. B. die SchemaMap-Datei mit den Entitätsnamen, sowie die Feldzuordnungsdatei, die den Pfad für die generierten WorkItem-Dateinamen und fieldMap-Dateien enthält.

  • Eine Berichts- und Warnungsdatei (CQAnalysisReport.xml).

So analysieren Sie die ClearQuest-Datenbank

  1. Führen Sie an der Visual Studio 2008-Eingabeaufforderung den folgenden Befehl aus:

    CQConverter.exe /c:analyze /m:CqConverterConfig.xml

    Das Ausführen des ClearQuest-Konvertierungsprogramms erfordert möglicherweise mehrere Minuten.

    Hinweis   Weitere Informationen über ClearQuest-Konvertierungsbefehle finden Sie unter CQConverter-Befehlszeilendienstprogramm für die ClearQuest-Datenbankmigration.

  2. Suchen Sie im Ausgabeverzeichnis, das Sie in der Konfigurationsdatei angegeben haben, nach den unten aufgeführten XML-Dateien. Diese Dateien werden später im Migrationsprozess verwendet.

    • Eine WITD-Datei für jeden ClearQuest-Entitätstyp mit dem Namen EntityName.xml. Beispielsweise würde eine Datei für die ClearQuest-Fehlerentität den Namen Defect.xml erhalten.

    • Eine Feldzuordnungsdatei für jeden ClearQuest-Entitätstyp. In diesen Dateien wird angegeben, wie die Felder und Werte in ClearQuest-Entitäten den entsprechenden Feldern in Arbeitsaufgabentypen von Arbeitsaufgabenverfolgung in Team Foundation zugeordnet werden. Beispielsweise würde eine Datei für die ClearQuest-Fehlerentität den Namen DefectFieldMap.xml erhalten.

    • Eine Benutzerzuordnungsdatei. Eine Datei, die angibt, wie Arbeitsaufgabenverfolgung in Team Foundation-Benutzern die ClearQuest-Benutzer zugeordnet werden sollen.

    • Die Datei schemamap.xml. Die Datei schemamap.xml beschreibt die Schema- und Feldzuordnungen.

  3. Suchen Sie im Verzeichnis, in dem das Konvertierungsprogramm ausgeführt wird, nach der Datei CQAnalysisReport.xml, und überprüfen Sie diese auf Warnungen und Fehler, bevor Sie die Migration durchführen.

Definieren der Migrationszuordnung

Durch die Analyse wird eine Reihe von Dateien generiert, die die Informationen aus ClearQuest-Datenbank enthalten. Wenn Sie die Datenbank wie gewünscht migrieren möchten, müssen Sie ggf. einige Dateien ändern. Sie müssen in jedem Fall die Benutzerzuordnungsdatei und die WITD-Datei ändern.

Weitere Informationen zum Ändern einer WITD-Datei finden Sie unter Exemplarische Vorgehensweise: Vornehmen von grundlegenden benutzerdefinierten Anpassungen für einen Arbeitsaufgabentyp.

Bearbeiten der Schemazuordnungsdatei

So ändern Sie die Datei schemamap.xml

  1. Öffnen Sie die Datei Schemamap.xml.

    Nachfolgend finden Sie ein Beispiel dieser Datei:

    <Mappings>
  <SchemaMaps>
    <SchemaMap SourceEntity="Defect" TargetWIT="Defect"
      WITDFile="Defect.xml" FieldMapFile="DefectFieldMap.xml"/> 
    <SchemaMap SourceEntity="Customer" TargetWIT="Customer"
      WITDFile="Customer.xml" FieldMapFile="CustomerFieldMap.xml"/> 
  </SchemaMaps>
  <UserMap File="UserMap.xml" /> 
</Mappings>

  2. Ändern Sie die Abschnitte in dieser Datei nach Bedarf.

    • SourceEntity   Vergewissern Sie sich, dass dieser Abschnitt die richtige ClearQuest-Entität enthält.

    • TargetWIT   Vergewissern Sie sich, dass dieser Abschnitt auf den richtigen Arbeitsaufgabentyp zeigt, der in Arbeitsaufgabenverfolgung in Team Foundation erstellt werden soll.

    • WITDFile   Dieser Abschnitt gibt die WITD-XML-Datei an.

    • FieldMapFile   Dieser Abschnitt gibt die XML-Datei für die Feldzuordnung an.

    • UserMap   Dieser Abschnitt gibt die XML-Datei für die Benutzerzuordnung an.

Bearbeiten der Benutzerzuordnungsdatei

Der ClearQuest-Konverter verwendet die Benutzerzuordnungsdatei, um die Benutzer-IDs in der ClearQuest-Datenbank zu den entsprechenden Arbeitsaufgabenverfolgung in Team Foundation-Benutzer-IDs zuzuordnen. Durch das Konvertieren der Feldwerte der Benutzer-ID in gültige Werte von Arbeitsaufgabenverfolgung in Team Foundation bleibt die Versionsgeschichte der Arbeitsaufgaben erhalten. Arbeitsaufgabenverfolgung in Team Foundation verwendet Windows-Domänenbenutzer-IDs.

Während der Analyse wird vom ClearQuest-Konvertierungsprogramm eine Standardversion dieser Datei generiert. Stellen Sie sicher, dass es sich um eine ordnungsgemäß generierte Datei handelt, bevor Sie die Konvertierung fortsetzen. Andernfalls wird das Konvertierungsprogamm durch Einchecken einer fehlerhaften Datei möglicherweise beendet.

So ändern Sie die Benutzerzuordnungsdatei

  1. Öffnen Sie die Datei usermap.xml. Nachfolgend finden Sie ein Beispiel:

    <UserMappings">
  <UserMap From="admin" To="admin" />
  <UserMap From="user" To="user" />
  <UserMap From="QE" To="QE" />
  <UserMap From="lead" To="lead" /> 
  <UserMap From="engineer" To="engineer" />
</UserMappings>

  2. Untersuchen Sie die Benutzerzuordnungen und nehmen Sie ggf. Korrekturen, Hinzufügungen und Löschungen vor. Bei der Zuordnung der Benutzerzuordnung muss es sich um einen vorhandenen Team Foundation Server-Benutzer handeln.

  3. Fügen Sie in Arbeitsaufgabenverfolgung in Team Foundation alle in der Benutzerzuordnungsdatei angegebenen Benutzer ein. Weitere Informationen zum Hinzufügen von Benutzern finden Sie unter Gewusst wie: Hinzufügen von Benutzern zu einer Teamprojektgruppe.

    Hinweis:

    Wenn Sie Team Foundation Server während der Migration ClearQuest-Benutzer ohne Änderungen zuordnen möchten, können Sie die Zeilen in der Benutzerzuordnungsdatei dieser Benutzer löschen. Wenn Sie keine Benutzer zuordnen möchten, können Sie alle Zeilen mit Benutzerzuordnungen im Abschnitt <UserMap> löschen. Löschen Sie nur einzelne Einträge im Abschnitt <UserMap>, und löschen Sie weder den Abschnitt selbst noch andere Bereiche der Datei.
    Vorsicht:

    Wenn Benutzer während der Migration keinem gültigen Team Foundation Server-Benutzer zugeordnet werden, müssen Sie möglicherweise Korrekturen an den Benutzerfeldern in Ihren Arbeitsaufgaben vornehmen, bevor Sie damit arbeiten können. Das Konvertierungsprogramm wird ohne Validierung der Feldwerte ausgeführt. Sobald Sie jedoch mit dem Bearbeiten der Arbeitsaufgaben beginnen, müssen Sie gültige Benutzer für die Benutzerfelder angeben.

Bearbeiten der Feldzuordnungsdatei

Das ClearQuest-Konvertierungsprogramm verwendet die Feldzuordnungsdateien, um die Felder in jeder ClearQuest-Entität dem entsprechenden Arbeitsaufgabenfeld in Arbeitsaufgabenverfolgung in Team Foundation zuzuordnen.

So ändern Sie die Feldzuordnungsdatei

  1. Öffnen Sie eine der Feldzuordnungsdateien. Öffnen Sie beispielsweise DefectFieldMap.xml. Nachfolgend finden Sie ein Beispiel:

    <FieldMap from="Criticality" to="Severity">
  <ValueMaps>
        <ValueMap from="1-Critical" to = "1"/>
        <ValueMap from="2-Major" to = "2"/>
  </ValueMaps>
</FieldMap>

  2. Überprüfen Sie die Feldzuordnungszeilen (ab ValueMap), und stellen Sie sicher, dass das nach "From" angegebene Feld dem richtigen Feld nach "To" zugeordnet ist. Sie können weitere Feldzuordnungen hinzufügen, indem Sie weitere ValueMap-Zeilen hinzufügen. Diese Werte sollten in der Liste der zulässigen Werte enthalten sein, wenn dies in der Schemadatei defect.xml angegeben wurde.

    Hinweis:

    Stellen Sie beim Ändern der Feldzuordnungen sicher, dass die Pflichtfelder im Arbeitsaufgabenformular zugeordnet sind.

  3. Öffnen Sie die anderen Feldzuordnungsdateien, und bearbeiten Sie sie nach Bedarf.

Definieren einer Arbeitsaufgabentyp-Definition

Im Anschluss an die Analyse generiert das Konvertierungsprogramm WITDs für jeden ClearQuest-Datensatztyp. Beispielsweise erhält eine Datei für den ClearQuest-Fehlerdatensatztyp den Namen Defect.xml. Das Konvertierungsprogramm generiert während der Analyse im Rahmen der Schemagenerierung ein Standard-Arbeitsaufgabenformular. Dieses Standardformular enthält jedoch nur grundlegende Formatierungen und muss i. d. R. noch weiter bearbeitet werden, um den Arbeitsaufgaben das gewünschte Layout zuzuweisen. Weitere Informationen zum Ändern einer WITD-Datei finden Sie unter Exemplarische Vorgehensweise: Vornehmen von grundlegenden benutzerdefinierten Anpassungen für einen Arbeitsaufgabentyp und Exemplarische Vorgehensweise: Durchführen von erweiterten Anpassungen für einen Arbeitsaufgabentyp.

Migrieren der ClearQuest-Arbeitsaufgaben

So migrieren Sie Arbeitsaufgaben

  1. Führen Sie an der Visual Studio 2008-Eingabeaufforderung den folgenden Befehl aus:

    CQConverter.exe /c:migrate /m:CqConverterConfig.xml /s:path\Schemamap.xml

    path steht für den Pfad zur Schemazuordnungsdatei. Die Schemazuordnungsdatei wird während der Analysephase im angegebenen Ausgabeverzeichnis generiert.

    Hinweis:

    Die Verarbeitung großer Datenbanken durch das ClearQuest-Konvertierungsprogramm kann mehrere Stunden dauern.
    Hinweis:

    Weitere Informationen über ClearQuest-Konvertierungsbefehle finden Sie unter Migrieren von ClearQuest.

  2. Überprüfen Sie nach Abschluss des Migrationsvorgangs den Status der Migration im Migrationsbericht. Überprüfen Sie diesen ferner auf Fehler, die eine Migration verhindern, z. B. Inkonsistenzen bei der Feldzuordnung.

    Der Migrationsbericht wird unter dem Namen CQMigrationReport.xml in dem Ordner erstellt, in dem das ClearQuest-Konvertierungsprogramm ausgeführt wurde.

    Hinweis:

    Da das Konvertierungsprogramm alle in der von Ihnen angegebenen Abfrage enthaltenen Arbeitsaufgaben konvertiert sowie alle Arbeitsaufgaben, auf die von diesen Arbeitsaufgaben verwiesen wird, weicht die tatsächliche Anzahl der migrierten Arbeitsaufgaben möglicherweise von der Anzahl der Arbeitsaufgaben in der Abfrage ab.

  3. Wenn keine der Arbeitsaufgaben migriert wurde, können Sie die Konvertierung erneut durchführen, nachdem Sie die im Migrationsbericht aufgeführten Probleme behoben haben.

Wenn Sie weitere Arbeitsaufgaben von ClearQuest zu Arbeitsaufgabenverfolgung in Team Foundation migrieren möchten, können Sie den Migrationsprozess erneut ausführen.

So führen Sie die Migration für die gleiche ClearQuest-Datenbank erneut aus

  1. Beheben Sie alle im Migrationsbericht für die vorherige Migration aufgeführten Probleme.

  2. Führen Sie eine Abfrage in ClearQuest aus, die die gewünschten Arbeitsaufgaben zurückgibt, oder führen Sie die gleiche Abfrage aus, wenn Sie Arbeitsaufgaben migrieren möchten, die beim ersten Mal nicht migriert wurden.

  3. Ändern Sie den Abschnitt <QueryName> in der Konfigurationsdatei, um den neuen Abfragenamen anzugeben.

  4. Öffnen Sie die Visual Studio 2008-Eingabeaufforderung, und geben Sie den Befehl für die Migration ein:

    CQConverter.exe /c:migrate /m:CqConverterConfig.xml /s:path\Schemamap.xml

    Die Verarbeitung großer Datenbanken durch das ClearQuest-Konvertierungsprogramm kann mehrere Stunden dauern.

    Hinweis:

    Weitere Informationen über ClearQuest-Konvertierungsbefehle finden Sie unter Migrieren von ClearQuest.

  5. Überprüfen Sie den Status der Migration im Migrationsbericht, nachdem die Migration vollständig abgeschlossen wurde. Der Migrationsbericht wird unter dem Namen CQMigrationReport.xml in dem Ordner erstellt, in dem das ClearQuest-Konvertierungsprogramm ausgeführt wurde.

Überprüfen der Arbeitsaufgabenmigration

Nach Durchführung der Migration können Sie einige der migrierten Arbeitsaufgaben überprüfen, um sicherzustellen, dass die Informationen erfolgreich migriert wurden.

So überprüfen Sie die migrierten Arbeitsaufgaben

  1. Öffnen Sie eine migrierte Arbeitsaufgabe in Arbeitsaufgabenverfolgung in Team Foundation.

  2. Vergleichen Sie mithilfe der Angabe im ClearQuest-ID-Feld die Arbeitsaufgabe von Arbeitsaufgabenverfolgung in Team Foundation mit dem ClearQuest-Fehler mit der gleichen ID.

So suchen Sie die Team Foundation-Arbeitsaufgabe, die einer bestimmten ClearQuest-Arbeitsaufgabe entspricht

  1. Erstellen Sie eine Abfrage für eine Arbeitsaufgabe mit der folgenden Abfrageklausel:

    Und/Oder

    Feld

    Operator

    Wert

     

    VSTS SourceID

    =

    ClearQuest-Arbeitsaufgaben-ID

    Das Feld VSTS SourceID entspricht der Bezeichnung des ClearQuest-ID-Felds, die im Arbeitsaufgabenformular angezeigt wird.

    Weitere Informationen zum Erstellen von Abfragen für Arbeitsaufgaben finden Sie unter Gewusst wie: Hinzufügen neuer Arbeitsaufgabenabfragen.

  2. Führen Sie die Abfrage aus.

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Verfolgen von Arbeitsaufgaben

Weitere Ressourcen

Exemplarische Vorgehensweisen zur Migration