Update a team project manually to support test management

  • Artikel

Wenn Sie ein Upgrade Ihrer vorhandenen lokalen Bereitstellung auf Team Foundation Server (TFS) 2013.3 vornehmen, haben Sie die Möglichkeit, Testpläne und Testsammlungen anzupassen, weil diese Objekte jetzt als Arbeitsaufgabentypen (WITs) neu modelliert wurden.

Um diese Transformation zu erzielen, aktualisiert der TFS-Upgrade-Assistent automatisch die für alle Auflistungen in der Anwendungsebene definierten Teamprojekte und migriert vorhandene Testdaten und Objekte. Im Hintergrund werden zwei Aktivitäten ausgeführt:

  1. Importieren der Arbeitsaufgabentyp-Definitionen für Testplan und Testsammlung und Aktualisieren der Kategoriedefinition für Teamprojekte, sodass sie Testplan- und Testsammlungskategorien beinhalten.

  2. Migrieren vorhandener Testverwaltungsdaten. Arbeitsaufgaben werden aus vorhandenen Testplänen und Testsammlungen erstellt, und die Links zwischen den anderen vorhandenen Testartefakten, z. B. Testpunkte, Testläufe und Testergebnisse, werden so repariert, dass sie auf die arbeitsaufgabenbasierten Testpläne und Testsammlungen verweisen.

Die Datenmigration hängt von einem erfolgreichen Import von Arbeitsaufgabentyp-Definitionen und -Aktualisierungen ab. Wenn die erste Aktivität fehlschlägt, wird die zweite erst gar nicht ausgeführt. In dem Fall, dass eine der Aktivitäten nicht erfolgreich ist, protokolliert der Assistent eine oder mehrere Warnungen oder Fehler.

TFS-Aktualisierungs-Assistent zeigt Testverwaltungsfehler

Wenn es hierzu kommt, müssen Sie Ihr Teamprojekt manuell aktualisieren. Sie können dann erst auf vorhandene Testpläne und Testsammlungen zugreifen, nachdem Sie die manuellen Aktualisierungen durchgeführt haben.

Fehler können auftreten, wenn Ihr Teamprojekt bereits Arbeitsaufgabentypen enthält, die mit Testplan oder Testsammlung bezeichnet sind, oder wenn Sie ein Upgrade von TFS 2005 auf 2008 durchgeführt und nicht die notwendigen Objekte für die Arbeitsaufgabenverfolgung zur Unterstützung der Testverwaltung hinzugefügt haben. Siehe Aktualisieren eines Teamprojekts auf Basis der Prozessvorlage MSF v4.2.

Manuelles Aktualisieren Ihres Teamprojekts für die Unterstützung der Testoberfläche von TFS 2013.3

  1. Importieren Sie die Arbeitsaufgabentyp-Definitionen für "Testplan" und "Testsammlung".

    1. Wenn Sie keine Administratorberechtigungen haben, lassen Sie sich die entsprechenden Berechtigungen zuweisen. Um alle Aktualisierungsschritte durchzuführen, müssen Sie Mitglied der Sicherheitsgruppe Team Foundation-Administratoren und ein Administrator auf dem Anwendungsebenenserver sein.

    2. Laden Sie die neueste Version der Prozessvorlagen herunter.

    3. Öffnen Sie ein Eingabeaufforderungsfenster auf dem Computer, auf dem entweder Visual Studio oder Team Explorer installiert ist, und geben Sie Folgendes ein:

      cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE

      Ersetzen Sie bei einer 32-Bit-Windows-Edition "%programfiles(x86)%" durch "%programfiles%". Sie können Team Explorer kostenlos herunterladen.

    4. Importieren Sie die Arbeitsaufgabentyp-Definitionen für "Testplan" und "Testsammlung". Geben Sie den Verzeichnispfad zum Ordner "WorkItem Tracking/TypeDefinitions" an, in dem die von Ihnen heruntergeladene Prozessvorlage enthalten ist.

      witadmin importwitd /collection:"CollectionURL" /p:"ProjectName" /f:"DirectoryPath\TestPlan.xml"
