Importieren und Exportieren von Kategorien [witadmin]

  • Artikel

Sie können die für ein Teamprojekt definierten Kategorien importieren und exportieren, indem Sie die folgenden 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.

Weitere Informationen über die Standardkategorien und ihre Verwendung finden Sie hier.

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

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.

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. Der URI hat folgendes Format: 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 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.Siehe Konfigurieren und Anpassen von Agile-Planungstools für ein Teamprojekt.

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

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

Kategorien auflisten

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

Hinzufügen einer Kategorie zu den ausgeblendeten Typenkategorien

Sie fügen den ausgeblendeten Typenkategorien eine Kategorie hinzu, um Unterstützung für Benutzer zum Erstellen von Arbeitsaufgabentypen in dieser Kategorie zu entfernen.

  1. Exportieren Sie die Definitionsdatei für die Kategorien des Teamprojekts.

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

  2. Öffnen Sie die Kategoriedatei im gewünschten Text-Editor und suchen Sie das CATEGORY-Element für die "Hidden Types Category".

    <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
   <DEFAULTWORKITEMTYPE name="Code Review Request" />
   <WORKITEMTYPE name="Code Review Response" />
   <WORKITEMTYPE name="Feedback Request" />
   <WORKITEMTYPE name="Feedback Response" />
   <WORKITEMTYPE name="Shared Steps" />
</CATEGORY>

  3. Fügen Sie ein WORKITEMTYPE-Element hinzu, das den Anzeigenamen des Arbeitsaufgabentyps angibt, den Sie hinzufügen möchten.

    Beispielsweise wird durch die folgende Syntax der ausgeblendeten Typenkategorie der angepasste Arbeitsaufgabentyp "Integrationsbuild" hinzugefügt.

    <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
   <DEFAULTWORKITEMTYPE name="Code Review Request" />
   <WORKITEMTYPE name="Code Review Response" />
   <WORKITEMTYPE name="Feedback Request" />
   <WORKITEMTYPE name="Feedback Response" />
   <WORKITEMTYPE name="Shared Steps" />
   <WORKITEMTYPE name="Integration Build" />
</CATEGORY>

  4. Importieren Sie die Definitionsdatei für die Kategorien des Teamprojekts.

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

Siehe auch

Konzepte

Konfigurieren und Anpassen von Agile-Planungstools für ein Teamprojekt

Weitere Ressourcen

Verwenden von Kategorien für Arbeitsaufgabentypen