Sdílet prostřednictvím

Definování seznamů vyskladnění

  • Článek

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

Můžete také definovat vyskladnění závislé seznamy, ve kterých dva nebo více seznamů pro pole definujete ale pouze jeden seznam se zobrazí při spuštění na základě hodnocení pravidlo podmíněného.

V tomto tématu

  • Syntaxe strukturu výčtu výběrové seznamy

  • Struktura GLOBALLIST a LISTITEM prvky syntaxe

  • Povolení stávající hodnota

  • Výčet sadu povolených hodnot

  • Definování seznamů závislé vyskladnění

Syntaxe strukturu výčtu výběrové seznamy

Můžete použít ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky zadejte seznam hodnot, které uživatel musí zadat, může určit nebo musíte zadat jako hodnotu pro pole. Každý z těchto prvků použijete, můžete vytvořit výčet seznamu položek nebo globálního seznamu. Můžete použít ALLOWEXISTINGVALUE Povolit pole pro uložení existující hodnotu, je-li odebrat položku ze seznamu vyskladnění.

Tyto prvky můžete zadat jako podřízené prvky FIELD (definice) nebo FIELD prvku (pracovní postup).

  • Pomocí ALLOWEDVALUES k definování seznamu hodnot, které mohou uživatelé zadat ve formuláři položky práce nebo editor dotazu. Uživatelé musí zadat jednu z hodnot GLOBALLIST nebo sadu LISTITEM položek.

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

  • Pomocí PROHIBITEDVALUES k definování seznamu hodnot, které nemůže obsahovat pole. Pokud pole obsahuje hodnotu zakázáno, uživatelé nemohou uložit pracovní položku. Tento prvek použijte, pokud chcete omezit použití hodnoty byl 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>

  • Pomocí SUGGESTEDVALUES k definování seznamu hodnot, které může obsahovat pole. Uživatelé mohou určit další hodnoty vedle 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 zadat jeden nebo více atributů, které jsou popsány v následující tabulce:

Atribut

Popis

for

Nepovinné. Určuje název uživatele nebo skupiny v Team Foundation ke kterému se vztahuje pravidlo. Platné názvy se skládají z řetězce textu obsahujícího od 1 do 255 znaků.

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

Vzorek Příklad hodnoty: Doména\UserID

not

Nepovinné. Určuje název uživatele nebo skupiny v Team Foundation ke kterému pravidlo nevztahuje. Platné názvy se skládají z řetězce textu obsahujícího od 1 do 255 znaků.

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

Vzorek Příklad hodnoty: Doména\UserID

expanditems

Nepovinné. Určuje, zda skupina identifikovány 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 členové skupin, nikoli názvy skupin. Jediná platná hodnota tohoto atributu je excludegroups.

Další informace naleznete v tématu Definování a použití seznamů vyberte seznamy a seznamy globální.

Zpět na začátek

Struktura GLOBALLIST a LISTITEM prvky syntaxe

Můžete použít GLOBALLIST a LISTITEM prvky výčtu položek, který lze aktualizovat globálně nebo které jsou specifické pro jednoho pole.

  • Pomocí GLOBALLIST definovat sadu LISTITEM prvky, které jsou uloženy pro tým projektu sběru a všech týmových projektů v této kolekci můžete použít. GLOBALLISTje vyžadován podřízený prvek GLOBALLISTS prvek a volitelné podřízený prvek ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky. Můžete definovat globální seznam 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 obsahujícího od 1 do 255 znaků.

    Důležité

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

  • Pomocí LISTITEM výčet sadu hodnot. LISTITEMje vyžadován podřízený prvek GLOBALLIST a volitelné podřízeného prvku ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky.

    <LISTITEM value="listName" />

    listName: Řetězec textu obsahujícího od 1 do 255 znaků.

Zpět na začátek

Povolení stávající hodnota

Můžete použít ALLOWEXISTINGVALUE prvek povolit pole udržovat po zadat seznam vyskladnění zboží pomocí existujících hodnot ALLOWEDVALUES prvku. Pokud nezadáte ALLOWEXISTINGVALUE element přinutit uživatele v době upravit určete jeden aktuální platné hodnoty tohoto pole. ALLOWEXISTINGVALUE Prvek upravuje pouze prvky ve stejném bloku.

<ALLOWEXISTINGVALUE />

Určit podle tohoto prvku FIELD (pracovní) prvek použít pravidla, která jsou definována pro pole. Tato aplikace obsahuje pravidla, STATE, TRANSITION, DEFAULTREASON, a REASON prvky pole zadat. Určit podle tohoto prvku STATE prvek použít pouze pravidel, které jsou definovány ve stavu pro pole, ale také pro pravidla, které jsou definované v poli pro všechny přechody do stavu.

Určit podle tohoto prvku TRANSITION prvek použít pouze pro pravidla, která jsou definovány v přechodu pro pole, ale také pravidla definovaná pro pole REASON a DEFAULTREASON prvky.

Zpět na začátek

Výčet seznamu

Seznamy polí jsou složeny z jednotlivé položky seznamu. Každý seznam polí musí obsahovat alespoň jednu položku.

Poznámka

Globální seznamy musí obsahovat skupiny rozsah projektu, protože není rozsah projektu.

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ě spuštění položky v seznamu se zobrazí abecedně podle jazyka spuštěného serveru Visual Studio Team Foundation Server.

Zpět na začátek

Výčet sadu povolených hodnot

V tomto příkladu pole závažnost zákazník může mít jednu ze tří hodnot: Nouzové hlavní a vedlejší. Pole je definováno výchozí hodnotou vedlejší podle potřeby. V době spuštění 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í seznamů závislé vyskladnění

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ě spuštění zobrazí pouze jeden seznam podle toho, 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 pravidla. Další informace naleznete v tématu Přiřazení hodnoty založené na podmíněné a pravidla.

<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

Definování a použití seznamů vyberte seznamy a seznamy globální

Další zdroje

Index prvku XML definice typů pracovních položek

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

Definování položky pole práce

Historie změn

Datum

Poslední dokumenty

Důvod

Leden 2011

Přidat strukturu syntaxi a příklady.

Rozšíření informace