Import, export, and manage work item types [witadmin]

Článek
09/11/2015

Pracovní položka typy pro týmový projekt můžete spravovat pomocí následujících witadmin příkazů:

destroywitd: Odstraní typ pracovní položky a ničí všechny pracovní položky daného typu trvale bez obnovení.
exportwitd: Vyexportuje definice typu pracovní položky do souboru XML, nebo okno příkazového řádku.
importwitd: Importy pracovní položky typy ze souboru XML definice do týmového projektu na serveru, který spouští Team Foundation Server. Pokud typ pracovní položky se stejným názvem již existuje, nové definice typu pracovní položky přepíše existující. Pokud typ pracovní položky již neexistuje, bude tento příkaz vytvoří nový typ pracovní položky. Chcete-li ověřit kód XML, který definuje typ pracovní položky, ale není importu souboru, použijte /v možnost.
listwitd: Zobrazí názvy typy pracovních položek v zadaném projektu v okně příkazového řádku.
renamewitd: Změní zobrazovaný název typu pracovní položky v rámci na určitém projektu. Po spuštění tohoto příkazu pracovní položky zobrazit tohoto typu nový název.

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

Další informace o typech pracovních položek, naleznete v Add type definitions for work items to a process template.

Poznámka

Typy pracovních položek můžete vytvořit a upravit pomocí editoru procesů, výkonného nástroje pro sadu Visual Studio.Tento nástroj 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, kde jsou definovány typy pracovních položek, musí mít následující oprávnění nastavit:

Pokud chcete exportovat nebo seznam typů pracovních položek, musí být členem skupiny Správci projektů skupině nebo jste své Zobrazit informace na úrovni projektu oprávnění nastaven na hodnotu Povolit.
Zrušení, importovat ani přejmenovat typy pracovních položek, musí být členem skupiny Správci serveru Team Foundation skupiny zabezpečení nebo Správci projektů skupiny zabezpečení.

Další informace naleznete v tématu Oprávnění v prostředí Team Foundation Server.

Poznámka

I když se přihlásíte s oprávněními pro správu, je nutné otevřít okno příkazového řádku se zvýšenými oprávněními k provedení této funkce na serveru, který je spuštěn Windows Server 2008.Otevřete okno příkazového řádku se zvýšenými oprávněními, zvolte Start, otevřete místní nabídku pro Příkazový řádek, a poté zvolte možnost Spustit jako správce.Další informace naleznete na webu společnosti Microsoft: řízení přístupu uživatele.

witadmin destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]

witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportglobalists]

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

witadmin listwitd /collection:CollectionURL /p:Project

witadmin renamewitd /collection:CollectionURL /p:Project /n:TypeName /new:NewName [/noprompt]

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: Projekt	Týmový projekt, pro které mají být spravovány typy pracovních položek. Tento týmový projekt musí být definovány v kolekci projektu určené /collection parametru. /p Parametr je povinný, pouze pokud spustíte importwitd s /v možnost.
/n: TypeName	Název typu pracovní položky zničit, exportovat, importovat ani přejmenovat.
/f: FileName	Cesta a název souboru definice XML, který obsahuje typy pracovních položek, které mají být exportovány nebo importovány. Je-li tento parametr vynecháte při použití exportwitd příkazu XML se zobrazí v okně příkazového řádku. Poznámka Pokud používáte Windows Vista nemáte oprávnění k určitým složkám.Pokud se pokusíte export typ pracovní položky do umístění, kde nemáte oprávnění, virtualizačních technologiích registru automaticky přesměruje exportovaný soubor a uloží jej do virtuálního úložiště.Chcete-li předejít toto přesměrování, můžete exportovat soubor do umístění, ve které máte oprávnění. Další informace o Virtualizace registru, naleznete na webu společnosti Microsoft: Virtualizace registru a běžné problémy s virtualizací souborů a registru v systému Windows Vista.
/e: Kódování	Název .NET Framework 2.0 Formát kódování. Příkaz, který používá uvedené kódování pro export a import 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.
/exportgloballists	Exportuje definice globální seznamy odkazuje typ pracovní položky. Definice pro globální seznamy budou vloženy do definici pracovní položky typu XML. Pokud není zadáno, jsou vynechány definice pro globální seznamy.
/v	Ověří kód XML, který definuje typ pracovní položky, ale neproběhne import souboru XML definice. Poznámka Definice typu je možné ověřit bez určení týmový projekt.Odkazy na projekt obor skupiny je ignorován.
/new: Admin	Nový název typ pracovní položky.
/noprompt	Zakáže výzvu k potvrzení.
/? nebo help	Zobrazí nápovědu o příkaz v okně příkazového řádku.

Poznámky

