Importieren und Exportieren der Prozesskonfiguration [witadmin]

Sie passen die Prozesskonfiguration an, um die Anzeige der Agile-Planungstoolseiten zu ändern, die Sie in Team Web Access (TWA) anzeigen. Einige zusätzliche Tools erfordern, dass Sie Workflowstatus zu Metazustandszuordnungen zuordnen.

Eine Übersicht, wie Sie die Agile-Planungstoolseiten anpassen können, finden Sie unter Konfigurieren und Anpassen von Agile-Planungstools für ein Teamprojekt.

Zum Verwalten der Prozesskonfiguration für ein Teamprojekt verwenden Sie das Befehlszeilentool witadmin, um die XML-Definitionsdatei für die Prozesskonfiguration zu exportieren und zu importieren. Informationen zur Prozesskonfiguration finden Sie unter XML-Elementreferenz für die Prozesskonfiguration.

• exportprocessconfig: Exportiert die Prozesskonfigurationsdefinition in eine XML-Datei oder das Eingabeaufforderungsfenster.

• importprocessconfig: Importiert die XML-Datei der Prozesskonfigurationsdefinition.

Um das witadmin-Befehlszeilentool auszuführen, öffnen Sie ein Eingabeaufforderungsfenster, wo 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%.

Anforderungen

• Um Prozesskonfigurationsdefinitionen zu exportieren, müssen Sie ein gültiger Benutzer des Teamprojekts oder der Auflistung sein.

• Um Prozesskonfigurationsdefinitionen zu importieren, müssen Sie Mitglied der folgenden Sicherheitsgruppen sein: Team Foundation Administrators oder Projektadministratoren.

Weitere Informationen finden Sie unter Berechtigungsreferenz für Team Foundation Server.

witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName [/f:FileName] [/e:encoding] 

witadmin importprocessconfig /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:encoding] [/v]

Parameter

Hinweise

Informationen zum Aktualisieren eines Teamprojekts nach einem Upgrade finden Sie unter Konfigurieren von Funktionen nach einem TFS-Upgrade.

Informationen zu Problemen, die nach einem Upgrade auf TFS 2013.3 beim Zugriff auf vorhandene Testpläne oder Testsammlungen auftreten, finden Sie unter Manuelles Aktualisieren eines Teamprojekts für die Unterstützung der Testverwaltung.

Beispiele

Die folgenden Werte sind in jedem Beispiel gültig:

• URL für die Auflistung: http://AdventureWorksServer:8080/tfs/DefaultCollection

• Teamprojekt: Contoso

• Portnummer für die Serverwebsite: 8080

So fügen Sie ein Feld zum Bereich zum schnellen Hinzufügen hinzu

Sie können jeden Bereich zum schnellen Hinzufügen Felder hinzufügen. Mit dem folgenden Beispiel wird z. B. Geschäftswert zum Product Backlog-Bereich hinzugefügt.

Der Bereich zeigt nur Felder an, die im Abschnitt FIELDS der Definition des Arbeitsaufgabentyps für den ausgewählten Arbeitsaufgabentyp enthalten sind. Wenn Sie z. B. den Arbeitsaufgabentyp "Fehler" auswählen, wird nur der "Titel" anzeigt, da der "Geschäftswert" für Fehler nicht definiert ist. Um dem Bereich einen weiteren Arbeitsaufgabentyp hinzuzufügen, fügen Sie ihn wie hier beschrieben der Anforderungskategorie hinzu.

1. Wenn Sie nicht über Administratorberechtigungen für das Teamprojekt verfügen, rufen Sie sie ab.

2. Ö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.

3. Exportieren Sie die Prozesskonfigurationsdatei.

   witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"
   

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

