Wszystkie odniesienia do elementów XML pola

Artykuł
03/26/2013

Informacje w tym temacie można wykorzystać jako podręczny wykaz wszystkie elementy i atrybuty głównych, które określają pole danych dla typu elementu pracy.Określenie tych elementów w FIELD (definicja) element kontenera.Dodanie pola dla typu elementu pracy przez określenie FIELD (definicja) elementu wewnątrz FIELDS element (definicja).Można określić te elementy w ramach definicji typu pracy, element lub w ramach globalnego przepływu pracy.Można tworzyć podrzędne elementy, które w tym temacie opisano Określanie zachowania pola, zdefiniować wartości domyślne lub zdefiniować listę pobrania wartości.Pola elementów reguły można użyć w połączeniu ze sobą.Można ustalić zakres większości reguł, aby zastosować do jednego lub więcej użytkowników lub grup lub zignorowanie dla jednego lub więcej użytkowników lub grup.

Wszystkie elementy podrzędne FIELD elementu są opcjonalne.Z wyjątkiem HELPTEXT element, wszystkie elementy można określić jako elementy podrzędne FIELD (definicja), FIELD (przepływ pracy), i FIELD elementy (globalny przepływ pracy).Możesz użyć FIELD element (definicja), aby zdefiniować pole elementu pracy i określić zasady i warunki, które go dotyczą.Należy określić reguły dla FIELD elementów (przepływ pracy), aby zdefiniować wartości lub stosowanie reguł do pola jako elementu pracy przejścia z jednego Państwa do drugiego.Można określić na podstawie reguł dla pola STATE, TRANSITION, DEFAULTREASON, lub REASON element, którego dziecko jest jego element nadrzędny w polach.Aby uzyskać więcej informacji, zobacz Praca z polami elementu pracy i Projektowanie przepływu pracy.

W tym temacie

Elementu-kontenera OSTROŚCI (definicja)
Elementy podrzędne pola
GLOBALLIST i LISTITEM elementów podrzędnych
Atrybuty określone przez elementy podrzędne pola

Elementu-kontenera OSTROŚCI (definicja)

Następująca składnia umożliwia definiowanie pól danych dla typu elementu pracy.W tym przykładzie przedstawiono format FIELD (definicja) element i wszystkie elementy podrzędne opcjonalne.Aby uzyskać więcej informacji, zobacz Element pola (definicja).

<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

W poniższej tabeli opisano elementy podrzędne, które można określić, aby zastosować zasady przypisywania wartości do pola.Wszystkie elementy podrzędne są opcjonalne.Można ustalić zakres większości elementów podrzędnych, które będą stosowane tylko do jednej grupy lub do wszystkich osób z wyjątkiem użytkowników w jednej grupie.

