Definování rozevíracích seznamů

Článek
06/09/2015

Výčet sady hodnot pro pole lze zobrazit tak, že definujete rozevírací seznam v rámci dané definice nebo v určitém okamžiku během pracovní postup.Zadaný 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 osob v seznamu výběr.

Také můžete zadat seznamů pro výběr závislé, ve kterých definujete dva 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

Struktura syntaxe
Struktura syntaxe pro GLOBALLIST a LISTITEM prvky
Povolit stávající hodnota
Určit 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 definicí, použijte witadmin nástroje příkazového řádku pro import a export definici pro typ pracovní položky.Další informace naleznete v tématu Import, export a správa typů pracovních položek [witadmin].

Struktura syntaxe

Můžete použít ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky k určení seznam hodnot, které uživatel musí zadat, může specifikovat, nebo nesmí jako hodnota pro pole.Používáte-li každý z těchto prvků, 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í hodnotu, je-li odebrat položku z rozevíracího seznamu.

Tyto prvky můžete zadat jako podřízených elementů 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é nemůže obsahovat pole.Je-li toto pole obsahuje hodnotu zakázané nemohou uživatelé uložit pracovní položku.Tento prvek 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 prvků můžete určit 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 skupiny 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 znaky. Hodnota vzorku: ^ [^ \\] + \\ [^ \\] + $ Příklad hodnoty vzor: domény/ID uživatele
not	Volitelné.Určuje název uživatele nebo skupiny v Team Foundation na kterému pravidlo nevztahuje.Platný název se skládá z řetězce text, který obsahuje mezi 1 až 255 znaky. Hodnota vzorku: ^ [^ \\] + \\ [^ \\] + $ Příklad hodnoty vzor: domény/ID uživatele
expanditems	Volitelné.Určuje, zda v identifikovat skupinu LISTITEM element by měl být rozbaleny pro zahrnutí podřízených skupin v seznamu.Výchozí hodnota je true.
filteritems	Volitelné.Určuje, zda seznam obsahuje pouze členové skupiny, nikoli pro názvy skupin.Je platný pouze hodnota tohoto atributu excludegroups.

Další informace naleznete v tématu Rozbalení položek seznamu a vyloučení skupin ze seznamů.

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, že můžete použít kolekce projektu prvky, které jsou uloženy pro tým.GLOBALLISTje třeba zadat podřízeného prvku GLOBALLISTS elementu a volitelné podřízeného prvku ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky.Můžete definovat globální seznam v rámci definici pracovní položky, definici globální seznam 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 znaky.

Důležité
Seznam globálních definujete v souboru XML, který definuje typ pracovní položky, je třeba zadat seznamu jedinečný název.V ostatních případech mohou přepsat existujícího seznamu, která byla definována pro kolekci.

Použijete LISTITEM pro vytvoření výčtu sady hodnot.LISTITEMje třeba zadat podřízeného prvku GLOBALLIST a volitelné podřízeného prvku ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky.
```
<LISTITEM value="listName" />
```
listName: řetězec textu, který obsahuje mezi 1 až 255 znaky.

Povolit stávající hodnota

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 pomocí ALLOWEDVALUES element.Pokud nezadáte ALLOWEXISTINGVALUE element, vynutit uživatelem, v době úpravy, zadejte jeden z aktuální platné hodnoty pro toto pole.ALLOWEXISTINGVALUE Element upravuje pouze ty prvky stejného bloku.

<ALLOWEXISTINGVALUE />

Zadejte tento prvek 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 prvky zadat pole.Zadejte tento prvek v části STATE elementu, který chcete použít nejen pravidel, která jsou definována v stavu pro pole, ale také pravidel, která jsou definována pro pole pro všechny přechody do stavu.

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

Specifikujte seznam

Zobrazí pole se skládají ze seznamu jednotlivých položek.Seznam každé pole musí obsahovat alespoň jednu položku.

[!POZNÁMKA]

Globální seznamy nesmí obsahovat obor projektu skupin vzhledem k tomu, že nejsou zaměřeny na projektu.

Chcete-li určit položky v seznamu pole, použijte <LISTITEM value=""> element.Můžete použít ř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.

Určit 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 hodnotou výchozí podverzí.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 seznam výběr, který je aktivní pouze v případě, že jeho nadřazeného podmíněného klauzule je true.V následujícím příkladu jsou definovány dvě sady položky seznamu pro mé pole.V době běhu pouze jeden se zobrazí seznam závislosti na tom, zda je přiřazená požadavky MyCompany.MyTeam.Discipline pole.

[!POZNÁMKA]

WHEN a WHENNOT pravidel v tomto příkladu můžete také použít jiná pravidla pro určení, kdy by měl být vyhodnocen těchto pravidel.Další informace naleznete v tématu Přiřazení podmíněných hodnot a pravidel.

<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

Sledování pracovní položky: rejstřík definic elementů XML

Úprava nebo přidání pole na podporu dotazů, sestav a pracovních postupů

Sdílet prostřednictvím