Sdílet prostřednictvím

Define pick lists

  • Článek

Můžete vytvořit výčet sady hodnot pro pole tak, že definujete rozevírací seznam v rámci dané definice nebo v určitém okamžiku během pracovní postup. Můžete použít seznam může obsahovat pouze povolené hodnoty, nemůže obsahovat zakázané hodnoty nebo můžete navrhnout hodnoty. Pokud navrhnete hodnoty, mohou uživatelé zadat hodnotu jiných programů v seznamu výběr.

Můžete také definovat seznamů pro výběr závislé, ve kterých definujete dvě nebo více seznamů pro pole, ale pouze jeden seznam se objeví v době běhu na základě vyhodnocení podmíněného pravidla.

V tomto tématu

  • Syntaxe struktury

  • Syntaxe strukturu pro GLOBALLIST a LISTITEM elementy

  • Povolit existující hodnotu

  • Zadejte sadu povolených hodnot

  • Definovat seznamů pro výběr závislé

Poznámka

Přidávat nebo upravovat seznam pro výběr FIELD definice, použijte witadmin nástroj příkazového řádku pro import a export definici pro typ pracovní položky.Podívejte se na téma Import, export, and manage work item types [witadmin].

Syntaxe struktury

Můžete použít ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky, které mají-li určit seznam hodnot, které musí uživatel určit, může zadat nebo nesmí určovat jako hodnota pro pole. Používáte-li každý z těchto elementů, můžete vytvořit výčet seznam položek, nebo zadat globální seznam. Můžete použít ALLOWEXISTINGVALUE Chcete, aby pole pro uložení existující hodnoty, je-li odebrat položku z rozevíracího seznamu.

Tyto prvky můžete určit jako podřízené prvky FIELD (definice) nebo FIELD element (pracovní postup).

  • Použijete ALLOWEDVALUES definovat seznam hodnot, které mohou uživatelé formuláře pracovních položek, nebo editor dotazů. Jedna z hodnot v musí uživatelé zadat GLOBALLIST nebo sadu LISTITEM položky.

    <ALLOWEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName" />
   <LISTITEM value="Name1" />
   <LISTITEM value="Name2" />
   <LISTITEM value="Name3" />
. . . 
</ALLOWEDVALUES>

  • Použijete PROHIBITEDVALUES definovat seznam hodnot, které nemohou obsahovat pole. Uživatele nelze uložit pracovní položky, je-li toto pole obsahuje zakázané hodnoty. Tento element použít, pokud chcete omezit používání hodnotu, která byla dříve povolen, ale již není platná.

    <PROHIBITEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName" />
   <LISTITEM value="Name1" />
   <LISTITEM value="Name2" />
   <LISTITEM value="Name3" />
. . . 
</PROHIBITEDVALUES>

  • Použijete SUGGESTEDVALUES definovat seznam hodnot, které mohou obsahovat pole. Uživatelé mohou určit další hodnoty kromě těch, které můžete navrhnout.

    <SUGGESTEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName" />
   <LISTITEM value="Name1" />
   <LISTITEM value="Name2" />
   <LISTITEM value="Name3" />
. . . 
</SUGGESTEDVALUES>

Pro každé z těchto elementů můžete zadat jednu nebo více atributů, které jsou popsány v následující tabulce:

Atribut

Popis

for

Volitelné. Určuje název uživatele nebo skupinu v Team Foundation do kterého bude pravidlo použito. Platný název se skládá z řetězce text, který obsahuje mezi 1 až 255 znaků.

Hodnota vzorku: ^ [^ \\] + \\ [^ \\] + $

Příklad hodnoty vzor: domény/UserID

not

Volitelné. Určuje název uživatele nebo skupinu v Team Foundation na kterému pravidlo nevztahuje. Platný název se skládá z řetězce text, který obsahuje mezi 1 až 255 znaků.

Hodnota vzorku: ^ [^ \\] + \\ [^ \\] + $

Příklad hodnoty vzor: domény/UserID

expanditems

Volitelné. Určuje, zda skupina stanoví LISTITEM elementu by měl být rozbaleny tak, aby obsahoval podřízené skupiny v seznamu. Výchozí hodnota je true.

filteritems

Volitelné. Určuje, zda seznam obsahuje pouze členové skupiny, nikoli pro názvy skupin. Jediná platná hodnota tohoto atributu je excludegroups.

Další informace naleznete v tématu Expand list items and exclude groups from lists.

Struktura syntaxe pro GLOBALLIST a LISTITEM prvky

Můžete použít GLOBALLIST a LISTITEM prvky pro vytvoření výčtu seznam položek, které mohou být aktualizovány globálně nebo které jsou specifické pro jedno pole.

  • Použijete GLOBALLIST definovat sadu LISTITEM kolekce a všech týmových projektů v tom, můžete použít kolekce projektu elementů, u nichž je uložen pro tým. GLOBALLIST je povinný podřízený element elementu GLOBALLISTS element a volitelný podřízený prvek ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES elementů. Můžete definovat globální seznam v rámci definici pracovní položky, definice globálního seznamu nebo globální pracovního postupu.

    <GLOBALLIST name="globalListName">
   <LISTITEM value="Name1" />
   <LISTITEM value="Name2" />
   <LISTITEM value="Name3" />
