Definiowanie list wyboru

Artykuł
06/09/2015

Wyliczenia z zestawu wartości dla pola, definiując listę pobrań w ramach definicji lub w pewnym momencie podczas przepływu pracy.Można określić, że lista może zawierać tylko dozwolone wartości, nie może zawierać wartości zabronione lub może sugerować wartości.Jeśli zasugerować wartości, użytkownicy mogą określać wartość innych znajdującymi się na liście pobrania.

Można także określić listami wyboru zależnych, w których definiowanie Wyświetla co najmniej dwa pola, ale tylko jedna lista pojawia się w czasie wykonywania, na podstawie oceny warunkowych reguły.

W tym temacie:

Struktura składni
Struktura składni GLOBALLIST i element listy elementów
Zezwalaj na istniejącej wartości
Określ zestaw dozwolonych wartości.
Definiowanie list pobrania zależne

[!UWAGA]

Dodanie lub zmodyfikowanie Lista pobrania dla FIELD definicji, użyj witadmin narzędzie wiersza polecenia do importowania i eksportowania definicji typu elementu roboczego.Zobacz Importowanie i eksportowanie elementów pracy oraz zarządzanie nimi [witadmin].

Struktura składni

Można użyć ALLOWEDVALUES, SUGGESTEDVALUES, i PROHIBITEDVALUES elementy, aby określić listę wartości, które użytkownik musi określić, może określić lub nie należy określić wartość dla pola.Jeśli używasz każdy z tych elementów, można wyliczenia listę elementów lub określ listy globalnej.Można użyć ALLOWEXISTINGVALUE umożliwiające pola do przechowywania istniejącej wartości po usunięciu elementu z listy wyboru.

Te elementy można określić jako elementy podrzędne FIELD (definicja) lub FIELD elementu (przepływu pracy).

Przy użyciu ALLOWEDVALUES do definiowania listy wartości, które użytkownicy mogą określać w formularza elementu pracy lub w edytorze zapytań.Użytkownicy muszą określić jedną z wartości w GLOBALLIST lub zestaw LISTITEM wpisów.

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

Przy użyciu PROHIBITEDVALUES do definiowania wartości, które nie może zawierać pola listy.Użytkownicy nie mogą zapisywać elementem pracy, jeśli pole zawiera wartość zabronione.Użyj tego elementu, aby ograniczyć stosowanie wartość, która została wcześniej dozwolone, ale nie jest już prawidłowy.
```
<PROHIBITEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName" />
   <LISTITEM value="Name1" />
   <LISTITEM value="Name2" />
   <LISTITEM value="Name3" />
. . . 
</PROHIBITEDVALUES>
```

Przy użyciu SUGGESTEDVALUES do definiowania wartości, które mogą zawierać pola listy.Użytkownicy mogą określać inne wartości, które można zasugerować.

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

Dla każdego z tych elementów można określić jedną lub więcej z atrybutów, które w poniższej tabeli opisano:

Atrybut	Opis
for	Parametr opcjonalny.Określa nazwę użytkownika lub grupy w Team Foundation , do którego stosowana jest reguła.Prawidłowe nazwy składają się z ciągu tekstowego, który zawiera od 1 do 255 znaków. Wartość do wzorca: ^ [^ \\] + \\ [^ \\] + $ Przykład wartość wzorzec: domeny\identyfikator użytkownika
not	Parametr opcjonalny.Określa nazwę użytkownika lub grupy w Team Foundation do kogo zasadę nie ma zastosowania.Prawidłowe nazwy składają się z ciągu tekstowego, który zawiera od 1 do 255 znaków. Wartość do wzorca: ^ [^ \\] + \\ [^ \\] + $ Przykład wartość wzorzec: domeny\identyfikator użytkownika
expanditems	Parametr opcjonalny.Określa, czy grupa zidentyfikowany w LISTITEM element powinien zostać rozwinięta w celu dołączenia do listy grup podrzędnych.Wartość domyślna to true.
filteritems	Parametr opcjonalny.Określa, czy lista zawiera tylko członków grupy, a nie nazw grup.Jest prawidłowy tylko wartość tego atrybutu excludegroups.

Aby uzyskać więcej informacji, zobacz Rozwijanie elementów listy i wyłączanie grup z list.

Struktura składni dla elementów GLOBALLIST i elementu listy

Można użyć GLOBALLIST i LISTITEM elementy do wyliczenia listę elementów, który może być aktualizowana globalny lub które są specyficzne dla jednego pola.

