Define global lists

Článek
09/11/2015

S použitím globální seznamy v Team Foundation Server (TFS), můžete minimalizovat práci, kterou je třeba aktualizovat seznam, který se zobrazí v definicích několik typů pracovních položek (WITs). Globální seznamy jsou seznamů pro výběr zahrnující v rámci jednoho nebo více polí a ŽÁ definice. Můžete definovat globální seznam v rámci ŽÁ, který přidáte do týmového projektu, jako globální seznam pro kolekci týmového projektu nebo v rámci globální pracovního postupu. Seznam položek mezi několika WITs pro kolekci můžete sdílet tak, že uvedete seznam položek v jednom nebo více GLOBALLIST elementy.

Také můžete definovat WITs, můžete zjistit, že některá pole sdílet stejné hodnoty. Často můžete sdílet v rámci několika WITs a to i přes několik týmové projekty. Některé z těchto hodnot, jako je číslo sestavení kódu sestavení, často měnit, což vyžaduje, aby správci často aktualizovat seznamy v mnoha umístění. Globální seznamy může být užitečná, pokud seznam musí být odvozen z externího systému. Předpokládejme, že společnost udržuje samostatnou databázi zákazníka. Při archivaci chyby, které na základě zjištěných jméno zákazníka je zadán do vlastní Found By Customer pole.

Můžete spravovat globální seznamy pro kolekci jako soubor XML, který můžete seznam, importovat, exportovat a odstranit. Název každé globální seznam může mít maximálně 254 znaky znakové sady Unicode a musí být jedinečné v rámci kolekce.

Poznámka

Neexistují žádné definované v systému globální seznamy ani předdefinované globální seznamy v výchozí šablony procesu, které poskytuje sady TFS.

Požadavky

Pokud chcete exportovat nebo seznam globálních seznamů, musí být členem skupiny uživatele platný kolekce projektu nebo vaše zobrazení informace na úrovni kolekce oprávnění nastavena na možnost povolit.
Chcete-li definovat nebo upravit globální seznamy, musí být členem skupiny Administrators projektu nebo mít oprávnění k úpravám informace na úrovni projektu nastavena na možnost povolit.
Chcete-li přidat nebo upravit globální seznam, použijte witadmin nástroj příkazového řádku pro import a export definice pro globální seznamy. Podívejte se na téma Manage global lists for work item types [witadmin]. Použít globální seznam, přidejte ji FIELD definice v rámci typ pracovní položky. Podívejte se na téma All FIELD XML elements reference.

Přidat a spravovat globální seznamy

Globální seznam je sada LISTITEM prvky, které jsou uloženy a používány globálně ve všech projektech týmu v kolekci. Globální seznamy jsou užitečné pro pole, které jsou definovány v rámci několik typů pracovních položek, například operačním systémem, v sestavení najít a opravit v sestavení.

Globální seznamů a jejich položek můžete definovat pomocí jedné z následujících způsobů:

Týmu kolekce projektu: můžete exportovat, upravit, odstranit a importovat globální seznamy, které jsou definovány pro kolekci týmového projektu. Tyto globální seznamy jsou k dispozici pro všechny týmové projekty v kolekci.
Pracovní položka definice typu: Po vytvoření týmový projekt, můžete přidat globální seznamy, které chcete mít k dispozici pro typ pracovní položky k jeho definici.
Definice globální pracovního postupu: Po vytvoření týmový projekt, můžete přidat globální seznamy, které chcete mít k dispozici pro všechny typy pracovních položek na definici globální pracovního postupu pro týmový projekt nebo kolekci. Další informace naleznete v tématu Customize global workflow.

Syntaxe struktury

V následující tabulce jsou uvedeny GLOBALLIST a LISTITEM elementů. Tyto prvky slouží k vytvoření výčtu seznam hodnot, který je se uživateli zobrazí jako rozevírací seznam nebo rozevírací nabídky položek.

