Wszystkie elementy XML All FIELD — Odwołanie

Artykuł
09/13/2015

Użyj tego tematu do odszukania składnia FIELD elementu lub jeden z jego elementów podrzędnych.

Określ tych elementów w FIELD kontener elementu (definicja). Dodaj pole dla typu elementu roboczego (ZEZWÓ), określając FIELD elementu (definicja) w ramach FIELDS elementu (definicja). Można podać te elementy w ramach definicji ZEZWÓ lub w ramach globalnego przepływu pracy.

Możesz dodać elementy podrzędne, aby określić zachowanie pola, definiowanie wartości domyślnych lub definiować listę pobrania wartości. Pola elementów reguły można użyć w połączeniu ze sobą. Można ograniczyć zakres większości reguł do zastosowania do jednego lub kilku użytkowników lub grupy lub być ignorowane dla jednego lub kilku użytkowników lub grupy.

Element kontenera pola (definicja)

Możesz użyć następującej składni do definiowania pola danych dla typu elementu roboczego. Ten przykład przedstawia format FIELD elementu (definicja) i wszystkie elementy podrzędne opcjonalne. Aby uzyskać więcej informacji, zobacz Element FIELD (Definition) — Odwołanie.

<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID "
syncnamechanges="true | false" reportingname="reportingDisplayName" reportingrefname="reportingReferenceName"
reportable="Dimension | Detail | Measure" formula="avg" >
   <ALLOWEDVALUES> . . . </ALLOWEDVALUES>
   <ALLOWEXISTINGVALUE />
   <CANNOTLOSEVALUE />
   <COPY />
   <DEFAULT />
   <EMPTY />
   <FROZEN />
   <HELPTEXT> . . . </HELPTEXT>
   <MATCH />
   <NOTSAMEAS />
   <PROHIBITEDVALUES /> . . . </PROHIBITEDVALUES>
   <READONLY />
   <REQUIRED />
   <SERVERDEFAULT />
   <SUGGESTEDVALUES /> . . . </SUGGESTEDVALUES>
   <VALIDUSER />
   <WHEN>> . . . </WHEN>
   <WHENNOT> . . . </WHENNOT>
   <WHENCHANGED> . . . </WHENCHANGED>
   <WHENNOTCHANGED> . . . </WHENNOTCHANGED>
</FIELD>

Elementy podrzędne pola

Można ustawić różne ograniczenia na dane, które można wprowadzić w polu za pomocą elementów podrzędnych. Można określić wartości dla listy wyboru (listy rozwijanej), ustawianie domyślnej wartości, wyczyścić wpisy lub ograniczyć możliwość zmian. W poniższej tabeli przedstawiono składnię struktury dla każdego elementu podrzędnego.

Aby dowiedzieć się, jak używać tych elementów, zobacz Zastosowanie reguły do pola elementu roboczego. Ograniczenia w elemencie stosowanie większości reguł do pól systemowych. Wszystkie elementy podrzędne są opcjonalne.

