Udostępnij za pośrednictwem

Definiowanie list wyboru

  • Artykuł

Definiując listę pobrań jako część jego definicji lub w pewnym momencie podczas przepływu pracy można wyliczyć zestaw wartości dla pola.Można określić, że lista może zawierać tylko wartości dopuszczalne, nie może zawierać wartości zabronionych lub może sugerować wartości.Jeśli zostanie zaproponowana wartości, użytkownicy mogą określać wartość inne zasady, z listy pobrań.

Można także zdefiniować listy wyboru zależnych, w których można zdefiniować dwa lub więcej wykazy dla pola, ale tylko jedna lista pojawi się w czasie wykonywania na podstawie oceny reguły warunkowego.

W tym temacie

  • Struktura Składnia wyliczania listy wyboru

  • Struktura składnia dla GLOBALLIST i LISTITEM elementów

  • Pozwalając istniejącej wartości

  • Wyliczanie zestaw wartości dopuszczalne

  • Definiowanie zależnych listy wyboru

[!UWAGA]

Aby dodać lub zmodyfikować listę pobrania dla FIELD definicji, użyj witadmin narzędzie wiersza polecenia do importowania i eksportowania definicji dla typu elementu pracy.Zobacz Dostosowywanie typów elementów pracy i zarządzanie nimi [witadmin].

Struktura Składnia wyliczania listy wyboru

Można użyć ALLOWEDVALUES, SUGGESTEDVALUES, i PROHIBITEDVALUES elementy do określania listy wartości, które użytkownik musi określić, może określić lub nie określać jako wartość dla pola.Jeśli używasz każdy z tych elementów można wyliczyć listę elementów lub określić globalnej listy.Można użyć ALLOWEXISTINGVALUE aby umożliwić pola do przechowywania istniejącą wartość, jeśli usuniesz element z listy wyboru.

Elementy te można określić jako elementy podrzędne FIELD (definicja) lub FIELD element (przepływ pracy).

  • Możesz użyć 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 zbiór 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>

  • Możesz użyć PROHIBITEDVALUES do definiowania listy wartości, które nie mogą zawierać pola.Użytkownicy nie można zapisać elementu pracy, jeśli pole zawiera wartość zabronione.Ten element jest użyć, aby uniemożliwić używanie wartość, która była poprzednio dozwolona, 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>

  • Możesz użyć SUGGESTEDVALUES do definiowania listy wartości, które mogą zawierać pola typu.Użytkownicy mogą określić inne wartości, które nie zostanie zaproponowana.

    <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ć jeden lub więcej atrybutów, które opisano w poniższej tabeli:

Atrybut

Opis

for

Opcjonalne.Specifies the name of a user or group in Team Foundation to whom the rule applies.Valid names consist of a string of text that contains between 1 and 255 characters.

Pattern value: ^[^\\]+\\[^\\]+$

Pattern value example: Domain\UserID

not

Opcjonalne.Specifies the name of a user or group in Team Foundation to whom the rule does not apply.Valid names consist of a string of text that contains between 1 and 255 characters.

Pattern value: ^[^\\]+\\[^\\]+$

Pattern value example: Domain\UserID

expanditems

Opcjonalne.Określa, czy grupa ma być identyfikowane w LISTITEM elementu powinno zostać rozszerzone na umieszczenie podrzędnego grup na liście.Wartością domyślną jest true.

filteritems

Opcjonalne.Określa, że lista zawiera tylko członkowie grupy, a nie nazw grup.Jedyną prawidłową wartość tego atrybutu jest excludegroups.

Aby uzyskać więcej informacji, zobacz Definiowanie list użytkowników, list wyboru i list globalnych.

Powrót do początku

Struktura składnia dla GLOBALLIST i LISTITEM elementów

