Sdílet prostřednictvím

Definice rozevíracích seznamů

  • Článek

Definováním seznamu vyskladnění jako součást své definice nebo v určitém okamžiku během pracovního postupu můžete vytvořit výčet hodnot pro pole.Můžete určit seznam může obsahovat pouze povolené hodnoty, nesmí obsahovat nepovolené hodnoty nebo můžete navrhnout hodnoty.Pokud navrhnete hodnoty, mohou uživatelé zadat hodnotu jiné uvedené v seznamu vyskladnění.

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

V tomto tématu

  • Struktura syntaxe pro vytvoření výčtu výběrové seznamy

  • Struktura syntaxe pro GLOBALLIST a LISTITEM prvky

  • Povolení stávající hodnota

  • Výčet povolených hodnot

  • Definování závislé výběrové seznamy

[!POZNÁMKA]

Chcete-li přidat nebo upravit seznam vyskladnění pro FIELD definice, použití witadmin nástroj příkazového řádku pro import a export definice pro položky typu práce.Viz téma Přizpůsobení a správa typů pracovních položek [witadmin].

Struktura syntaxe pro vytvoření výčtu výběrové seznamy

Můžete použít ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky určit seznam hodnot, které musí zadat uživatel, 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 seznamu položek nebo globálního seznamu.Můžete použít ALLOWEXISTINGVALUE Chcete-li povolit pole pro uložení existující hodnotu, je-li odebrat položku z rozevíracího seznamu.

Tyto prvky lze zadat jako podřízené prvky FIELD (definice) nebo FIELD element (pracovní postup).

  • Můžete použít ALLOWEDVALUES Chcete-li definovat seznam hodnot, které mohou uživatelé formulář pracovní položka nebo editor dotazů.Uživatelé musí zadat jednu z hodnot v GLOBALLIST nebo sada 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>

  • Můžete použít PROHIBITEDVALUES Chcete-li definovat seznam hodnot, které nemůže obsahovat pole.Pokud pole obsahuje hodnotu zakázáno, nemohou uživatelé uložit pracovní položky.Tento prvek použít, pokud chcete omezit používání hodnotu, která byla dříve povolen, ale není nadále platná.

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

  • Můžete použít SUGGESTEDVALUES Chcete-li definovat seznam hodnot, které mohou obsahovat pole.Uživatelé mohou zadat jiné hodnoty, kromě těch, které navrhnete.

    <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 jeden nebo více atributů, které jsou popsány v následující tabulce:

Atribut

Description

for

Nepovinné.Určuje jméno uživatele nebo skupinu v Team Foundation ke kterému se vztahuje dané pravidlo.Platné názvy jsou tvořeny textový řetězec, který obsahuje 1 až 255 znaků.

Vzorek hodnota: ^ [^ \\] + \\ [^ \\] +$

Příklad hodnoty vzorek: domény\ID uživatele

not

Nepovinné.Určuje jméno uživatele nebo skupinu v Team Foundation do kterého se pravidlo neplatí.Platné názvy jsou tvořeny textový řetězec, který obsahuje 1 až 255 znaků.

Vzorek hodnota: ^ [^ \\] + \\ [^ \\] +$

Příklad hodnoty vzorek: domény\ID uživatele

expanditems

Nepovinné.Určuje, zda skupiny uvedené v LISTITEM prvek by měl být rozšířen zahrnout podřízené skupiny v seznamu.Výchozí hodnota je true.

filteritems

Nepovinné.Určuje, že seznam obsahuje pouze členům skupiny, nikoli názvy skupin.Jediná platná hodnota tohoto atributu je excludegroups.

Další informace naleznete v tématu Definice vlastních seznamů, rozevíracích seznamů a globálních seznamů.

Zpět na začátek

Struktura syntaxe pro GLOBALLIST a LISTITEM prvky

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

  • Můžete použít GLOBALLIST Chcete-li definovat sadu LISTITEM prvky, které jsou uloženy pro tým projektu kolekce a všech týmových projektů v této kolekci můžete použít.GLOBALLISTje vyžadovaným podřízeným prvkem GLOBALLISTS element a volitelný podřízený prvek ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky.Můžete definovat globální seznam v 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 1 až 255 znaků.

    Důležitá poznámkaDůležité

    Při definování globálního seznamu v souboru XML, který definuje typ pracovní položky, musíte dát seznamu jedinečný název.Jinak může přepsat existující seznam, který byl definován pro kolekci.

  • Můžete použít LISTITEM výčet hodnot.LISTITEMje vyžadovaným podřízeným prvkem GLOBALLIST a volitelný podřízený prvek ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky.

    <LISTITEM value="listName" />

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

Zpět na začátek

Povolení stávající hodnota

Můžete použít ALLOWEXISTINGVALUE elementu, chcete-li povolit pole, které chcete zachovat existující hodnoty po zadání seznamu vyskladnění zboží pomocí ALLOWEDVALUES prvku.Nezadáte-li ALLOWEXISTINGVALUE element, přinutit uživatele, v době úpravy, určete jeden z aktuální platné hodnoty pro toto pole.ALLOWEXISTINGVALUE Prvek změní pouze ty prvky ve stejném komplexu.

<ALLOWEXISTINGVALUE />

Určete tento prvek v seznamu FIELD element (pracovní postup) Chcete-li použít pravidla, která jsou pro dané pole definovány.Tato aplikace obsahuje pravidla, STATE, TRANSITION, DEFAULTREASON, a REASON prvky pole zadat.Určete tento prvek v seznamu STATE prvek jej použít nejen pro 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.

Určete tento prvek v seznamu TRANSITION prvek jej použít nejen pro pravidla, která jsou definována v přechodu pro pole, ale také pravidel, která jsou definována pro pole v REASON a DEFAULTREASON prvky.

Zpět na začátek

Výčet seznamu

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

[!POZNÁMKA]

Globální seznamy nesmí obsahovat skupiny s rozsahem projektu, protože není zaměřen na projekt.

Určete položky v seznamu polí, <LISTITEM value=""> prvku.Můžete 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ě podle jazyka serveru se systémem Visual Studio Team Foundation Server.

Zpět na začátek

Výčet povolených hodnot

V tomto příkladu pole závažnost zákazník může mít jednu ze tří hodnot: záchranné, hlavní i vedlejší.Pole je definováno podle potřeby s výchozí hodnotou nezletilé osoby.V době běhu mohou uživatelé zadat jednu 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>

Zpět na začátek

Definování závislé výběrové seznamy

Můžete definovat seznam vyskladnění, který je aktivní pouze při splnění jeho nadřazené podmíněné klauzule.V následujícím příkladu jsou definovány dvě sady seznam vyskladnění pro Moje pole.V době běhu, pouze jeden seznam je zobrazen podle zda je přiřazen požadavky MyCompany.MyTeam.Discipline pole.

[!POZNÁMKA]

WHEN a WHENNOT pravidla v tomto příkladu lze použít i jiná pravidla pro určení, kdy by měly být hodnoceny 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>

Zpět na začátek

Viz také

Koncepty

Definice vlastních seznamů, rozevíracích seznamů a globálních seznamů

Další zdroje

Rejstřík definic elementů XML pro typy pracovních položek

Přizpůsobení globálního pracovního postupu

Definice polí pracovních položek