Importieren und Exportieren der Prozesskonfiguration [witadmin]

Sie passen die Prozesskonfiguration an, um die Anzeige der Agile-Planungstoolseiten zu ändern, die Sie in Team Foundation Server (TFS) 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 Configure and customize Agile tools for a team project.

Hinweis

Wenn Sie die Fehlermeldung TF400917 empfangen, wurde eine ungültige Konfiguration festgestellt.Importieren Sie die Prozesskonfigurationsdatei mit witadmin importprocessconfig erneut in Ihr Teamprojekt.Sie erhalten die erforderlichen Meldungen zum Beheben des Fehlers.

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.

Das witadmin Befehlszeilentool funktioniert nur, wenn es mit einem lokalen TFS ausgeführt wird. Sie führen dieses Tool aus, indem Sie ein Eingabeaufforderungsfenster öffnen, wo entweder Visual Studio oder Team Explorer installiert ist und Folgendes eingeben:

cd %programfiles(x86)%\Microsoft Visual Studio 14.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

Parameter	Beschreibung
/collection:CollectionURLx	Erforderlich. Gibt die URL der Auflistung an. Der URI muss in folgendem Format angegeben werden: http://Servername:Port/VirtuellerVerzeichnisname/Auflistungsname Wenn Sie kein virtuelles Verzeichnis angeben, muss die URI im folgenden Format angegeben werden: http://Servername:Port/Auflistungsname
/p:ProjectName	Erforderlich. Gibt das Teamprojekt an, für das Sie die Prozesskonfiguration exportieren oder importieren möchten. Dieses Teamprojekt muss in der Auflistung definiert sein, die Sie mit dem /collection-Parameter angegeben haben. Sie müssen kein Teamprojekt angeben, wenn Sie den /v-Schalter angeben.
/f:FileName	Der Pfad und der Name der XML-Definitionsdatei für die zu exportierende oder importierende Prozesskonfiguration. Hinweis Wenn auf dem Clientcomputer Windows Vista ausgeführt wird, haben Sie möglicherweise keine Berechtigungen für bestimmte Ordner.Wenn Sie versuchen, die globale Liste nach einem Speicherort zu exportieren, für den Sie keine Berechtigungen haben, wird die exportierte Datei durch die Technologie zur Registrierungsvirtualisierung automatisch umgeleitet und in einem virtuellen Speicher gespeichert.Weitere Informationen finden Sie auf den folgenden Seiten der Microsoft-Website: Registry Virtualization (Registrierungsvirtualisierung, ggf. in englischer Sprache) und Häufige Probleme mit der Datei- und Registrierungsvirtualisierung in Windows Vista.Um diese Umleitung zu vermeiden, können Sie die Datei an einen Speicherort exportieren, an dem Sie über ausreichende Berechtigungen verfügen.
/e:Encoding	Dies ist optional. Der Name eines .NET Framework 2.0-Codierungsformats. Die angegebene Codierung wird verwendet, um die XML-Daten zu exportieren oder zu importieren. /e utf-7 gibt beispielsweise die Unicode (UTF-7)-Codierung an. Wenn Sie diesen Parameter weglassen, versucht witadmin die Codierung zu erkennen und verwendet bei fehlgeschlagener Erkennung UTF-8.
/v	Dies ist optional. Überprüft das XML, das die Prozesskonfiguration definiert, importiert jedoch nicht die Definitionsdatei.
/? oder help	Zeigt die Hilfe zum Befehl im Eingabeaufforderungsfenster an.

Hinweise

Installieren der neuesten Version von TFS aktualisiert vorhandene Teamprojekte. Wenn Sie ein aktualisiertes Teamprojekt aktualisieren, finden Sie weitere Informationen unter Configure features after a TFS upgrade.

Wenn Probleme beim Zugriff auf vorhandene Testpläne oder Testsammlungen nach einem Upgrade auftreten, finden Sie weitere Informationen unter Update a team project manually to support test management.

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.

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 TestPlanWorkItems-Abschnitt der Prozesskonfigurationsdefinition ProjectProcessConfiguration hinzugefügt.

WORKFLOW

Metazustandszuordnungen