Można użyć GLOBALLIST i LISTITEM elementy wyliczyć listę elementów, które mogą być aktualizowane na całym świecie, lub które są specyficzne dla jednego pola.

  • Możesz użyć GLOBALLIST do zdefiniowania zestawu z LISTITEM elementy, które są przechowywane w zespole projektu zbierania i wszystkich zespołów projektów w tym można użyć kolekcji.GLOBALLISTjest elementem podrzędnym wymagane GLOBALLISTS element i element opcjonalny dziecko ALLOWEDVALUES, SUGGESTEDVALUES, i PROHIBITEDVALUES elementy.Można zdefiniować globalnej listy w ramach definicji elementu pracy, definicja globalnej listy lub globalnego przepływu pracy.

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

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

    Ważna uwagaWażne

    Po zdefiniowaniu globalnej listy w pliku XML, który definiuje typ elementu pracy musi nadać listy unikatową nazwę.W przeciwnym razie może spowodować zastąpienie istniejącej listy, który został zdefiniowany dla kolekcji.

  • Możesz użyć LISTITEM w celu wyliczenia zestawu wartości.LISTITEMjest elementem podrzędnym wymagane GLOBALLIST oraz opcjonalne podrzędnych elementu ALLOWEDVALUES, SUGGESTEDVALUES, i PROHIBITEDVALUES elementy.

    <LISTITEM value="listName" />

    Nazwa_listy: ciąg tekstowy, który zawiera od 1 do 255 znaków.

Powrót do początku

Pozwalając istniejącej wartości

Można użyć ALLOWEXISTINGVALUE element, aby umożliwić pole zachować istniejące ustawienia, po określeniu listy wyboru elementów za pomocą ALLOWEDVALUES element.Jeśli nie określisz ALLOWEXISTINGVALUE element, możesz wymusić na użytkowniku, w czasie edycji, aby określić jeden z bieżącym prawidłowe wartości dla tego pola.ALLOWEXISTINGVALUE Element modyfikuje tylko te elementy, w tym samym bloku.

<ALLOWEXISTINGVALUE />

Określ ten element w obszarze FIELD element (przepływ pracy), aby zastosować go do reguły, które są zdefiniowane dla tego pola.Ta aplikacja zawiera zasady że STATE, TRANSITION, DEFAULTREASON, i REASON elementy Określ pole.Określ ten element w obszarze STATE element, aby ją zastosować, nie tylko dla reguł, które są zdefiniowane w Państwie dla pola, ale również do reguł, które są zdefiniowane dla tego pola dla wszystkich przejść w stan.

Określ ten element w obszarze TRANSITION element, aby ją zastosować, nie tylko dla reguł, które są zdefiniowane w okresie przejściowym dla pola, ale również do reguł, które są zdefiniowane dla pola w REASON i DEFAULTREASON elementy.

Powrót do początku

Wyliczanie listę

Listy pól składają się z poszczególnych pozycji.Każda lista pola musi zawierać co najmniej jeden element.

[!UWAGA]

Wykazy globalne nie może zawierać grupy o zakresie projektu, ponieważ nie są one objęte projektu.

Aby określić elementy na liście pól, użyj <LISTITEM value=""> element.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, elementy listy tabeli są wyświetlane alfabetycznie na podstawie języka serwera z systemem Visual Studio Team Foundation Server.

Powrót do początku

Wyliczanie zestaw wartości dopuszczalne

W tym przykładzie pole dotkliwości klienta może mieć jeden z trzech wartości: awaryjnego, głównych i pomocniczych.Pole jest zdefiniowane zgodnie z wymogami o mniejszej wartości domyślnej.W czasie wykonywania użytkownicy mogą określić jedną 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>

Powrót do początku

Definiowanie zależnych listy wyboru

Można zdefiniować listy wyboru, która jest aktywna tylko wtedy, gdy jego klauzula warunkowego nadrzędny jest true.W poniższym przykładzie zdefiniowano dwa zestawy listy pobrań dla pola Moje.W czasie wykonywania, tylko jedna lista jest wyświetlany na czy wymagania jest przypisany do podstawie MyCompany.MyTeam.Discipline pole.

[!UWAGA]

WHEN i WHENNOT reguły w tym przykładzie można także zastosować do innych reguł, aby określić, kiedy zasady te powinny zostać poddane ocenie.Aby uzyskać więcej informacji, zobacz Przypisywanie uzależnionych od warunków 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>

Powrót do początku

Zobacz też

Koncepcje

Definiowanie list użytkowników, list wyboru i list globalnych

Inne zasoby

Definicje elementu Index to XML dla typów elementów pracy

Dopasowywanie globalnego przepływu pracy

Definiowanie pól elementu pracy