Element	Syntaxe	Popis
GLOBALLIST	`<GLOBALLIST name="globalListName"> <LISTITEM> . . . </LISTITEM> </GLOBALLIST>`	Definuje sadu LISTITEM prvků, která je uložena v rámci kolekce a, můžete použít všechny týmové projekty v kolekci. globalListName: řetězec textu, který obsahuje mezi 1 až 255 znaků. GLOBALLIST je povinný podřízený element elementu GLOBALLISTS element a volitelný podřízený prvek ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES elementů. Další informace naleznete v tématu Define pick lists.
LISTITEM	`<LISTITEM value="Name" />`	Definuje platnou položku seznamu. Poznámka Globální seznamy nesmí obsahovat projektu obor skupiny, vzhledem k tomu, že nejsou s oborem do projektu. LISTITEM je povinný podřízený element elementu GLOBALLIST a volitelný podřízený prvek ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES elementů.

Element

Syntaxe

Popis

GLOBALLIST

<GLOBALLIST name="globalListName">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>

Definuje sadu LISTITEM prvků, která je uložena v rámci kolekce a, můžete použít všechny týmové projekty v kolekci.

globalListName: řetězec textu, který obsahuje mezi 1 až 255 znaků.

GLOBALLIST je povinný podřízený element elementu GLOBALLISTS element a volitelný podřízený prvek ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES elementů. Další informace naleznete v tématu Define pick lists.

LISTITEM

<LISTITEM value="Name" />

Definuje platnou položku seznamu.

Poznámka

Globální seznamy nesmí obsahovat projektu obor skupiny, vzhledem k tomu, že nejsou s oborem do projektu.

LISTITEM je povinný podřízený element elementu GLOBALLIST a volitelný podřízený prvek ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES elementů.

Globální seznam ukázky

Přidáním následující syntaxe můžete definovat globální seznam v souboru XML definice pro typ pracovní položky či globální pracovního postupu:

<GLOBALLISTS>
    <GLOBALLIST name="name of global list">
        <LISTITEM value="List item 1" />
        <LISTITEM value="List item 2" />
        <LISTITEM value="List item 3" />
        <LISTITEM value="List item 4" />
        . . .
        <LISTITEM value="List item n" />
    </GLOBALLIST>
</GLOBALLISTS>

Pomocí následující syntaxe můžete odkazuje na globální seznam v souboru XML definice pro typ pracovní položky:

<GLOBALLISTS>
   <GLOBALLIST name=" name of global list 1" />
   <GLOBALLIST name=" name of global list 2" />
   . . .
   <GLOBALLIST name=" name of global list n" />
</GLOBALLISTS>

Informace o struktuře a umístění souboru definice pro typy pracovní položky nebo globální pracovního postupu naleznete v tématu All WITD XML elements reference nebo Referenční dokumentace XML elementů globálních pracovních postupů, v tomto pořadí.

Ukázky globální seznam udržovat v rámci kolekce projektu

Pokud chcete přidat globální seznam kolekce projektu, můžete importovat pomocí následující syntaxe witadmin importgloballist příkazu:

<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/globallists">
    <GLOBALLIST name="NameOfGlobalList">
        <LISTITEM value="ListItem1" />
        <LISTITEM value="ListItem2" />
        <LISTITEM value="ListItem3" />
        <LISTITEM value="ListItem4" />
        . . .
        <LISTITEM value="ListItemN" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

Globální seznam nemůže být prázdný. Každý GLOBALLIST element musí obsahovat alespoň jeden LISTITEM element definovaný.

Dotazy a odpovědi

D: jsou všechny globální seznamy automaticky vyplněna s daty?

A: Yes. Globální seznam s názvem sestavení – TeamProjectName získá připojenou pokaždé, když je spuštěna sestavení. V průběhu času v seznamu se může stát velmi dlouhé. Je doporučeno pravidelně odebrat nepoužívané položky ze seznamu.

Další informace o použití tohoto seznamu naleznete v tématu Fields that support integration with test, build, and version control.

Sdílet prostřednictvím

Define global lists

Přidat a spravovat globální seznamy

Syntaxe struktury

Globální seznam ukázky

Ukázky globální seznam udržovat v rámci kolekce projektu

Dotazy a odpovědi

D: jsou všechny globální seznamy automaticky vyplněna s daty?

Viz také

Referenční dokumentace

Koncepty

Další materiály