<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. Weitere Informationen finden Sie unter 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 Meine Arbeit Tool (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.

  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. Um Fehler zu vermeiden, stellen Sie immer Ihre Änderungen in dieser Reihenfolge dar: (1) Arbeitsaufgabentypen, (2) Kategorien und (3) Prozesskonfiguration.

Anpassung	Aktualisieren oder Überprüfen der Arbeitsaufgabentyp-Definition	Aktualisieren oder Überprüfen der Prozesskonfigurationsdefinition
Hinzufügen eines Arbeitsaufgabentyps zur Anforderungskategorie (Ein Arbeitsaufgabentyp (WIT) kann entweder zur Anforderungs- oder zur Aufgabenkategorie, aber nicht zu beiden gehören.)	Um die folgenden Felder aufzunehmen: Backlog Priorität (Scrum) oder Stapelrang (Agile oder CMMI) (muss mit dem Feldwert übereinstimmen, der type=Order in der Prozesskonfigurationsdatei zugewiesen ist) Aufwand (Scrum), Storypunkte (Agile) oder Größe (CMMI) (muss mit dem Feldwert übereinstimmen, der type=Effort in der Prozesskonfigurationsdatei zugewiesen ist) Bereichspfad oder der Feldwert, der type=Team in der Prozesskonfigurationsdatei zugewiesen ist Alle Felder, die in den AddPanel-Abschnitt der Prozesskonfigurationsdatei aufgenommen sind (Felder müssen im FIELDS-Abschnitt definiert sein, müssen aber nicht in den FORM-Abschnitt aufgenommen sein).	Um die notwendigen Metazustandszuordnungen aufzunehmen: Ordnen Sie den Anfang jedes Workflowstatus zu type="Proposed" zu. Ordnen Sie jeden Workflowzwischenstatus, der im Kanban-Board angezeigt werden soll, zu type="InProgress" zu. Ordnen Sie das Ende jedes Workflowstatus zu type="Complete" zu. type="Complete" kann nur ein Status zugeordnet sein. Um einen Eintrag aufzunehmen, der die dem Arbeitsaufgabentyp (WIT) zugeordneten Farbcodes definiert. Zum Beispiel: <WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="Product Backlog Item" />
Ändern des Workflows eines Arbeitsaufgabentyps in der Anforderungskategorie	Nicht zutreffend	Um die notwendigen Metazustandszuordnungen, wie oben beschrieben, für das Hinzufügen eines Arbeitsaufgabentyps zur Anforderungskategorie aufzunehmen.
Hinzufügen eines Arbeitsaufgabentyps zur Aufgabenkategorie	Um die folgenden Felder aufzunehmen: Backlog Priorität (Scrum) oder Stapelrang (Agile oder CMMI) Aktivität (Scrum oder Agile) oder Disziplin (CMMI) (muss mit dem Feldwert übereinstimmen, der type=Activity in der Prozesskonfigurationsdatei zugewiesen ist) Verbleibende Arbeit (muss mit dem Feldwert übereinstimmen, der type=RemainingWork in der Prozesskonfigurationsdatei zugewiesen ist) Bereichspfad oder der Feldwert, der type=Team in der Prozesskonfigurationsdatei zugewiesen ist (Optional) Ursprüngliche Arbeit und Abgeschlossene Arbeit (nur Agile und CMMI)	Um die notwendigen Metazustandszuordnungen aufzunehmen: Ordnen Sie den Anfang jedes Workflowstatus zu type="Proposed" zu. Ordnen Sie jeden Workflowzwischenstatus, der im Task Board angezeigt werden soll, zu type="InProgress" zu. Ordnen Sie das Ende jedes Workflowstatus zu type="Complete" zu. type="Complete" kann nur ein Status zugeordnet sein. Um einen Eintrag aufzunehmen, der die dem Arbeitsaufgabentyp (WIT) zugeordneten Farbcodes definiert. Zum Beispiel: <WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />
Ändern des Workflows eines Arbeitsaufgabentyps in der Aufgabenkategorie	Nicht zutreffend	Um die notwendigen Metazustandszuordnungen, wie oben beschrieben, für das Hinzufügen eines Arbeitsaufgabentyps zur Aufgabenkategorie aufzunehmen.
Hinzufügen eines Arbeitsaufgabentyps zur Fehlerkategorie (nur Agile und CMMI) Ändern des Workflows eines Arbeitsaufgabentyps in der Fehlerkategorie (nur Agile und CMMI)	Nicht zutreffend	Um die notwendigen Metazustandszuordnungen aufzunehmen: Ordnen Sie den Anfang jedes Workflowstatus zu type="Proposed" zu. Ordnen Sie jeden Workflowzwischenstatus, der in "Meine Arbeit" angezeigt werden soll, zu type="InProgress" zu. Ordnen Sie das Ende jedes Workflowstatus zu type="Complete" zu. type="Complete" kann nur ein Status zugeordnet sein. Weitere Informationen finden Sie unter Support bug update status using My Work.
Entfernen eines Arbeitsaufgabentyps aus der Anforderungs- oder Aufgabenkategorie	Nicht zutreffend	Um alle Metazustandszuordnungen zu entfernen, die nur diesem Arbeitsaufgabentyp zugeordnet sind.
Entfernen eines Arbeitsaufgabentyps aus einem Teamprojekt	Um den Arbeitsaufgabentyp aus der Kategoriendatei zu entfernen.	Um alle Metazustandszuordnungen zu entfernen, die nur diesem Arbeitsaufgabentyp zugeordnet sind, den Sie entfernt haben, und das WorkItemColor-Element, das die Farbcodes für den von Ihnen entfernten Arbeitsaufgabentyp definiert.

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 Configure and customize Agile tools for a team project.

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 Add a backlog to Agile portfolio management.

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 Arbeitsaufgabentypen zu Backlogs und Boards.