Przy użyciu GLOBALLIST do definiowania zestawu LISTITEM zbierania i wszystkie zespołu projektów, można użyć kolekcji elementów, które są przechowywane dla zespołu projektu.GLOBALLISTjest elementem podrzędnym wymagane GLOBALLISTS element i opcjonalnie podrzędnego elementu ALLOWEDVALUES, SUGGESTEDVALUES, i PROHIBITEDVALUES elementy.Można zdefiniować listy globalnej w definicji elementu pracy, definicję globalnej listy lub globalne przepływu pracy.

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

globalListName: ciągu tekstowego, który zawiera od 1 do 255 znaków.

Ważne
Jeśli globalnej listy jest zdefiniowana w pliku XML, który definiuje typu elementu roboczego, podaj listę unikatową nazwę.W przeciwnym razie może zastąpić istniejącej listy zdefiniowany dla kolekcji.

Przy użyciu LISTITEM do zestawu wartości wyliczenia.LISTITEMjest elementem podrzędnym wymagane GLOBALLIST i opcjonalnie podrzędnego elementu ALLOWEDVALUES, SUGGESTEDVALUES, i PROHIBITEDVALUES elementy.
```
<LISTITEM value="listName" />
```
Zdefiniowana: ciągu tekstowego, który zawiera od 1 do 255 znaków.

Zezwalaj na istniejącej wartości

Można użyć ALLOWEXISTINGVALUE element, aby umożliwić pole, aby zachować istniejące wartości, po określeniu pobrania lista elementów przy użyciu ALLOWEDVALUES elementu.Jeśli nie określisz ALLOWEXISTINGVALUE element, możesz wymusić użytkownika, w czasie edycji, aby określić jeden z bieżącego prawidłowe wartości dla tego pola.ALLOWEXISTINGVALUE Elementu modyfikuje tylko te elementy, w tym samym bloku.

<ALLOWEXISTINGVALUE />

Określ ten element pod FIELD elementu (przepływu pracy) do reguły, które są zdefiniowane dla tego pola.Ta aplikacja zawiera reguły który STATE, TRANSITION, DEFAULTREASON, i REASON elementy Podaj wartość pola.Określ ten element pod STATE element, aby zastosować go nie tylko do reguły zdefiniowane w stanie dla pola, ale także do reguły zdefiniowane dla pola wszystkie przejścia w stan.

Określ ten element pod TRANSITION element, aby zastosować go nie tylko do reguły zdefiniowane w przejścia dla pola, ale także do reguły zdefiniowane dla pola w REASON i DEFAULTREASON elementy.

Określ listę

Wyświetla pole składają się z poszczególnych pozycji.Lista każdego pola musi zawierać co najmniej jeden element.

[!UWAGA]

Wyświetla globalne nie może zawierać zakresu projektu grup, ponieważ nie są one w zakresie do projektu.

Aby określić elementy na liście pola, użyj <LISTITEM value=""> elementu.Można określić ciąg, nazwę użytkownika lub nazwę grupy.

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

[!UWAGA]

W czasie wykonywania, elementów na liście wyświetlane w porządku alfabetycznym zależności od języka serwera, na którym jest uruchomiony Visual Studio Team Foundation Server.

Określ zestaw dozwolonych wartości.

W tym przykładzie pole ważności klient może mieć jeden z trzech wartości: awaryjnego, głównych i pomocniczych.Pole jest zdefiniowane zgodnie z wymogami z wartością domyślną mniejszych.W czasie wykonywania użytkownicy mogą określać jedna z wartości na liście rozwijanej.

<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>

Definiowanie list pobrania zależne

Można określić listę pobrania, która jest aktywne tylko wtedy, gdy jego klauzula warunkowych nadrzędnego ma wartość true.W poniższym przykładzie dwa zestawy listy pobrania są definiowane dla pola Moje.W czasie wykonywania, tylko jeden zostanie wyświetlona lista zależności od tego, czy wymagania jest przypisany do MyCompany.MyTeam.Discipline pola.

[!UWAGA]

WHEN i WHENNOT reguły w tym przykładzie można zastosować do innych zasad, aby określić, kiedy należy ocenić tych zasad.Aby uzyskać więcej informacji, zobacz Przypisywanie warunkowych wartości i reguł.

<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>

Zobacz też

Inne zasoby

Śledzenie elementu pracy: Indeks do definicji elementów XML

Definiowanie pól elementu pracy

Udostępnij za pośrednictwem