Sdílet prostřednictvím

Import and export categories [witadmin]

  • Článek

Můžete importovat a exportovat kategorií definovaných pro týmový projekt s použitím následujících witadmin příkazů:

  • exportcategories: Vyexportuje definice XML kategorií definovaných na serveru, který spouští Team Foundation Server.

  • importcategories: Importuje soubor definice XML typ pracovní položky do týmového projektu na serveru, který spouští Team Foundation Server. 

    Pokud kategorie se stejným názvem již existuje, tento příkaz přepíše stávající definici. Pokud typ pracovní položky již neexistuje, bude tento příkaz vytvoří novou kategorii.

Další informace o výchozí kategorie a způsobu jejich použití, přejděte zde.

witadmin Nástroj příkazového řádku lze použít pouze při spuštění proti TFS místně. Chcete-li spustit nástroj, otevřete okno příkazového řádku kde buď Visual Studio nebo Průzkumník týmových projektů je nainstalován a zadejte:

cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE

Na 32bitovou verzi systému Windows, nahradit %programfiles(x86)% s %programfiles%.

Poznámka

Můžete vytvořit a upravit kategorie pomocí procesu editoru, jako nástroj power Visual Studio.Tento nástroj power není podporován.Další informace naleznete v tématu na následující stránce webu společnosti Microsoft: Team Foundation Server výkonné nástroje.

Požadavky

Pro týmový projekt, pro které jsou definovány kategorií, musí mít následující oprávnění nastavit:

  • Chcete-li exportovat kategorií typů pracovní položky, musíte mít vaše Zobrazit informace na úrovni projektu oprávnění nastaven na hodnotu Povolit.

  • K importu kategorií typů pracovní položky, musí být členem skupiny Správci projektů zabezpečení seskupení nebo jste Upravit informace na úrovni projektu oprávnění nastaven na hodnotu Povolit.

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

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

Parametry

Parametr

Popis

/collection:CollectionURL

Určuje identifikátor URI kolekce týmových projektů. Formát pro identifikátor URI je následující: http://název_serveru: port/název_virtuálního_adresáře/CollectionName

Pokud je použit žádný virtuální adresář, formát pro identifikátor URI je následující:

http://Název_serveru: port / CollectionName.

/p:Project

Název týmového projektu, z které jsou vyváženy kategorií nebo do kategorií jsou importovány.

/f:Název souboru

Cesta a název souboru definice XML, který obsahuje kategorie, které mají být exportovány nebo importovány. Je-li tento parametr vynecháte při použití exportcategories příkaz, příkaz je uveden seznam kategorií v okně příkazového řádku.

/e:Kódování

Název .NET Framework 2.0 Formát kódování. Uvedené kódování se použije k exportu nebo importu dat XML. Můžete například /e:utf-7 Určuje kódování Unicode (UTF-7). Je-li tento parametr vynecháte witadmin se pokusí zjistit, kódování, a pokud se nezdaří detekce, witadmin používá UTF-8.

/? nebo help

Zobrazí nápovědu o příkaz v okně příkazového řádku.

Poznámky

Kategorie importu souboru kategorie vytvoří, pokud dosud neexistují. Pokud kategorie již existují, witadmin importcategories příkaz upozornění, že aktuální seznam bude přepsán. Můžete napsat vlastní program aktualizovat existující sadu kategorií, nebo můžete aktualizovat kategorií sami nová data.

Důležité

Změny provedené do kategorií může ovlivnit konfigurace procesu.Podívejte se na téma Configure and customize Agile planning tools for a team project.

Informace o struktura souboru XML kategorií naleznete v tématu Categories XML element reference.

Příklady

Pokud není uvedeno jinak, platí následující hodnoty v jednotlivých příkladu:

  • Identifikátor URI pro kolekce týmových projektů: http://AdventureWorksServer:8080, tfs/DefaultCollection

  • Název projektu: AdventureWorks

  • Vstupní nebo výstupní název souboru: myCategories.xml

  • Výchozí kódování: UTF-8

Dd273721.collapse_all(cs-cz,VS.140).gifSeznam kategorií

Následující příkaz zobrazí kategorie typ pracovní položky definované pro AdventureWorks projektu.

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

Dd273721.collapse_all(cs-cz,VS.140).gifPřidat kategorii do kategorií skryté typy

Přidání kategorie do kategorií skryté typy odebrat podporu pro uživatele, chcete-li vytvořit typy pracovních položek v dané kategorii.

  1. Exportujte soubor definice pro kategorie pro váš týmový projekt.

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

  2. Otevřete soubor kategorií v upřednostňované textovém editoru a vyhledejte CATEGORY element pro "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. Přidat WORKITEMTYPE element, který určuje popisný název typu pracovní položky, které chcete přidat.

    Následující syntaxe můžete například přidá typ vlastní pracovní položky "Integrace sestavení" do kategorií typy skrytá.

    <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. Importujte soubor definice pro kategorie k týmovému projektu.

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

Viz také

Koncepty

Configure and customize Agile planning tools for a team project

Další zdroje

Use categories to group work item types