witadmin importwitd /collection:"CollectionURL" /p:"ProjectName" /f:"DirectoryPath\TestSuite.xml"

      Ein Beispiel für CollectionURL ist http://MyServer:8080/tfs/DefaultCollection.

      Der Verzeichnispfad muss dieser Struktur folgen: Laufwerk:\Vorlagenordner\WorkItem Tracking\TypeDefinitions. Beispiel:

      C:\Process Template\Microsoft Visual Studio Scrum 2013.3\WorkItem Tracking\TypeDefinitions

  2. Aktualisieren Sie Ihre Kategoriedefinitionen.

    1. Exportieren Sie Ihre Kategoriedefinitionsdatei.

      witadmin exportcategories /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\Categories.xml"

    2. Fügen Sie die folgenden Kategorien hinzu.

      <CATEGORY name="Test Plan Category" refname="Microsoft.TestPlanCategory">
    <DEFAULTWORKITEMTYPE name="Test Plan" />
  </CATEGORY>
  <CATEGORY name="Test Suite Category" refname="Microsoft.TestSuiteCategory">
    <DEFAULTWORKITEMTYPE name="Test Suite" />
  </CATEGORY>

    3. Fügen Sie die neuen Arbeitsaufgabentypen zu den ausgeblendeten Kategorien hinzu.

      <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
    <DEFAULTWORKITEMTYPE name="Code Review Request" />
    <WORKITEMTYPE name="Code Review Response" />
    <WORKITEMTYPE name="Feedback Request" />
    <WORKITEMTYPE name="Feedback Response" />
    <WORKITEMTYPE name="Shared Steps" />
    <WORKITEMTYPE name="Shared Parameter" />
    <WORKITEMTYPE name="Test Plan" />
    <WORKITEMTYPE name="Test Suite" />
  </CATEGORY>

    4. Importieren Sie die aktualisierte Datei.

      witadmin importcategories /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\Categories.xml"

  3. Migrieren Sie vorhandene Testpläne und -sammlungen zu arbeitsaufgabenbasierten Testplänen und Testsammlungen.

    1. Öffnen Sie auf dem TFS-Anwendungsebenenserver ein Eingabeaufforderungsfenster:

      cd %programfiles%\Microsoft Team Foundation Server 12.0\Tools

    2. Führen Sie den TfsConfig TCM-Befehl aus.

      TFSConfig TCM /upgradeTestPlans /CollectionName:CollectionName /TeamProject:TeamProjectName

      Beispiel:

      TFSConfig TCM /upgradeTestPlans /CollectionName:"Fabrikam Fiber Collection" /TeamProject:"Fabrikam Fiber"

      Beantworten Sie die angezeigten Fragen.

      Logging sent to file C:\ProgramData\Microsoft\Team Foundation\Server Configuration\Logs\TPC_UPG_AT_0515_143821.log
Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
Copyright (c) Microsoft Corporation. All rights reserved.
 
Command: tcm
Microsoft (R) TfsConfig - Team Foundation Server Configuration Tool
Copyright (c) Microsoft Corporation. All rights reserved.
 
In order to upgrade the test plans, you have to complete the following steps:
1. Import the test plan work item definition into the project. Have you complete
d this step? (Yes/No) Yes
2. Import the test plan category into the project. Have you completed this step?
(Yes/No) Yes

Test plan migration job successfully scheduled.

    3. Wenn Sie eine große Menge von Testplänen und Testsammlungen migrieren, können Sie den folgenden Befehl ausführen, um den Status der Datenmigration zu überwachen.

      TFSConfig TCM /upgradeStatus /collectionName:CollectionName /TeamProject:TeamProjectName

Nach einer erfolgreichen Datenmigration sollten alle Testverwaltungsdaten zur Verwendung verfügbar sein. Weitere Informationen zu diesem Dienstprogramm finden Sie hier.

Informationen, wie Sie auf die neuen arbeitsaufgabentypbasierten Testpläne und Testsammlungen in Test Manager oder Team Web Access zugreifen, finden Sie unter Planen von manuellen Tests.