Element	Opis i składni
ALLOWEDVALUES	Definiuje listę wartości, które użytkownicy mogą określać listy pól w formularzach elementu roboczego i w edytorze zapytań. Użytkownicy muszą określić jednej z tych wartości tej liście. `<ALLOWEDVALUES for="userGroupName" not="userGroupName" expanditems="true \| false" filteritems="excludegroups"> <GLOBALLIST name="globalListName"> <LISTITEM value="Name" /> . . . </GLOBALLIST> </ALLOWEDVALUES>` Aby uzyskać więcej informacji, zobacz Definiowanie list wyboru.
ALLOWEXISTINGVALUE	Określa, czy pole można zachować istniejącej wartości, nawet jeśli nie jest już na liście pobrania. Wszystkie nowe wartości pól musi być na liście. `<ALLOWEXISTINGVALUE />` Aby uzyskać więcej informacji, zobacz Definiowanie list wyboru.
CANNOTLOSEVALUE	Określa, że użytkownicy nie można wyczyścić pola wszystkich wartości po określono wartość. Po pole zawiera wartość, to pole zawsze musi zawierać wartość inną niż NULL. `<CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />` Aby uzyskać więcej informacji, zobacz Stosowanie reguły pola.
COPY	Kopiuje określoną wartość do pola, gdy użytkownik tworzy lub modyfikuje element pracy. `<COPY for="userGroupName" not="userGroupName" from="value \| field \| clock \| currentuser" value="valueToCopy" field="fieldReferenceName" />` Aby uzyskać więcej informacji, zobacz Zdefiniuj wartość domyślną lub skopiuj wartość do pola.
DEFAULT	Określa wartość dla pola, który jest pusty, gdy użytkownik tworzy lub modyfikuje element pracy. Jeśli pole ma już wartość, reguły domyślnej jest ignorowana. `<DEFAULT for="userGroupName" not="userGroupName" from="value \| field \| clock \| currentuser" value="value to copy" field="field reference name" />` Aby uzyskać więcej informacji, zobacz Zdefiniuj wartość domyślną lub skopiuj wartość do pola.
EMPTY	Czyści to pole, który zawiera wartości. EMPTY Zasada również sprawia, że pole tylko do odczytu i nie należy można używać go z READONLY reguły. Wartość pola jest zaznaczone, gdy użytkownik zapisuje element pracy i nie można określić dowolną wartość. Ta reguła jest używana głównie podczas przejścia w stan, aby wyczyścić pola, które dotyczą stanu, do którego przechodzi stanu elementu. `<EMPTY for="userGroupName" not=" userGroupName" />` Aby uzyskać więcej informacji, zobacz Stosowanie reguły pola.
FROZEN	Określa, że nie można zmienić pola wartości niepuste po zmian. Jako użytkownik zapisuje element pracy z wartością w tym polu, wartość może nie być już zmodyfikowany. `<FROZEN for="userGroupName" not="userGroupName" />` Aby uzyskać więcej informacji, zobacz Stosowanie reguły pola.
HELPTEXT	Definiuje tekst do wyświetlenia, gdy użytkownik wskazuje do pola formularza elementu pracy. tooltipText: ciąg tekstowy zawierający od 1 do 255 znaków. `<HELPTEXT>tooltipText </HELPTEXT>` Aby uzyskać więcej informacji, zobacz Stosowanie reguły pola.
MATCH	Definiuje muszą być zgodne wartości pól typu ciąg do wzorca. `<MATCH pattern="patternValue" for="userGroupName" not="userGroupName" />` Aby uzyskać więcej informacji, zobacz Zastosuj wzorzec dopasowany do pola ciągu.
NOTSAMEAS	Określa pole nie jest przypisany tę samą wartość, do którego jest przypisany inny określone pole. Wartość field Atrybut musi być prawidłowym odwołaniem nazwę pola. `<NOTSAMEAS field="fieldReferenceName" for="userGroupName" not="userGroupName" />` Aby uzyskać więcej informacji, zobacz Stosowanie reguły pola.
PROHIBITEDVALUES	Definiuje listę wartości, które nie może zawierać pola. Użytkownicy nie mogą zapisywać elementu pracy, jeśli pole zawiera wartość zabronione. `<PROHIBITEDVALUES for="userGroupName" not="userGroupName" expanditems="true \| false" filteritems="excludegroups"> <GLOBALLIST name="globalListName"> <LISTITEM value="Name" /> . . . </GLOBALLIST> </PROHIBITEDVALUES>` Aby uzyskać więcej informacji, zobacz Definiowanie list wyboru.
READONLY	Określa, że nie można zmodyfikować wartości, do którego zostało przypisane pola. `<READONLY for="userGroupName" not="userGroupName" />` Uwaga Nie należy używać tego elementu razem z EMPTY elementu ponieważ EMPTY również sprawia, że pole tylko do odczytu.Jeśli składa się z tych elementów, wyniki są niezgodne. Aby uzyskać więcej informacji, zobacz Stosowanie reguły pola.
REQUIRED	Określa, czy użytkownicy, należy określić wartość dla pola. Wymagane pola nie może być pusta. Użytkownicy nie mogą zapisywać elementu pracy, dopóki nie przypisano wartości do wszystkich wymaganych pól. `<REQUIRED for="userGroupName" not="userGroupName" />` Aby uzyskać więcej informacji, zobacz Stosowanie reguły pola.
SERVERDEFAULT	Kopiuje wartość określonego serwera do pola, gdy użytkownik zapisuje elementu pracy. Te pola zazwyczaj są wyświetlane jako tylko do odczytu w formularzu. `<SERVERDEFAULT for="userGroupName" not="userGroupName" from="clock \| currentuser" />` Aby uzyskać więcej informacji, zobacz Zdefiniuj wartość domyślną lub skopiuj wartość do pola.
SUGGESTEDVALUES	Definiuje listę sugerowanych wartości, które użytkownicy mogą określać listy pól w formularzach elementu roboczego i w edytorze zapytań. Użytkownicy mogą określać wartości inne niż te, które można zasugerować. `<SUGGESTEDVALUES for="userGroupName" not="userGroupName" expanditems="true \| false" filteritems="excludegroups"> <GLOBALLIST name="globalListName"> <LISTITEM value="Name" /> . . . </GLOBALLIST> </SUGGESTEDVALUES>` Aby uzyskać więcej informacji, zobacz Definiowanie list wyboru.
VALIDUSER	Ogranicza pozycje robocze z modyfikowany przez użytkowników, którzy należą do określonej grupy. Domyślna grupa jest Team Foundation Prawidłowi użytkownicy grupy. Wszystkie atrybuty są opcjonalne. Wszystkie atrybuty musi składać się z ciągu tekstowego, który zawiera od 1 do 255 znaków. Tokeny służy do określania grup. `< VALIDUSER group="groupName" for="userName" not="userName" />` Aby uzyskać więcej informacji, zobacz Stosowanie reguły pola.
WHEN	Określa co najmniej jedną regułę do zastosowany do bieżącego pola inne pole ma określoną wartość. Element nadrzędny FIELD element definiuje bieżącego pola. <WHEN field="fieldReferenceName" value="value"> <ALLOWEDVALUES> . . . </ALLOWEDVALUES> <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE> <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE> <COPY> . . . </COPY> <DEFAULT> . . . </DEFAULT> <EMPTY> . . . </EMPTY> <FROZEN> . . . </FROZEN> <MATCH> . . . </MATCH> <NOTSAMEAS> . . . </NOTSAMEAS> <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES> <READONLY> . . . </READONLY> <REQUIRED> . . . </REQUIRED> <SERVERDEFAULT> . . . </SERVERDEFAULT> <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES> <VALIDUSER> . . . </VALIDUSER> </WHEN> Aby uzyskać więcej informacji, zobacz Przypisywanie warunkowych wartości i reguł
WHENNOT	Określa co najmniej jedną regułę do zastosowania do bieżącego pola, gdy inne pole nie ma określonej wartości. Element nadrzędny FIELD element definiuje bieżącego pola. <WHENNOT field="fieldReferenceName" value="value"> <ALLOWEDVALUES> . . . </ALLOWEDVALUES> <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE> <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE> <COPY> . . . </COPY> <DEFAULT> . . . </DEFAULT> <EMPTY> . . . </EMPTY> <FROZEN> . . . </FROZEN> <MATCH> . . . </MATCH> <NOTSAMEAS> . . . </NOTSAMEAS> <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES> <READONLY> . . . </READONLY> <REQUIRED> . . . </REQUIRED> <SERVERDEFAULT> . . . </SERVERDEFAULT> <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES> <VALIDUSER> . . . </VALIDUSER> </WHENNOT> Aby uzyskać więcej informacji, zobacz Przypisywanie warunkowych wartości i reguł.
WHENCHANGED	Określa co najmniej jedną regułę do zastosowania do bieżącego pola po zmianie podczas zmiany elementów roboczych inne pole. Element nadrzędny FIELD element definiuje bieżącego pola. <WHENCHANGED field="fieldReferenceName" > <ALLOWEDVALUES> . . . </ALLOWEDVALUES> <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE> <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE> <COPY> . . . </COPY> <DEFAULT> . . . </DEFAULT> <EMPTY> . . . </EMPTY> <FROZEN> . . . </FROZEN> <MATCH> . . . </MATCH> <NOTSAMEAS> . . . </NOTSAMEAS> <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES> <READONLY> . . . </READONLY> <REQUIRED> . . . </REQUIRED> <SERVERDEFAULT> . . . </SERVERDEFAULT> <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES> <VALIDUSER> . . . </VALIDUSER> </WHENCHANGED> Aby uzyskać więcej informacji, zobacz Przypisywanie warunkowych wartości i reguł.
WHENNOTCHANGED	Określa co najmniej jedną regułę do zastosowany do bieżącego pola inne pole nie ulega zmianie podczas zmiany elementów roboczych. Element nadrzędny definiuje bieżącego pola. <WHENNOTCHANGED field="fieldReferenceName"> <ALLOWEDVALUES> . . . </ALLOWEDVALUES> <ALLOWEXISTINGVALUE> . . . <ALLOWEXISTINGVALUE> <CANNOTLOSEVALUE> . . . </CANNOTLOSEVALUE> <COPY> . . . </COPY> <DEFAULT> . . . </DEFAULT> <EMPTY> . . . </EMPTY> <FROZEN> . . . </FROZEN> <MATCH> . . . </MATCH> <NOTSAMEAS> . . . </NOTSAMEAS> <PROHIBITEDVALUES> . . . </PROHIBITEDVALUES> <READONLY> . . . </READONLY> <REQUIRED> . . . </REQUIRED> <SERVERDEFAULT> . . . </SERVERDEFAULT> <SUGGESTEDVALUES> . . . </SUGGESTEDVALUES> <VALIDUSER> . . . </VALIDUSER> </WHENNOTCHANGED> Aby uzyskać więcej informacji, zobacz Przypisywanie warunkowych wartości i reguł.

