Anpassen von Kategorien für Arbeitsaufgabentypen

  • Artikel

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.

Das Befehlszeilenhilfsprogramm witadmin befindet sich im Verzeichnis Laufwerk:\Programme\Microsoft Visual Studio 10.0\Common7\IDE auf dem Clientcomputer, auf dem Team Explorer ausgeführt wird.

Tipp

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 April 2010 (möglicherweise in englischer Sprache).

Erforderliche Berechtigungen

Für das Teamprojekt, in den die Arbeitsaufgabentypen definiert sind, müssen die folgenden Berechtigungen festgelegt sein:

  • Zum Exportieren von Kategorien von Arbeitsaufgabentypen müssen Sie Mitglied der Gruppe Readers sein, oder die Berechtigung Arbeitsaufgaben in diesem Knoten anzeigen muss auf Zulassen festgelegt sein.

  • Zum Importieren der Kategorien von Arbeisaufgabentypen müssen Sie Mitglied der Sicherheitsgruppe Team Foundation-Administratoren oder Projektadministratoren sein.

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

Tipp

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. Klicken Sie zum Öffnen eines Eingabeaufforderungsfensters mit erhöhten Rechten auf Start, klicken Sie mit der rechten Maustaste auf Eingabeaufforderung, und klicken Sie dann auf Als Administrator ausführen. Weitere Informationen finden Sie auf der folgenden Microsoft-Website: Benutzerkontensteuerung.

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

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

Parameter

Parameter

Beschreibungen

/collection:CollectionURL

Gibt den URI der Teamprojektsammlung an. Das Format für den URI sieht folgendermaßen aus: http://ServerName:Port/VirtuellerVerzeichnisname/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 weglassen, wenn Sie den exportcategories-Befehl verwenden, 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. Beispielsweise gibt /e:utf-7 die Unicode (UTF-7)-Codierung an. Wenn Sie diesen Parameter weglassen, versucht witadmin, die Codierung zu erkennen, und wenn Erkennung fehlschlägt, 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 einer bestehenden Gruppe von Kategorien schreiben oder die Kategorien mit den neuen Daten aktualisieren.

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 Teamprojektsammlung: http://AdventureWorksServer:8080/AWTeam/Collection1

  • 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 Arbeitsaufgabentypkategorien aufgelistet.

witadmin exportcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks

Exportieren der Kategorien von Arbeitsaufgabentypen

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

witadmin exportcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /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/AWTeam/Collection1 /p:AdventureWorks /f:myCategories.xml

Siehe auch

Weitere Ressourcen

Zusammenfassen von Arbeitsaufgabentypen in Kategorien

Arbeiten mit Kategorien für Arbeitsaufgabentypen

witAdmin: Verwalten von Objekten für das Nachverfolgen von Arbeitsaufgaben