Manage global lists for work item types [witadmin]
Globální seznamy jsou seznamů pro výběr, které můžete zahrnout do jednoho či více polí a typy pracovních položek. Používají se pro minimalizaci práci, kterou je třeba, aby aktualizovat seznam, který je sdílen s více typů pracovních položek. Vzhledem k tomu, že globální seznamy jsou definovány pro kolekci týmového projektu, mohou být součástí typy pracovních položek pro všechny týmové projekty v rámci kolekce.
Globální seznam v rámci vlastní soubor definice můžete definovat v souboru definice pro typ pracovní položky, nebo v globální pracovního postupu. Definice globální seznam spravuje globální seznamy, které jsou definovány pro kolekci. Definice globální seznam používá následující příkazy witadmin nástroj příkazového řádku:
destroygloballist: Ničí globálního seznamu.
exportgloballist: Vyexportuje globální seznamy do souboru XML, nebo okno příkazového řádku. Exportuje jeden soubor, který obsahuje všechny globální seznamy, které byly definovány pro kolekce týmových projektů.
importgloballist: Importuje globální seznamy ze souboru XML. Pokud se pokusíte importovat globální seznam, který již existuje na serveru, žádá varování, pokud ji chcete přepsat globální seznam, který je na serveru. Pokud se pokusíte importovat globální seznam, který ještě neexistuje, příkaz vytvoří novou globální seznam.
listgloballist: Zobrazí název každé globální seznam definován na serveru.
Podívejte se na téma Define global lists a Customize global workflow.
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
V 64bitové verzi systému Windows, nahradit %programfiles% s %programfiles(x86)%.
Poznámka
Můžete vytvořit a upravit globální seznamy pomocí procesu Editor, nástroj power pro Visual Studio.Další informace naleznete v tématu Team Foundation Server výkonné nástroje.
Požadavky
Pro kolekce týmových projektů, kde jsou definovány globální seznamy, musí mít následující oprávnění nastavit:
Pokud chcete exportovat nebo seznam globálních seznamů, musí být členem skupiny uživatele platný kolekce projektu skupině nebo jste své Zobrazit informace na úrovni kolekce oprávnění nastaven na hodnotu Povolit.
Importovat globální seznamy, musí být členem skupiny Správci projektů zabezpečení seskupení nebo jste své Upravit informace na úrovni projektu oprávnění nastaven na hodnotu Povolit.
Zrušení globální seznam pomocí se witadmin destroygloballist, musí být členem skupiny správce kolekce projektu zabezpečení seskupení nebo mít vaše Upravit informace na úrovni kolekce oprávnění nastaven na hodnotu Povolit.
Podívejte se na téma 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, spusťte Příkazový řádek místní okno a zvolte možnost Spustit jako správce.Další informace naleznete v části této stránky na webu společnosti Microsoft: řízení přístupu uživatele.
witadmin destroygloballist /collection:CollectionURL /n:GlobalListName [/noprompt] [/force]
witadmin exportgloballist /collection:CollectionURL [/f:FileName] [/e:Encoding]
witadmin importgloballist /collection:CollectionURL /f:FileName [/e:Encoding]
witadmin listgloballist /collection:CollectionURL
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. |
/n:GlobalListName |
Název globální seznam zničit. |
/f:FileName |
Cesta a název souboru globální seznam XML definice pro export a import.
Poznámka
Pokud je spuštěn v klientském počítači Windows Vista, nemáte oprávnění k určitým složkám.Pokud se pokusíte globální seznam exportovat 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ě.Další informace získáte na následujících stránkách na webu společnosti Microsoft: Virtualizace registru a běžné problémy s virtualizací souborů a registru v systému Windows Vista.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í.
|
/e:Encoding |
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. |
/noprompt |
Zakáže výzvu k potvrzení. |
/? nebo help |
Zobrazí nápovědu o příkaz v okně příkazového řádku. |
Poznámky
Seznam importu globální seznam vytvoří, pokud neexistuje. Pokud již existuje v seznamu, witadmin importgloballist příkaz upozornění, že aktuální seznam bude přepsán. Můžete napsat vlastní program aktualizovat existující globální seznam, nebo můžete aktualizovat globální seznam sami nová data.
Chcete-li vytvořit novou globální seznam, začít s následujícím kódem a podle potřeby změnit. Tento příklad definuje globální seznam oborů, které můžete přiřadit k úkolům.
<?xml version="1.0" encoding="utf-8"?>
<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/globallists">
<GLOBALLIST name="Disciplines">
<LISTITEM value="Architecture" />
<LISTITEM value="Requirements" />
<LISTITEM value="Development" />
<LISTITEM value="Release Management" />
<LISTITEM value="Project Management" />
<LISTITEM value="Test" />
</GLOBALLIST>
</gl:GLOBALLISTS>
Skupiny zabezpečení vymezenou projektu v rámci globální seznam, nejsou zahrnuty, protože globální seznamy jsou zaměřeny na kolekci a nikoli v projektu.
Chcete-li přidat globální seznam do pole, exportovat definici pro typ pracovní položky, která obsahuje pole a ho přidat do definici pole, jak je znázorněno v následujícím příkladu:
<FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
<HELPTEXT>The discipline to which the task belongs</HELPTEXT>
<ALLOWEDVALUES>
<GLOBALLIST name="Disciplines" />
</ALLOWEDVALUES>
</FIELD>
Chcete-li zobrazit změny, importovat definice typu a aktualizovat prohlížeči nebo v mezipaměti klienta. Je nutné zavřít všechny pracovní položky, které odkazují na pole a znovu otevřít.
Informace o exportu a importu definice typu naleznete v tématu Import, export, and manage work item types [witadmin].
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
Číslo portu serveru webu: 8080
Zobrazit názvy globální seznamy
Následující příklad ukazuje globální seznamy definované na serveru. V příkladu exportuje globální seznamy pomocí výchozí kódování UTF-8:
witadmin listgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
Exportovat definici globální seznamy
Následující příklad exportuje globální seznamy:
witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml
Následující příklad exportuje stejný globální seznamy na stejný server, ale používá kódování Unicode (UTF-7):
witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e:utf-7
Importovat definici globální seznamy
Následující příklad importuje globální seznamy:
witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml
Následující příklad importuje stejný globální seznamy na stejný server, ale používá kódování Unicode (UTF-7):
witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e utf-7