Elementy podrzędne GLOBALLIST i elementu listy

Należy określić GLOBALLIST i LISTITEM jako elementy podrzędne elementu ALLOWEDVALUES, SUGGESTEDVALUES, i PROHIBITEDVALUES elementy. Wyliczanie listę wartości, który pojawi się, można użyć tych elementów. Użytkownicy wybierz wartości z listy wyboru lub menu rozwijanego. Aby uzyskać więcej informacji, zobacz Definiowanie list globalnych.

Element	Opis
GLOBALIST	Definiuje zestaw LISTITEM elementy, które są przechowywane dla zespołu projektu zbierania i zespołów projektów w kolekcji można użyć. `<GLOBALLIST name="globalListName"> <LISTITEM> . . . </LISTITEM> </GLOBALLIST>` globalListName: ciąg tekstowy zawierający od 1 do 255 znaków. 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.
LISTITEM	Definiuje wartość prawidłową listę. `<LISTITEM value="listName" />` LISTITEM jest elementem podrzędnym wymagane GLOBALLIST i opcjonalnie elementu podrzędnego elementu ALLOWEDVALUES, SUGGESTEDVALUES, i PROHIBITEDVALUES elementy.

Element

Opis

GLOBALIST

Definiuje zestaw LISTITEM elementy, które są przechowywane dla zespołu projektu zbierania i zespołów projektów w kolekcji można użyć.

