Anpassen von Kategorien für Arbeitsaufgabentypen

Artikel
02/27/2013

Sie können die Kategorien für Arbeitsaufgabentypen verwalten, die für ein Teamprojekt definiert sind, indem Sie folgende witadmin-Befehle verwenden:

exportcategories: Exportiert die XML-Definition von Kategorien, die auf einem Server definiert wurden, der Team Foundation Server ausführt.
importcategories: Importiert eine XML-Definitionsdatei für Arbeitsaufgabentypen in ein Teamprojekt auf einem Server, der Team Foundation Server ausführt.

Wenn eine Kategorie mit dem gleichen Namen bereits vorhanden ist, überschreibt dieser Befehl die vorhandene Definition.Wenn der Arbeitsaufgabentyp nicht bereits vorhanden ist, erstellt dieser Befehl eine neue Kategorie.

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%\Microsoft Visual Studio 11.0\Common7\IDE

Ersetzen Sie bei einer 64-Bit-Windows-Edition %programfiles% durch %programfiles(x86)%.

Hinweis
Mit dem Prozess-Editor, einem Powertool für Visual Studio, können Sie Kategorien erstellen und bearbeiten.Dieses Powertool wird nicht unterstützt.Weitere Informationen finden Sie auf der folgenden Seite der Microsoft-Website: Team Foundation Server Power Tools.

Anforderungen

Für das Teamprojekt, für das die Kategorien definiert sind, müssen die folgenden Berechtigungen festgelegt sein:

Um Kategorien von Arbeitsaufgabentypen zu exportieren, muss die Berechtigung Projektebeneninformationen anzeigen auf Zulassen festgelegt werden.
Um Kategorien von Arbeitsaufgabentypen zu importieren, müssen Sie Mitglied der Sicherheitsgruppe Projektadministratoren sein, oder die Berechtigung Projektebeneninformationen bearbeiten muss auf Zulassen festgelegt werden.

Weitere Informationen finden Sie unter Team Foundation Server-Berechtigungen und Team Foundation Server: Standardgruppen, Berechtigungen und Rollen.

Hinweis
Sie müssen auch dann ein Eingabeaufforderungsfenster mit erhöhten Rechten öffnen, wenn Sie sich mit Administratorrechten anmelden, um diese Funktion auf einem Server nutzen zu können, auf dem Windows Server 2008 ausgeführt wird.Um ein Eingabeaufforderungsfenster mit erweiterten Rechten zu öffnen, wählen Sie Start, öffnen Sie das Kontextmenü Eingabeaufforderung, und wählen Sie Als Administrator ausführen aus.Weitere Informationen finden Sie auf der Microsoft-Website unter Benutzerkontensteuerung.

Sie müssen auch dann ein Eingabeaufforderungsfenster mit erhöhten Rechten öffnen, wenn Sie sich mit Administratorrechten anmelden, um diese Funktion auf einem Server nutzen zu können, auf dem Windows Server 2008 ausgeführt wird.Um ein Eingabeaufforderungsfenster mit erweiterten Rechten zu öffnen, wählen Sie Start, öffnen Sie das Kontextmenü Eingabeaufforderung, und wählen Sie Als Administrator ausführen aus.Weitere Informationen finden Sie auf der Microsoft-Website unter Benutzerkontensteuerung.

witadmin exportcategories /collection:CollectionURL /p:Project [/f:FileName] [/e:Encoding] 

witadmin importcategories /collection:CollectionURL /p:Project /f:FileName [/e:Encoding]

Parameter

Parameter	Beschreibung
/collection:CollectionURL	Gibt den URI der Teamprojektauflistung an.Das Format für den URI sieht folgendermaßen aus: http://Servername:Port/NameDesVirtuellenVerzeichnisses/Auflistungsname Wenn kein virtuelles Verzeichnis verwendet wird, hat der URI das folgende Format: http://Servername:Port/Auflistungsname.
/p:Project	Der Name des Teamprojekts, aus dem die Kategorien exportiert werden oder in das die Kategorien importiert werden.
/f:Dateiname	Der Pfad und der Dateiname der XML-Definitionsdatei, die die zu exportierenden oder importierenden Kategorien enthält.Wenn Sie diesen Parameter bei Verwendung des Befehls exportcategories weglassen, führt der Befehl die Kategorien im Eingabeaufforderungsfenster auf.
/e:Codierung	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 bei fehlgeschlagener Erkennung verwendet witadmin UTF-8.
/? oder help	Zeigt die Hilfe zum Befehl im Eingabeaufforderungsfenster an.

Hinweise

Durch den Import einer Kategoriendatei werden die Kategorien erstellt, sofern sie nicht bereits vorhanden sind.Wenn bereits Kategorien vorhanden sind, gibt der witadmin importcategories-Befehl eine Warnung aus, die darauf hinweist, dass die aktuelle Liste überschrieben wird.Sie können ein eigenes Programm zur Aktualisierung eines vorhandenen Satzes von Kategorien schreiben oder die Kategorien selbst mit neuen Daten aktualisieren.

Wichtig
Änderungen an Kategorien können sich auf die Prozesskonfiguration auswirken.Informationen hierzu finden Sie unter Anpassen der Rückstands- und Boardseiten mit Prozesskonfiguration.

Weitere Informationen über die Kategorien der XML-Dateistruktur finden Sie unter Kategorien-Definitionsschemareferenz.

Beispiele

Falls nicht anders angegeben, gelten in jedem Beispiel die folgenden Werte:

URI für die Teamprojektauflistung: http://AdventureWorksServer:8080/tfs/DefaultCollection
Projektname: AdventureWorks
Eingabe- oder Ausgabedateiname: myCategories.xml
Standardcodierung: UTF-8

Auflisten der Kategorien von Arbeitsaufgabentypen

Mit dem folgenden Befehl werden die für das Projekt AdventureWorks definierten Arbeitsaufgabentyp-Kategorien aufgelistet.

witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks

Exportieren der Kategorien von Arbeitsaufgabentypen

Mit dem folgenden Befehl werden die für das Projekt AdventureWorks definierten Arbeitsaufgabentyp-Kategorien in die XML-Datei myCategories exportiert.

witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml

Importieren der Kategorien von Arbeitsaufgabentypen

Im folgenden Beispiel werden Kategorien aus der XML-Datei "myCategories" in das AdventureWorks-Projekt importiert.

witadmin importcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml

Siehe auch

Konzepte

Anpassen der Rückstands- und Boardseiten mit Prozesskonfiguration

Weitere Ressourcen

Definieren von Kategorien für Arbeitsaufgabentypen

Arbeitsaufgabentypkategorien-Elementverweis

witAdmin: Anpassen und Verwalten von Objekten für die Nachverfolgung von Arbeitsaufgaben

Freigeben über