Definiowanie list wyboru
Zestaw wartości dla pola można wyliczyć definiując lista pobrań w ramach swojej definicji lub w pewnym momencie podczas przepływu pracy. Można określić, czy lista może zawierać tylko dozwolone wartości, nie może zawierać wartości zabronione lub można zasugerować 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 zdefiniować listami wyboru zależnych, w których należy zdefiniować co najmniej dwa list dla pola, ale w czasie wykonywania, oparte na ocenie reguły warunkowego zostanie wyświetlona lista tylko jeden.
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
Zdefiniuj listami wyboru zależne
Uwaga
Dodanie lub zmodyfikowanie listy pobrania dla FIELD definicji, użyj witadmin Narzędzia wiersza polecenia do importowania i eksportowania definicję 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 w celu określenia listy wartości, które użytkownik musi określić, może określić lub nie może określać jako wartość pola. Jeśli używasz każdy z tych elementów można wyliczyć 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).
Możesz użyć ALLOWEDVALUES do definiowania listy wartości, które użytkownicy mogą określić w formularza elementu pracy lub Edytor zapytań. Użytkownicy muszą określić jednej z tych 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>Możesz użyć PROHIBITEDVALUES do definiowania listy wartości, które nie może zawierać pola. Użytkownicy nie mogą zapisywać elementu pracy, jeśli pole zawiera wartość zabronione. Użyj tego elementu, aby ograniczyć używanie wartość, która została wcześniej dozwolone, ale nie jest już prawidłowe.
<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 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ć co najmniej jeden 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órej jest stosowana 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\UserID |
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\UserID |
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 elementy członkowskie grup, 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.
Składnia struktury elementy GLOBALLIST i elementu listy
Można użyć GLOBALLIST i LISTITEM elementy do wyliczenia listę elementów, które może być aktualizowana globalnie lub które są specyficzne dla jednego pola.
Możesz użyć GLOBALLIST do definiowania zestawu LISTITEM kolekcji i wszystkie zespołu projektów, można użyć kolekcji elementów, które są przechowywane dla zespołu projektu. GLOBALLIST jest wymagany element podrzędny elementu GLOBALLISTS elementu i opcjonalnie elementu 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ąg tekstowy zawierający 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ącą listę, która została zdefiniowana dla kolekcji.
Możesz użyć LISTITEM do zestawu wartości wyliczenia. LISTITEM jest elementem podrzędnym wymagane GLOBALLIST i opcjonalnie elementu podrzędnego elementu ALLOWEDVALUES, SUGGESTEDVALUES, i PROHIBITEDVALUES elementy.
<LISTITEM value="listName" />listName: ciąg tekstowy zawierający od 1 do 255 znaków.
Zezwalaj na istniejącej wartości
Można użyć ALLOWEXISTINGVALUE elementu, aby umożliwić pole, aby zachować istniejące wartości, po określeniu pobrania listę elementów za pomocą ALLOWEDVALUES elementu. Jeśli nie określisz ALLOWEXISTINGVALUE elementu, można wymusić na użytkowniku, w czasie edycji, aby określić jeden z bieżącym prawidłowe wartości dla tego pola. ALLOWEXISTINGVALUE Elementu modyfikuje tylko te elementy, w tym samym bloku.
<ALLOWEXISTINGVALUE />
Określ ten element w obszarze 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 Określ pola. Określ ten element w obszarze STATE element ma być zastosowane nie tylko do reguły, które są zdefiniowane w stanie dla pola, ale także do reguły, które są zdefiniowane dla tego pola dla wszystkich przejść w stan.
Określ ten element w obszarze TRANSITION element ma być zastosowane nie tylko do reguły, które są definiowane w przejścia dla pola, ale także do reguły, które są definiowane dla pola w REASON i DEFAULTREASON elementy.
Określ listę
Wyświetla pole składają się z poszczególnych pozycji. Każde pole listy 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 listy pól, 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, na liście wyświetlane alfabetycznie na podstawie języka z serwera, na którym działa Visual Studio Team Foundation Server.
Określ zestaw dozwolonych wartości
W tym przykładzie pole ważności klienta może mieć jeden z następujących wartości: awaryjnego, głównych i pomocniczych. Pole jest zdefiniowany jako wymagany z wartością domyślną mniejszych. W czasie wykonywania użytkownicy mogą określać jednej z tych 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>
Zdefiniuj listami wyboru zależne
Można zdefiniować listę pobrania, która jest aktywny tylko wtedy, gdy jego klauzuli warunkowych nadrzędny ma wartość true. W poniższym przykładzie dwóch zestawów listy pobrania są definiowane dla pola Moje. W czasie wykonywania, tylko jeden zostanie wyświetlona lista zależności od tego, czy wymagania jest przypisana do MyCompany.MyTeam.Discipline pola.
Uwaga
WHEN i WHENNOT reguł w tym przykładzie można zastosować do innych reguł, aby określić, kiedy należy ocenić tych reguł.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
Modyfikowanie lub dodawanie pola do obsługi zapytań, raportów i przepływu pracy