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.

Hinweis

Wenn Sie die Fehlermeldung TF400917 empfangen, wurde eine ungültige Konfiguration in TWA festgestellt.Importieren Sie die Prozesskonfigurationsdatei mit witadmin importcommonprocessconfig 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.

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

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

Hinweis

Durch die Installation von VS TFS 2013 werden vorhandene Teamprojekte aktualisiert.Sie verwenden die Prozesskonfigurationsdatei, die die Agile-Konfigurationsdateien und die allgemeinen Konfigurationsdateien kombiniert, die in TFS 2012 unterstützt werden.Die folgenden witadmin-Befehle sind veraltet, ebenso wie ihre entsprechenden Konfigurationsdateien:

• exportagileprocessconfig

• exportcommonprocessconfig

• importagileprocessconfig

• importcommonprocessconfig

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

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

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. 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. 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 dazu finden Sie unter Unterstützen des Fehlerupdatestatus mit "Meine Arbeit".
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 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.