<GLOBALLIST name="globalListName">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>

globalListName: ciąg tekstowy zawierający od 1 do 255 znaków.

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.

LISTITEM

Definiuje wartość prawidłową listę.

<LISTITEM value="listName" />

LISTITEM jest elementem podrzędnym wymagane GLOBALLIST i opcjonalnie elementu podrzędnego elementu ALLOWEDVALUES, SUGGESTEDVALUES, i PROHIBITEDVALUES elementy.

Atrybuty określone przez elementy podrzędne pola

Możesz skorzystać z najbardziej FIELD reguł, aby zastosować lub nie do zestawu grup lub użytkowników, umieszczając w niej for lub not atrybuty. Aby uzyskać więcej informacji, zobacz Stosowanie reguły pola.

Atrybut	Składnia	Opis
expanditems	expanditems = "true \| false"	Parametr opcjonalny. Określa, czy grupa który LISTITEM identyfikuje element powinien zostać rozwinięta w celu dołączenia do listy grup podrzędnych. Domyślna wartość tego atrybutu jest true.
filteritems	filteritems = "excludegroups"	Parametr opcjonalny. Określa, czy tylko elementy członkowskie grup, a nie nazw grup, znajdują się na liście. Jedyny dozwolony wartość dla tego atrybutu jest excludegroups.
for	dla = "userGroupName"	Parametr opcjonalny. Określa nazwę użytkownika lub grupy w Team Foundation do której jest stosowana reguła. Prawidłowe wartości składają się z ciągu tekstowego, który zawiera od 1 do 255 znaków.
not	nie = "userGroupName"	Parametr opcjonalny. Określa nazwę użytkownika lub grupy w Team Foundation do kogo zasadę nie ma zastosowania. Prawidłowe wartości składają się z ciągu tekstowego, który zawiera od 1 do 255 znaków.
from	z = "wartość \| pole \| zegar \| CurrentUser"	Parametr wymagany. Określa źródło wartości, z której chcesz skopiować wartość lub określić wartość domyślną. Następujące wartości są prawidłowe: clock: Kopiuje bieżącą datę i godzinę z zegara systemowego do pola daty/godziny. Żadne dodatkowe atrybuty są wymagane. Dla COPY i DEFAULT zasady, ta wartość pochodzi z komputera lokalnego czasu zegara. Dla SERVERDEFAULT, wartość pochodzi z zegara serwera, gdy użytkownik zapisuje element pracy. currentuser: Kopiuje nazwy użytkownika, który jest obecnie zalogowany. Krótka nazwa bieżącego użytkownika można użyć jako wartości. Żadne dodatkowe atrybuty są wymagane. Używany w przypadku pól ciągu. field: Kopiuje wartość field atrybut, który określisz. Wymaga field="abc" atrybutu. Domyślnie jeśli określony "od" pole jest puste, nic nie jest wykonywane. field Atrybut jest używany tylko w przypadku < KOPIOWANIA > i < domyślne > reguły. value: Kopiuje wartość value atrybut, który określisz. Użyj wartości stałą typu string, który określisz. Wymaga value="abc" atrybutu. value jest używany tylko dla < KOPIOWANIA > i < domyślne > reguły. Jeśli określono "wartość" lub "pole", użytkownik musi również obejmować atrybut value lub pola odpowiednio.
field	pole = "fieldReferenceName"	Parametr opcjonalny. Określa nazwę pola, którego wartość ma na celu skopiowane do pola po field jest określone dla from atrybutu.
pattern	wzorzec = "patternValue"	Parametr wymagany. Wymusza podstawowy wzorzec dopasowywania tylko ciągi. patternValue jest ciąg składający się z zakresu od 1 do 255 znaków, wraz z wartościami granicznymi. Ten ciąg nie może zawierać znaku ukośnika odwrotnego (\\). Każdy znak w ciągu jest interpretowany jako literału, o ile nie jest jednym z następujących sześciu metaznaki: "A" lub "" reprezentuje pojedynczy znak alfabetu. "N" lub "n" reprezentuje pojedynczy znak numeryczny. "X" lub "x" reprezentuje pojedynczy znaków alfanumerycznych. Wartość do wzorca: ^ [^ \\] * $ Na przykład pattern="xxxxx.nn.nn" odpowiada pięć znaków alfanumerycznych, okres, a następnie dwie cyfry, następnie okres, a następnie dwóch więcej cyfr.
value	wartość = "valueToCopy"	Parametr opcjonalny. Określa wartość do skopiowania na pole po value jest określone dla from atrybutu.

Zobacz też

Koncepcje

Definiowanie i modyfikowanie pól elementu roboczego

Zmiana przepływu pracy dla typu elementu pracy

Udostępnij za pośrednictwem