Správa globálních seznamů pro typy pracovních položek
Globální seznamy jsou seznamy s výběrem, které můžete přidat k jednomu či více polí nebo typů pracovních položek.Použijte je k minimalizaci práce, které je třeba k aktualizaci seznamu, který je sdílen více typy pracovních položek.Vzhledem k tomu, že globální seznamy jsou definovány pro kolekci týmových projektů, mohou být součástí typů pracovních položek pro všechny týmové projekty v rámci kolekce.
[!POZNÁMKA]
Globální seznamy nesmí obsahovat skupiny zabezpečení v rozsahu projektu, protože globální seznamy stejný rozsah, jako týmový projekt.
Můžete definovat globální seznam v rámci vlastního souboru definice pro typ pracovní položky nebo v globálním pracovního postupu.Definice globálního seznamu spravuje globální seznamy, které jsou definovány pro kolekci.Definice globálního seznamu používá následující příkazy v nástroji witadmin příkazového řádku:
destroygloballist: Odstraní globální seznam.
exportgloballist: Exportuje globální seznamy do souboru XML nebo do okna příkazového řádku.Bude exportován jeden soubor, který obsahuje všechny globální seznamy, které byly definovány pro kolekci týmových projektů.
importgloballist: Importuje globální seznamy ze souboru XML.Pokud se pokusíte importovat globální seznam, který již na serveru existuje, upozornění se vás dotáže, zda chcete přepsat globální seznam, který je na serveru.Jestliže se pokusíte importovat globální seznam, který ještě neexistuje, příkaz vytvoří nový globální seznam.
listgloballist: Zobrazí název každého globálního seznamu definovaného na serveru.
Více o tématu v Definování globálních seznamů a Přizpůsobení globálního pracovního postupu.
Chcete-li spustit nástroj příkazového řádku witadmin, otevřete okno příkazového řádku, kde je nainstalován buď Visual Studio nebo Průzkumník týmových projektů a zadejte:
cd %programfiles%\Microsoft Visual Studio 12.0\Common7\IDE
V 64bitové verzi systému Windows nahraďte %programfiles% za %programfiles(x86)%..
[!POZNÁMKA]
Můžete vytvořit a upravit globální seznamy pomocí editoru procesu, nástroje power tool pro Visual Studio.Tento nástroj není podporován.Další informace naleznete na následující stránce na webu společnosti Microsoft: Nástroje Team Foundation Serveru.
Požadavky
Pro kolekci týmového projektu, kde jsou definovány globální seznamy, musíte mít následující sadu oprávnění:
Chcete-li exportovat nebo zobrazit globální seznamy, musíte být členem skupiny Platní uživatelé kolekce projektu nebo mít oprávnění Zobrazit informace na úrovni kolekce nastaveno na Povolit
Chcete-li zničit nebo importovat globální seznamy, musíte být členem skupiny zabezpečení Správci serveru Team Foundation nebo Správci projektu.
Více o tématu v Oprávnění v prostředí Team Foundation Server a Výchozí skupiny, oprávnění a role serveru Team Foundation Server.
[!POZNÁMKA]
I v případě, že se přihlásíte s oprávněními správce, je nutné otevřít okno příkazového řádku se zvýšenými oprávněními, abyste tuto funkci mohli provést na serveru se systémem Windows Server 2008.Chcete-li otevřít okno příkazového řádku se zvýšenými oprávněními, zvolte nabídku Start, otevřete místní nabídku pro příkazový řádeka pak zvolte možnost Spustit jako správce.Další informace naleznete na této stránce na webu společnosti Microsoft: Ovládání uživatelského přístupu.
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 |
Description |
|---|---|
/collection:CollectionURL |
Určuje URI kolekce týmového projektu.Formát identifikátoru URI je následující: http://ServerName:Port/VirtualDirectoryName/CollectionName Pokud není použit žádný virtuální adresář, formát identifikátoru URI je následující: http://ServerName:Port/CollectionName. |
/n:GlobalListName |
Název globálního seznamu k odebrání. |
/f:FileName |
Cesta a název souboru XML definice globálního seznamu k exportu nebo importu.
|
/e:Encoding |
Název formátu kódování .NET Framework 2,0.Uvedené kódování se použije k exportu nebo importu dat XML.Například /e utf-7 určuje kódování Unicode (UTF-7).Pokud tento parametr vynecháte, witadmin se pokusí rozpoznat kódování, a pokud se nezdaří detekce, witadmin použije kódování UTF-8. |
/noprompt |
Zakáže výzvu k potvrzení. |
/? nebo help |
Zobrazí nápovědu k příkazu v okně příkazového řádku. |
Poznámky
Import globálního seznamu vytvoří seznam, pokud ještě neexistuje.Pokud seznam již existuje, příkaz witadmin importgloballist vás upozorní, že bude aktuální seznam přepsán.Můžete napsat vlastní program k aktualizaci existujícího globálního seznamu nebo můžete globální seznam také aktualizovat sami s novými daty.
Chcete-li vytvořit nový globální seznam, spusťte následující kód a podle potřeby upravte.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>
Chcete-li přidat globální seznam do pole, exportujte definici pro typ pracovní položky, která obsahuje pole, a přidejte 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, importujte definici typu a aktualizujte prohlížeč nebo v mezipaměť klienta.Pravděpodobně je třeba zavřít všechny pracovní položky, které odkazují na pole, a znovu je otevřít.
Informace o exportu a importu definic typu naleznete zde: Import, export a správa typů pracovních položek [witadmin].
Příklady
Pokud není uvedeno jinak, platí následující hodnoty v obou příkladech:
Adresa URI kolekce týmového projektu: http://AdventureWorksServer:8080/tfs/DefaultCollection
Číslo portu pro server webu: 8080
Zobrazení názvů globálních seznamů
Následující příklad ukazuje globální seznamy definované na serveru.Příklad exportuje globální seznamy pomocí výchozího kódování UTF-8:
witadmin listgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection
Exportovat definici globálních seznamů
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
Import definice globálních seznamů
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