Udostępnij za pośrednictwem

Wszystkie elementy XML All FIELD — Odwołanie

  • Artykuł

W tym temacie umożliwia wyszukiwanie składnię FIELD element lub jednego z jego elementów podrzędnych.

Określ tych elementów w FIELD kontenera elementu (definicja).Dodaj pole do typu elementu roboczego (WIT) określając FIELD (definicja) elementu w obrębie FIELDS elementu (definicja).Można określić te elementy w ramach definicji WIT lub w ramach globalnego przepływu pracy.

Możesz dodać elementy podrzędne do określania zachowania pola, definiowanie wartości domyślnych lub zdefiniować listę pobrania wartości.Pole elementów reguły można użyć w połączeniu ze sobą.Można ograniczyć zakres większości reguł do zastosowania w jeden lub więcej użytkowników lub grup lub być ignorowane dla jednego lub kilku użytkowników lub grup.

Element kontener pola (definicja)

Następująca składnia umożliwia definiowanie pól danych dla typu elementu roboczego.W tym przykładzie przedstawiono format FIELD element (definicja) i wszystkich elementów podrzędnych 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

Aby ustawić różne ograniczenia na dane, które można wprowadzić w polu, należy użyć elementów podrzędnych.Można określić wartości dla listy wyboru (listy rozwijanej), ustaw wartości domyślne, wyczyszczenie wpisów lub ograniczyć możliwość zmian.W poniższej tabeli przedstawiono składnię struktury dla każdego elementu podrzędnego.

Aby dowiedzieć się, jak korzystać z tych elementów, zobacz Zastosowanie reguły do pola elementu roboczego.Istnieje ograniczenia dotyczące stosowania zasad większości z polami systemu.Wszystkie elementy podrzędne są opcjonalne.

Element

Opis i składni

ALLOWEDVALUES

Definiuje listę wartości, które użytkownicy mogą określać na liście pola w formularzach elementów roboczych i w edytorze zapytań.Użytkownicy muszą określić jedną z 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 zachować istniejącą wartość pola, 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 użytkowników nie można wyczyścić wszystkich wartości pola po zostało określone wartości.Po pole zawiera wartość, to pole zawsze musi zawierać wartość inna niż NULL.

<CANNOTLOSEVALUE for="userGroupName" not="userGroupName" />

Aby uzyskać więcej informacji, zobacz stosowanie reguły pole.

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óre jest pusta, gdy użytkownik tworzy lub modyfikuje element pracy.Jeśli pole jest już wartość, reguły domyślnej jest ignorowane.

<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 powoduje polem tylko do odczytu, a należy nie należy z niej korzystać 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 przede wszystkim podczas przejścia w stan, aby wyczyścić pola, które dotyczą stanu, do którego jest przenieść element.

<EMPTY for="userGroupName" not=" userGroupName" />

Aby uzyskać więcej informacji, zobacz stosowanie reguły pole.

FROZEN

Określa, że nie można zmienić pola z wartością niepusty zmiany zostaną potwierdzone.Jak użytkownik zapisuje element pracy z wartością w tym polu, wartość nie będzie można zmodyfikować.

<FROZEN for="userGroupName" not="userGroupName" />

Aby uzyskać więcej informacji, zobacz stosowanie reguły pole.

HELPTEXT

Definiuje tekst do wyświetlenia, gdy użytkownik wskazuje do pola formularza elementu pracy.

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

<HELPTEXT>tooltipText </HELPTEXT>

Aby uzyskać więcej informacji, zobacz stosowanie reguły pole.

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

PROHIBITEDVALUES

Definiuje wartości, które nie może zawierać pola listy.Użytkownicy nie mogą zapisywać elementem 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 wraz 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 pole.

REQUIRED

Określa, czy użytkownicy muszą określić wartość dla pola.Wymagane pola nie może być pusta.Użytkownicy nie mogą zapisywać 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 stosowanie reguły pole.

SERVERDEFAULT

Kopiuje wartość określonego serwera do pola, gdy użytkownik zapisuje element pracy.Te pola zwykle wyświetlane jako tylko do odczytu na 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 zasugerowano listy wartości, które użytkownicy mogą określać na liście pola w formularzach elementów roboczych 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.Jest domyślną grupą Team Foundation grupy użytkowników prawidłowe.

Wszystkie atrybuty są opcjonalne.Wszystkie atrybuty musi składać się z ciągu tekstowego, który zawiera od 1 do 255 znaków.Tokeny można użyć do określenia grupy.

< VALIDUSER group="groupName" for="userName" not="userName" />

Aby uzyskać więcej informacji, zobacz stosowanie reguły pole.

WHEN

Określa co najmniej jedną regułę do zastosowania do bieżącego pola w innym polu po określonej wartości.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śloną wartość.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 innym polu podczas zmiany elementów roboczych.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 zastosowania do bieżącego pola, gdy inne pole nie jest zmieniana 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.Te elementy można użyć do wyliczenia będzie widoczna lista wartości.Użytkownicy Wybieranie wartości z listy pobrania lub listy rozwijanej.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 można użyć zespołów projektów w kolekcji.

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

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

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.

LISTITEM

Definiuje wartość prawidłową listę.

<LISTITEM value="listName" />

LISTITEMjest elementem podrzędnym wymagane GLOBALLIST i opcjonalnie 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 odnoszą się do zestawu grup lub użytkowników, umieszczając for lub not atrybutów.Aby uzyskać więcej informacji, zobacz stosowanie reguły pole.

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.Wartość domyślna tego atrybutu to true.

filteritems

filteritems = "excludegroups"

Parametr opcjonalny.Określa, że tylko członkowie grupy, a nie nazw grup, znajdują się na liście.Jedyną dozwoloną wartość dla tego atrybutu jest excludegroups.

for

dla = "userGroupName"

Parametr opcjonalny.Określa nazwę użytkownika lub grupy w Team Foundation , do którego stosowana jest 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órego ma zostać 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 typu Data/Godzina. Żadne dodatkowe atrybuty są wymagane.Dla COPY i DEFAULT zasady, tej wartości pochodzą od czasu zegara komputera lokalnego.Dla SERVERDEFAULT, wartość pochodzi z zegara serwera, gdy użytkownik zapisuje element pracy.

  • currentuser: Kopiuje nazwę aktualnie zalogowanego użytkownika.Krótka nazwa bieżącego użytkownika można używać jako wartości.Żadne dodatkowe atrybuty są wymagane.Używany dla pól ciągów.

  • field: Kopiuje wartość field atrybut, który określisz.Wymaga field="abc" atrybutu.Domyślnie jeśli określony "z" 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ła ciągu, który określisz.Wymaga value="abc" atrybutu.valuejest używany tylko dla < KOPIOWANIA > i < domyślne > reguły.

Jeśli określono "wartość" lub "pole", należy również uwzględnić pole lub wartość atrybutu, odpowiednio.

field

pole = "fieldReferenceName"

Parametr opcjonalny.Określa nazwę pola, którego wartość ma na celu skopiowane do pola po field określono dla from atrybutu.

pattern

wzorzec = "patternValue"

Parametr wymagany.Wymusza podstawowy wzorzec dopasowania tylko ciągi.patternValue to ciąg składający się z od 1 do 255 znaków, włącznie.Ten ciąg nie może zawierać ukośnika (\).Każdy znak w ciągu jest interpretowany jako literału, 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" 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ść skopiowane do pola po value określono dla from atrybutu.

Zobacz też

Koncepcje

Definiowanie i modyfikowanie pól elementu roboczego

Zmiana przepływu pracy dla typu elementu pracy