Element	Opis i składnia
ALLOWEDVALUES	Określa listę wartości, które użytkownicy mogą określać liście pól w formularzach elementu pracy i w edytorze zapytań.Użytkownicy muszą określić jedną z wartości tej listy. `<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, że pole można zachować istniejącą wartość, nawet jeśli nie jest już na liście pobrań.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ć pole wszystkich wartości po określono wartość.Po pole to zawiera wartość, to pole musi zawsze zawierać wartość NIEZEROWĄ. `<CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />` Aby uzyskać więcej informacji, zobacz Ustawianie warunków pola elementu pracy.
COPY	Kopiuje określoną wartość do pola, gdy użytkownik tworzy lub modyfikuje elementu 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óre jest puste, gdy użytkownik tworzy lub modyfikuje elementu pracy.Jeśli pole ma już wartość, domyślna reguła 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 pole dowolną wartość, którą zawiera.EMPTY Reguła również sprawia, że pole tylko do odczytu, a użytkownik nie należy się go używać z READONLY reguły. Wartość pola jest wyczyszczone, gdy użytkownik zapisuje element pracy i nie można określić dowolną wartość.Ta reguła służy przede wszystkim podczas przejście stanu usuwanie zaznaczeń pól, które mają zastosowanie do Państwa, do którego jest przejście elementu. `<EMPTY for="userGroupName" not=" userGroupName" />` Aby uzyskać więcej informacji, zobacz Ustawianie warunków pola elementu pracy.
FROZEN	Określa, że nie można zmienić pola na wartość nie jest pusta po zmiany są przekazywane.Tak szybko, jak użytkownik zapisuje element pracy w tym polu wartość, wartość nie może być modyfikowany. `<FROZEN for="userGroupName" not="userGroupName" />` Aby uzyskać więcej informacji, zobacz Ustawianie warunków pola elementu pracy.
HELPTEXT	Określa tekst do wyświetlenia, gdy użytkownik wskaże do pola w formularzu elementu pracy. tooltipText: ciąg tekstowy, który zawiera od 1 do 255 znaków. `<HELPTEXT>tooltipText </HELPTEXT>` Aby uzyskać więcej informacji, zobacz Definiowanie tekstu pomocy dla pola elementu pracy.
MATCH	Definiuje wzorzec, który musi odpowiadać wartości pól typu ciąg. `<MATCH pattern="patternValue" for="userGroupName" not="userGroupName" />` Aby uzyskać więcej informacji, zobacz Dopasowywanie pola ciągu do wzorca.
NOTSAMEAS	Określa, że pola nie przypisano tę samą wartość co do którego przypisany inny określonego pola.Wartość field atrybut musi być prawidłowym odwołaniem nazwę pola. `<NOTSAMEAS field="fieldReferenceName" for="userGroupName" not="userGroupName" />` Aby uzyskać więcej informacji, zobacz Ustawianie warunków pola elementu pracy.
PROHIBITEDVALUES	Określa listę wartości, które nie mogą zawierać pola.Użytkownicy nie można zapisać 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ść, do której przypisany jest pole. `<READONLY for="userGroupName" not="userGroupName" />` Uwaga Nie należy używać tego elementu wraz z EMPTY element bo EMPTY również sprawia, że pole tylko do odczytu.Jeśli połączenie tych elementów, wyniki będą niespójne. Aby uzyskać więcej informacji, zobacz Ustawianie warunków pola elementu pracy.
REQUIRED	Określa, że użytkownicy muszą określić wartość dla pola.Wymagane pola nie może być pusta.Użytkownicy nie można zapisać elementu pracy, dopóki nie zostały one przypisane wartości do wszystkich wymaganych pól. `<REQUIRED for="userGroupName" not="userGroupName" />` Aby uzyskać więcej informacji, zobacz Ustawianie warunków pola elementu pracy.
SERVERDEFAULT	Kopiuje wartość określonego serwera z polem, gdy użytkownik zapisuje elementu pracy.Pola te pojawiają się zwykle w trybie 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	Określa listę sugerowanych wartości, które użytkownicy mogą określać liście pól w formularzach elementu pracy i w edytorze zapytań.Użytkownicy mogą określać wartości inne niż te, które zostanie zaproponowana. `<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 grupy, który określisz.Domyślna grupa jest Team Foundation grupy uprawnieni użytkownicy. Wszystkie atrybuty są opcjonalne.Wszystkie atrybuty muszą składać się z ciągu tekstowego, który zawiera od 1 do 255 znaków.Tokeny służy do określania grup.Aby uzyskać więcej informacji, zobacz Użycie tokenów do tworzenia odwoływań do użytkowników i grup. `< VALIDUSER group="groupName" for="userName" not="userName" />` Aby uzyskać więcej informacji, zobacz Zarządzanie uprawnieniami w celu utworzenia lub modyfikacji elementów pracy.
WHEN	Określa jedną lub więcej reguł, aby zastosować do bieżącego pola, gdy kolejne pole ma określoną wartość.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 uzależnionych od warunków wartości i reguł.
WHENNOT	Określa jedną lub więcej reguł, aby zastosować do bieżącego pola, gdy inne pole nie ma określonej wartości.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 uzależnionych od warunków wartości i reguł.
WHENCHANGED	Określa jedną lub więcej reguł, aby zastosować do bieżącego pola, gdy innego pola zostanie zmieniona podczas zmiany elementu pracy.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 uzależnionych od warunków wartości i reguł.
WHENNOTCHANGED	Określa jedną lub więcej reguł, aby zastosować do bieżącego pola, gdy inne pole nie jest zmieniana podczas zmiany elementu pracy.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 uzależnionych od warunków wartości i reguł.

GLOBALLIST i LISTITEM elementów podrzędnych

W poniższej tabeli opisano GLOBALLIST i LISTITEM elementy.Określ te elementy jako elementy podrzędne ALLOWEDVALUES, SUGGESTEDVALUES, i PROHIBITEDVALUES elementy.Te elementy można użyć do sortowania listy wartości, które pojawia się jako lista pobrań lub w menu rozwijanym przedmiotów, które użytkownik może określić.Aby uzyskać więcej informacji, zobacz Definiowanie list użytkowników, list wyboru i list globalnych.

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