4. Fügen Sie den Feldverweisnamen zum Abschnitt AddPanel hinzu.

   Mit der folgenden Syntax wird dem Bereich beispielsweise das Element Priorität hinzugefügt.

   <AddPanel>
      <Fields>
         <Field refname="System.Title" />
         <Field refname="Microsoft.VSTS.Common.BusinessValue" />
      </Fields>
   </AddPanel>
   

   Tipps:

   • Sie können den Verweisnamen für ein Feld mit diesem Index suchen.

   • Fügen Sie alle Pflichtfelder für die Arbeitsaufgabentypen hinzu, die für die Anforderungskategorie definiert sind. So müssen Sie das Arbeitsaufgabenformular nicht öffnen, um die Felder auszufüllen, wenn Sie Backlogelemente über den Bereich hinzufügen.

5. Importieren Sie die Prozesskonfigurationsdatei.

   witadmin importprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"
   

6. Aktualisieren Sie die Backlogseite, um den aktualisierten Bereich anzuzeigen.

Aktualisieren von Metazustandszuordnungen für die Unterstützung von Test Manager

Wenn Sie den WORKFLOW-Abschnitt des Testplans oder der Testsammlung aktivieren, müssen Sie die Status Metazuständen zuordnen. Hierdurch werden Test Manager-Clients unterstützt, die mit Visual Studio 2013.2 oder früheren Versionen ausgeführt werden.

Im folgenden Beispiel wurde der Tesplan-Workflow so aktualisiert, dass er die Zustände "Entwurf", "Test" und "Abgezeichnet" unterstützt. Zur Unterstützung der Abwärtskompatibilität werden dem ProjectProcessConfiguration-Abschnitt der Prozesskonfigurationsdefinition TestPlanWorkItems hinzugefügt.

<WORKFLOW>
      <STATES>
        <STATE value="Design" />
        <STATE value="Testing" />
        <STATE value="Signed Off" />
      </STATES>
      <TRANSITIONS>
        <TRANSITION from="" to="Design">
          <REASONS>
            <DEFAULTREASON value="New test plan" />
          </REASONS>
        </TRANSITION>
     <TRANSITION from="Design" to="Testing">
          <REASONS>
            <DEFAULTREASON value="Authoring complete" />
          </REASONS>
        </TRANSITION>        
     <TRANSITION from="Testing" to="Signed Off">
          <REASONS>
            <DEFAULTREASON value="Signed Off testing" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Signed Off" to="Design">
          <REASONS>
            <DEFAULTREASON value="Reactivating to authoring phase" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Signed Off" to="Testing">
          <REASONS>
            <DEFAULTREASON value="Reactivating to run tests" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Testing" to="Design">
          <REASONS>
            <DEFAULTREASON value="Back to authoring" />
          </REASONS>
        </TRANSITION>
      </TRANSITIONS>
    </WORKFLOW>

<TestPlanWorkItems category="Microsoft.TestPlanCategory" pluralName="Test Plans" singularName="Test Plan">
    <States>
      <State type="InProgress" value="Design" />
      <State type="InProgress" value="Testing" />
      <State type="Complete" value="Signed Off" />
    </States>
  </TestPlanWorkItems>
<TestSuiteWorkItems category="Microsoft.TestSuiteCategory" pluralName="Test Suites" singularName="Test Suite">
    <States>
      <State type="Proposed" value="In Planning" />
      <State type="InProgress" value="In Progress" />
      <State type="Complete" value="Completed" />
    </States>
  </TestSuiteWorkItems>

Wenn Sie den Testsammlungs-Workflow ändern, müssen eine ähnliche Aktualisierung durchführen, wenn Sie neue Zustände zuordnen möchten. Sie würden es in einem TestSuiteWorkItems-Abschnitt hinzufügen. Siehe XML-Elementreferenz für die Prozesskonfiguration.

Fragen und Antworten

F: Welche Anpassungen kann ich vornehmen und trotzdem den Assistenten zum Konfigurieren von Funktionen verwenden, um mein Teamprojekt nach einem TFS-Upgrade zu aktualisieren?