. . . 
</GLOBALLIST>

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

    Důležité

    Pokud definujete globální seznam v souboru XML, který definuje typ pracovní položky, musíte předat seznamu jedinečný název.V ostatních případech mohou přepsat stávající seznam, který byl definován pro kolekci.

  • Použijete LISTITEM výčet sady hodnot. LISTITEM je povinný podřízený element elementu GLOBALLIST a volitelný podřízený prvek ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES elementů.

    <LISTITEM value="listName" />

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

Povolit existující hodnotu

Můžete použít ALLOWEXISTINGVALUE elementu, který chcete povolit pole, které chcete zachovat existující hodnoty, po zadání výběr seznam položek s použitím ALLOWEDVALUES elementu. Pokud nezadáte ALLOWEXISTINGVALUE elementu, vynutit uživatelem, v době úpravy, zadejte jeden z aktuální platné hodnoty pro toto pole. ALLOWEXISTINGVALUE Element upraví pouze elementy ve stejném bloku.

<ALLOWEXISTINGVALUE />

Zadejte tento element v části FIELD (pracovní postup) elementu, který chcete použít i pro pravidla, která jsou definována pro pole. Tato aplikace obsahuje pravidla, STATE, TRANSITION, DEFAULTREASON, a REASON prvků pole zadejte. Zadejte tento element v části STATE elementu, který chcete použít nejen pravidla, která jsou definována ve stavu pro pole, ale také pravidel, která jsou definována pro pole pro všechny přechody do stavu.

Zadejte tento element v části TRANSITION elementu, který chcete použít nejen pravidla, která jsou definována v přechodu pro pole, ale také pravidel, která jsou definována v poli REASON a DEFAULTREASON elementů.

Zadat seznam

Zobrazí pole se skládají ze seznamu jednotlivých položek. Každý seznam polí musí obsahovat alespoň jednu položku.

Poznámka

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

Chcete-li určit položky v seznamu polí, použijte <LISTITEM value=""> elementu. Je možné zadat řetězec, uživatelské jméno nebo název skupiny.

<LISTITEM value="Emergency"/>
<LISTITEM value="Major"/>
<LISTITEM value="Minor"/>
<LISTITEM value="Domain\joe"/>
<LISTITEM value="[Global]\GlobalGroup" />
<LISTITEM value="[Project]\ProjectGroup" />

Poznámka

V době běhu položky v seznamu se zobrazí abecedně na základě jazyka serveru, který je spuštěn Visual Studio Team Foundation Server.

Zadejte sadu povolených hodnot

V tomto příkladu pole závažnost zákazník může mít některou ze tří hodnot: naléhavé, hlavní i vedlejší. Pole je definováno podle potřeby s výchozí hodnotou podverze. V době běhu mohou uživatelé jedna z hodnot v rozevíracím seznamu.

<FIELD refname="System.Title" name="Title" type="String">
<HELPTEXT>Provide a brief description of the work item</HELPTEXT>
<REQUIRED/>
</FIELD>
<FIELD refname="MyCorp.CusSeverity" name="Customer Severity" type="String">
<HELPTEXT>Indicate the severity of the problem</HELPTEXT>
    <ALLOWEDVALUES>
        <LISTITEM value="Emergency">
        <LISTITEM value="Major">
        <LISTITEM value="Minor">
    </ALLOWEDVALUES>
<DEFAULT from="value" value="Minor"/>
</FIELD>

Definovat seznamů pro výběr závislé

Můžete definovat Výběr seznamu, který je aktivní pouze v případě, že jeho nadřazený podmíněné klauzule je true. V následujícím příkladu dvou sad v seznamu položky jsou definovány pro mé pole. Pouze jeden seznam je zobrazen v době běhu závislosti na tom, zda je přiřazen požadavky MyCompany.MyTeam.Discipline pole.

Poznámka

WHEN a WHENNOT pravidla v tomto příkladu můžete také použít pro ostatní pravidla k určení, kdy by měl být vyhodnocen tato pravidla.Další informace naleznete v tématu Assign conditional-based values and rules.

<FIELD name="My Field" refname="MyCompany.MyProcess.MyField" type="String" reportable="dimension">
  <WHEN field="MyCompany.MyTeam.Discipline" value="Requirements">
    <ALLOWEDVALUES>
      <LISTITEM value="Planning" />
      <LISTITEM value="Review" />
    </ALLOWEDVALUES>
  </WHEN>
  <WHENNOT field=" MyCompany.MyTeam.Discipline" value="Requirements">
    <ALLOWEDVALUES>
      <LISTITEM value="Process Management" />
      <LISTITEM value="Planning" />
      <LISTITEM value="Review" />
    </ALLOWEDVALUES>
  </WHENNOT>
</FIELD>

Viz také

Další zdroje

Work item tracking: Index to XML element definitions

Modify or add a field to support queries, reports, and workflow