Používáte-li destroywitd příkazu ji odstraní všechny následující objekty:

Typ pracovní položky
Všechny pracovní položky daného typu
Odpovídající položky v tabulkách pracovní položky, dlouhá textová tabulky a propojit tabulky
Objekty v mezipaměti metadat typ pracovní položky

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: myworkitems.xml
Název typu pracovních položek: myworkitem
Výchozí kódování: UTF-8

Exportovat definici kon

Následující příkaz exportuje definici myworkitem do souboru myworkitems.xml.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem

Následující příklad exportuje pracovní položky pomocí kódování Unicode (UTF-7).

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7

Exportovat definici kon a jeho odkazované globální seznamy

Následující příklad exportuje typ pracovní položky a jeho odkazované globální seznamy.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists

Seznam definice kon

Následující příklad ukazuje definici typ pracovní položky okno příkazového řádku.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /n:myworkitem

Importovat definici WITs

Následující příklad importuje definici pracovní položky ze souboru XML.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks

Ověření definici XML kon

Následující příklad ověří kód XML, který definuje typ pracovní položky, ale není import definice.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v

Dotazy a odpovědi

D: jaké úpravy lze provádět a nadále používat funkce Průvodce konfigurací aktualizace svůj týmový projekt po upgradu sady TFS?

O: můžete přidat vlastní WITs a změnit rozložení formuláře. Průvodce konfigurací funkce aktualizujeme týmové projekty a získáte přístup k nejnovější funkce.

Změna pracovního postupu nebo přejmenování kon může být nutné provést některé ručně prováděné operace při aktualizaci vašeho týmového projektu. Chcete-li zjistit, o které úpravy bezpečně můžete provést, a který neměli byste, naleznete v části Přizpůsobit pracovní Sledování zkušeností: dříve, než můžete přizpůsobit, pochopit, údržbu a upgrade důsledky.

D: jak ji změním barvu přidružený ŽÁ?

O: ve výsledcích dotazu a na stránkách nevyřízenými položkami a panely nástrojů pro agilní plánování se zobrazí v Team Web Access pracovní položky. Chcete-li změnit barvu přidružené k existující ŽÁ nebo přidat barvu, která má být použit pro nové s inst, Upravit konfiguraci procesu.

Color assignments to different work item types

D: Jak lze deaktivovat nebo zakázat WIT?Jak lze zabránit uživatelům ve vytváření pracovní položky určitého typu?

O: Pokud máte s inst, který chcete vyřadit, ale udržovat pracovní položky, které byly vytvořeny podle typu, můžete přidat pravidlo, které zakáže všechny platné uživatelů ukládat typ pracovní položky.

<TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER not="[Team Project Name]Project Valid Users" />
     </FIELD>
   </FIELDS>
</TRANSITION>

Pokud chcete omezit vytváření specifických WIT na skupinu uživatelů, existují dva způsoby, jak omezit přístup:

Přidat do skupiny skrytá kategorií kon většinu přispěvatelé zabránit jejich vytvoření. Pokud chcete povolit skupinu uživatelů přístup, můžete můžete vytvořit hypertextový odkaz na šablonu otevře formulář pracovní položky a sdílené složky, které propojit s těmito členy týmu, kteří chtějí je vytvořit.
Přidat pravidlo pro pole do pracovního postupu pro pole System.CreatedBy a efektivně vytvářet pracovní položku určitého typu omezit skupinu uživatelů. Následující příklad ukazuje, uživatele, který vytváří pracovní položku musí patřit do Allowed Group za účelem ukládání pracovní položku.
```
<TRANSITION from=" " to="New">
   <FIELDS>
     <FIELD refname="System.CreatedBy">
         <VALIDUSER for="Allowed Group" not="Disallowed Group" />
     </FIELD>
   </FIELDS>
</TRANSITION> 
```

D: Jak lze odstranit nový WIT?

O: Pokud chcete zabránit pomocí konkrétní ŽÁ Chcete-li vytvořit pracovní položku členy týmu, můžete jej odebrat z týmového projektu. Při použití witadmin destroywitd, trvale odebrat všechny pracovní položky, které byly vytvořeny pomocí tohoto ŽÁ, jakož i s inst samotného. Pokud váš tým například nepoužívá položku „Překážka“, můžete z projektu webové stránky Fabrikam odstranit WIT označený jako „Překážka“.

witadmin destroywitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"Impediment"

Při odstranění WIT, který patří do kategorie, musíte aktualizovat definici kategorií pro týmový projekt tak, aby odrážela nový název. Zejména agilní nástroje pro plánování nebude fungovat, dokud aktualizovat definice kategorií.

Další informace naleznete v tématu Import and export categories [witadmin].

Viz také

Sdílet prostřednictvím