A: Sie können den Bereich zum schnellen Hinzufügen anpassen. Ihre Teamprojekte werden vom Assistenten zum Konfigurieren von Funktionen aktualisiert, und Sie erhalten Zugriff auf die neuesten Funktionen.

Bei anderen Änderungen müssen Sie möglicherweise einige manuelle Schritte ausführen, wenn Sie Ihr Teamprojekt aktualisieren. Informationen darüber, welche Anpassungen Sie bedenkenlos vornehmen und welche Sie besser vermeiden sollten, finden Sie unter Anpassen der Arbeitsnachverfolgung: Vor Durchführung einer Anpassung mit den Auswirkungen auf Wartung und Upgrades vertraut machen.

F: Wann muss ich Workflowzustände zu Metazuständen zuordnen?

A: Wenn Sie den folgenden Arbeitsaufgabentypen Workflowzustände hinzufügen oder davon entfernen, sollten Sie erwägen, die Prozesskonfiguration zu aktualisieren, um entsprechende Metazustandszuordnungen hinzuzufügen bzw. zu entfernen.

• Arbeitsaufgabentypen, die zur Anforderungs- oder Aufgabenkategorie gehören: Metazustandszuordnungen unterstützen die Anzeige der Agile-Planungstools.

• Arbeitsaufgabentypen, die zur Fehlerkategorie gehören: Metazustandszuordnungen zur Unterstützung des Meine Arbeit-Tools (Agile- und CMMI-basierte Teamprojekte).

• Testplan und Testsammlung: Aktualisierungen des Workflows dieser Arbeitsaufgabentypen müssen nur zugeordnet werden, wenn Sie Teammitglieder unterstützen, die Verbindungen mit TFS aus einer Version von Test Manager herstellen, die auf Visual Studio 2013.2 oder einer früheren Versionen basiert.

  Arbeitsaufgabentypen von Testplänen und Testsammlungen sind nur nach dem Upgrade auf TFS 2013.3 verfügbar. Das Upgrade können Sie auf dieser Downloadseite herunterladen.

  Aktualisieren Sie die Metazustandszuordnungen, wenn Sie beim Herstellen einer Verbindung mit Ihrem Teamprojekt einen Fehler Unerwarteter Fehler in Anwendung erhalten.

  

Wie behebe ich Prozesskonfigurationsfehler?

A: Wenn Sie eine der folgenden Änderungen an einem Teamprojekt vornehmen, müssen Sie die Definitionen für den Arbeitsaufgabentyp, die Kategorien oder die Prozesskonfiguration aktualisieren. Nehmen Sie zur Vermeidung von Fehlern die Änderungen immer in der folgenden Reihenfolge vor: (1) Arbeitsaufgabentypen (WITs), (2) Kategorien und (3) Prozesskonfiguration.

F: Wie passe ich andere Funktionen an, die im Agile-Planungstools in TWA angezeigt werden?

A: Einige Anpassungen können über die Benutzeroberfläche ausgeführt werden. Andere erfordern die Bearbeitung der Prozesskonfiguration oder anderer Teamprojektobjekte. Eine Übersicht finden Sie unter Konfigurieren und Anpassen von Agile-Planungstools für ein Teamprojekt.

F: Möchten Sie mit zwei oder mehr Portfoliobacklogs arbeiten?

A: Die Standarderfahrung unterstützt eine Ebene des Portfoliobacklog. Sie können bis zu fünf Ebenen hinzufügen; eine Beschreibung finden Sie unter Hinzufügen eines Backlogs zur Agile-Portfolio-Verwaltung.

F: Möchten Sie die WITs hinzufügen oder ändern, die im Task Board oder im Product Backlog angezeigt werden?

A: Wenn Sie einen benutzerdefinierten WIT hinzugefügt haben und diesen entweder dem Backlog oder dem Task Board hinzufügen möchten, können Sie das tun. Sie können nur nicht an beiden Stellen angezeigt werden. Wie Sie dazu vorgehen, erfahren Sie unter Hinzufügen von Fehlern zum Backlog oder Task Board.