Element

Składnia

Opis

GLOBALIST

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

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

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

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.

LISTITEM

<LISTITEM value="listName" />

Definiuje wartość prawidłową listę.

LISTITEMjest elementem podrzędnym wymagane GLOBALLIST oraz opcjonalne podrzędnych elementu ALLOWEDVALUES, SUGGESTEDVALUES, i PROHIBITEDVALUES elementy.

Powrót do początku

Atrybuty określone przez elementy podrzędne pola

Masz prawo większość FIELD zasady dotyczące stosowania lub nie ma zastosowania do wielu grup lub użytkowników, w tym for lub not atrybuty.Aby uzyskać więcej informacji, zobacz Wyznaczanie zakresu reguły pola na grupie.

Atrybut	Składnia	Opis
expanditems	expanditems = "true \| false"	Opcjonalne.Określa, czy grupa że LISTITEM identyfikuje element powinny być uzupełnione o podrzędnego grup na liście.Wartością domyślną tego atrybutu jest true.
filteritems	filteritems = "excludegroups"	Opcjonalne.Określa, że tylko członkowie grupy, a nie nazw grup, są uwzględniane na liście.Jedyną dozwoloną wartość dla tego atrybutu jest excludegroups.
for	za = "userGroupName"	Opcjonalne.Specifies the name of a user or group in Team Foundation to whom the rule applies.Prawidłowe wartości składają się z ciągu tekstowego, który zawiera od 1 do 255 znaków.
not	nie = "userGroupName"	Opcjonalne.Specifies the name of a user or group in Team Foundation to whom the rule does not apply.Prawidłowe wartości składają się z ciągu tekstowego, który zawiera od 1 do 255 znaków.
from	from = "wartość \| pole \| zegar \| CurrentUser"	Wymagane.Określa źródło wartości, z których można skopiować wartość lub określić wartość domyślną.Prawidłowe są następujące wartości: clock: Kopiuje bieżącą datę i godzinę z zegara systemowego do pól typu Data/Godzina. Wymagane są nie dodatkowe atrybuty.Dla COPY i DEFAULT zasady, wartość ta pochodzi od czasu zegar komputera lokalnego.Dla SERVERDEFAULT, wartość pochodzi z zegara serwera, gdy użytkownik zapisuje elementu pracy. currentuser: Kopiuje nazwę użytkownika, który jest aktualnie zalogowany.Użyć krótkiej nazwy użytkownika bieżącego użytkownika jako wartości.Wymagane są nie dodatkowe atrybuty.Używane dla pól, ciąg. field: Wartość kopiuje field atrybut, który określisz.Wymaga field="abc" atrybut.Domyślnie jeśli określony "od" pole jest puste, nic nie jest wykonywane.field Atrybut jest używany tylko dla <COPY> i <DEFAULT> reguły. value: Wartość kopiuje value atrybut, który określisz.Należy użyć wartości to stała ciągu, który określisz.Wymaga value="abc" atrybut.valuejest używana tylko do <COPY> i <DEFAULT> reguły. Jeśli określisz, że "wartość" lub "pole", również musi zawierać atrybut wartości lub pola, odpowiednio.
field	pole = "fieldReferenceName"	Opcjonalne.Określa nazwę pola, której wartość ma być kopiowana do pola po field jest określony dla from atrybut.
pattern	wzór = "patternValue"	Wymagane.Enforces basic pattern matching for strings only.patternValue jest ciągiem, który składa się z od 1 do 255 znaków, włącznie.Ten ciąg nie może zawierać znaku kreski ułamkowej odwróconej (\).Każdy znak w ciągu jest interpretowana jako literał, chyba że jest to jeden z następujących sześciu metaznaki: "A" lub "" reprezentuje pojedynczy znak alfabetu. "N" lub "n" reprezentuje pojedynczy znak numeryczny. "X" lub "x", reprezentują pojedynczy znak alfanumeryczny. Pattern value: ^[^\\]*$ Na przykład pattern="xxxxx.nn.nn" pasuje do pięciu znaków alfanumerycznych, a następnie w okresie, a następnie dwa znaki numeryczne, okres, a następnie dwa więcej znaków numerycznych.
value	wartość = "valueToCopy"	Opcjonalne.Określa wartość, aby być kopiowana do pola po value jest określony dla from atrybut.

Powrót do początku

Zobacz też

Koncepcje

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

Praca z polami elementu pracy

Projektowanie przepływu pracy

Udostępnij za pośrednictwem