Sdílet prostřednictvím

Referenční dokumentace všech elementů XML FIELD

  • Článek

Toto téma použít k vyhledání syntaxe FIELD element nebo některého z jeho podřízených prvků.

Zadejte tyto prvky v FIELD element kontejneru (definice).Přidání pole pro typ pracovní položky (ŽÁ) a zadáním FIELD element (definice) v rámci FIELDS element (definice).Můžete zadat tyto prvky v rámci definice ŽÁ nebo jako součást globální pracovního postupu.

Můžete přidat podřízené elementy k určení chování pole, definovat výchozí hodnoty nebo definovat výběr seznam hodnot.Pravidlo prvků pole můžete použít v kombinaci s sebou.Většina pravidla pro aplikaci pro jednu nebo více uživatelů nebo skupin nebo mají ignorovat pro jeden nebo více uživatele nebo skupiny můžete obor.

Kontejner prvku pole (definice)

Pomocí následující syntaxe můžete definovat datová pole pro typ pracovní položky.Tento příklad ukazuje formát FIELD element (definice) a všechny volitelné podřízené elementy.Další informace naleznete v tématu Referenční dokumentace elementů FIELD (definice).

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

Podřízené elementy pole

Jaká data lze zadat do pole nastavení různých omezení pomocí podřízené elementy.Můžete určit hodnoty pro rozevírací seznam (rozevírací nabídka), nastavení výchozích hodnot, vymažte nebo omezit změny.Následující tabulka obsahuje strukturu syntaxe pro jednotlivé podřízené elementy.

Další informace o tom, jak tyto prvky použít, naleznete v části Použití pravidla pro pole pracovní položky.Existují omezení na použití většina pravidel na systémová pole.Všechny podřízené elementy jsou volitelné.

Prvek

Popis a syntaxe

ALLOWEDVALUES

Definuje seznam hodnot, které mohou uživatelé v seznamu polí ve formulářích pracovní položky a v editoru dotazu.Tento seznam je jedna z hodnot musíte určit uživatele.

<ALLOWEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>
</ALLOWEDVALUES>

Další informace naleznete v tématu Definování rozevíracích seznamů.

ALLOWEXISTINGVALUE

Určuje, že je pole můžete zachovat existující hodnotu, i v případě, že je již na rozevírací seznam.Všechny nové hodnoty pole musí být v seznamu.

<ALLOWEXISTINGVALUE />

Další informace naleznete v tématu Definování rozevíracích seznamů.

CANNOTLOSEVALUE

Určuje, že uživatelé nelze vymazat polem všechny hodnoty poté, co byla zadána hodnota.Poté, co toto pole obsahuje hodnotu, že pole musí obsahovat vždy hodnotu než NULL.

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

Další informace naleznete v tématu použít pravidlo pro pole.

COPY

Kopíruje zadanou hodnotu pole, když uživatel vytvoří nebo upraví pracovní položku.

<COPY for="userGroupName" not="userGroupName"  
from="value | field | clock | currentuser" 
value="valueToCopy" field="fieldReferenceName" />

Další informace naleznete v tématu Definování výchozí hodnoty nebo zkopírování hodnoty do pole.

DEFAULT

Určuje hodnotu pole, které je prázdný, když uživatel vytvoří nebo upraví pracovní položku.Pokud je pole již má hodnotu, výchozí pravidlo ignorováno.

<DEFAULT for="userGroupName" not="userGroupName" 
from="value | field | clock | currentuser" 
value="value to copy" field="field reference name" />

Další informace naleznete v tématu Definování výchozí hodnoty nebo zkopírování hodnoty do pole.

EMPTY

Vymaže pole libovolnou hodnotu, která obsahuje.EMPTY Pravidlo je také pole jen pro čtení, a byste neměli používat, pomocí tlačítek READONLY pravidlo.

Hodnota pole je zaškrtnuto, když uživatel uloží pracovní položky a nelze zadat libovolnou hodnotu.Toto pravidlo se používá převážně během přechod stavu zrušte polí, která se vztahují na stav, do kterého je položka přechod.

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

Další informace naleznete v tématu použít pravidlo pro pole.

FROZEN

Určuje, že po změny potvrzeny, nelze změnit pole na hodnotu není prázdný.Jakmile uživatel uloží pracovní položka s hodnotou v daném poli, lze upravit již hodnotu.

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

Další informace naleznete v tématu použít pravidlo pro pole.

HELPTEXT

Definuje text, který se zobrazí při umístění ukazatele na pole ve formuláři pracovní položku.

popsané tlačítko: řetězec textu, který obsahuje mezi 1 až 255 znaky.

<HELPTEXT>tooltipText </HELPTEXT>

Další informace naleznete v tématu použít pravidlo pro pole.

MATCH

Definuje vzor, který se musí shodovat hodnoty polí typu řetězec.

<MATCH pattern="patternValue" for="userGroupName" not="userGroupName" />

Další informace naleznete v tématu Použití porovnávání vzorů pro pole řetězce.

NOTSAMEAS

Určuje, zda je pole není přiřazen stejnou hodnotu jako, ke kterému je přiřazena jiná zadané pole.Hodnota field atribut musí být platný odkaz název pole.

<NOTSAMEAS field="fieldReferenceName" for="userGroupName" not="userGroupName" />

Další informace naleznete v tématu použít pravidlo pro pole.

PROHIBITEDVALUES

Definuje seznam hodnot, které nemůže obsahovat pole.Je-li toto pole obsahuje hodnotu zakázané nemohou uživatelé uložit pracovní položku.

<PROHIBITEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>
</PROHIBITEDVALUES>

Další informace naleznete v tématu Definování rozevíracích seznamů.

READONLY

Určuje, že nelze změnit hodnotu, ke kterému je přiřazena pole.

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

[!POZNÁMKA]

Nepoužívejte tento prvek spolu s EMPTY element protože EMPTY také usnadňuje pole jen pro čtení.Pokud se můžete spojit tyto prvky, budou vyhledány nekonzistentní.

Další informace naleznete v tématu použít pravidlo pro pole.

REQUIRED

Určuje, zda musí uživatelé zadat hodnotu pro pole.Povinná pole nemůže být prázdný.Uživatelé nelze uložit pracovní položky, dokud se přiřadili hodnoty všech požadovaných polí.

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

Další informace naleznete v tématu použít pravidlo pro pole.

SERVERDEFAULT

Zkopíruje hodnotu zadaného serveru do pole, když uživatel uloží pracovní položku.Tato pole obvykle zobrazují jen pro čtení ve formuláři.

<SERVERDEFAULT for="userGroupName" not="userGroupName" 
from="clock | currentuser" />

Další informace naleznete v tématu Definování výchozí hodnoty nebo zkopírování hodnoty do pole.

SUGGESTEDVALUES

Definuje navržené seznam hodnot, které mohou uživatelé v seznamu polí ve formulářích pracovní položky a v editoru dotazu.Uživatelé mohou určit hodnoty kromě těch, které můžete navrhnout.

<SUGGESTEDVALUES for="userGroupName" not="userGroupName" 
expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName">
      <LISTITEM value="Name" />
. . . 
   </GLOBALLIST>    
</SUGGESTEDVALUES>

Další informace naleznete v tématu Definování rozevíracích seznamů.

VALIDUSER

Zakazuje upravuje v uživatelé, kteří patří do skupiny, který zadáte pracovní položky.Výchozí skupina je Team Foundation skupina uživatelů platný.

Všechny atributy jsou volitelné.Všechny atributy musí obsahovat řetězec textu, který obsahuje mezi 1 až 255 znaky.Tokeny slouží k zadání skupin.

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

Další informace naleznete v tématu použít pravidlo pro pole.

WHEN

Určuje jedno nebo více pravidel, které mají být použity na aktuální pole při jiného pole má určitou hodnotu.Nadřazený FIELD element definuje aktuální pole.

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

Další informace naleznete v tématu Přiřazení podmíněných hodnot a pravidel

WHENNOT

Určuje jedno nebo více pravidel, které mají být použity na aktuální pole když jiného pole nemá ke konkrétní hodnotě.Nadřazený FIELD element definuje aktuální pole.

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

Další informace naleznete v tématu Přiřazení podmíněných hodnot a pravidel.

WHENCHANGED

Určuje jedno nebo více pravidel, které mají být použity na aktuální pole při změně jiného pole během revize pracovní položky.Nadřazený FIELD element definuje aktuální pole.

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

Další informace naleznete v tématu Přiřazení podmíněných hodnot a pravidel.

WHENNOTCHANGED

Určuje jedno nebo více pravidel, které mají být použity na aktuální pole při jiného pole zůstanou nezměněna během revize pracovní položky.Nadřazený element definuje aktuální pole.

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

Další informace naleznete v tématu Přiřazení podmíněných hodnot a pravidel.

GLOBALLIST a LISTITEM podřízené elementy

Můžete zadat GLOBALLIST a LISTITEM prvky jako podřízených elementů ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky.Tyto prvky slouží k vytvoření výčtu seznam hodnot, který se zobrazí.Uživatelé rozevírací seznam nebo rozevírací nabídky vyberte hodnoty.Další informace naleznete v tématu Definování globálních seznamů.

Prvek

Popis

GLOBALIST

Definuje sadu LISTITEM prvky, které jsou uloženy pro tým projektů kolekce a že všech týmových projektů v kolekci můžete použít.

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

globalListName: řetězec textu, který obsahuje mezi 1 až 255 znaky.

GLOBALLISTje třeba zadat podřízeného prvku GLOBALLISTS elementu a volitelné podřízeného prvku ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky.Můžete definovat globální seznam v rámci definici pracovní položky, definici globální seznam nebo globální pracovního postupu.

LISTITEM

Definuje platnou položku seznamu.

<LISTITEM value="listName" />

LISTITEMje třeba zadat podřízeného prvku GLOBALLIST a volitelné podřízeného prvku ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky.

Atributy určené parametrem podřízených prvků pole

Můžete zařadit většinu FIELD pravidla, která platí nevztahuje na sadu skupin nebo uživatelů zahrnutím for nebo not atributy.Další informace naleznete v tématu použít pravidlo pro pole.

Atribut

Syntaxe

Popis

expanditems

expanditems = "true | false"

Volitelné.Určuje, zda skupina, LISTITEM element identifikuje by měl být rozbaleny pro zahrnutí podřízených skupin v seznamu.Výchozí hodnota tohoto atributu je true.

filteritems

filteritems = "excludegroups"

Volitelné.Určuje, že pouze členové skupiny a nikoli názvy skupin, jsou zahrnuty v seznamu.Jedinou povolenou hodnotu pro tento atribut se excludegroups.

for

for = "userGroupName"

Volitelné.Určuje název uživatele nebo skupiny v Team Foundation do kterého bude pravidlo použito.Platné hodnoty jsou tvořeny řetězec textu, který obsahuje mezi 1 až 255 znaky.

not

není = "userGroupName"

Volitelné.Určuje název uživatele nebo skupiny v Team Foundation na kterému pravidlo nevztahuje.Platné hodnoty jsou tvořeny řetězec textu, který obsahuje mezi 1 až 255 znaky.

from

z = "hodnota | pole | hodiny | CurrentUser"

Požadováno.Určuje zdroj hodnoty, ze kterého chcete zkopírovat hodnotu nebo zadat výchozí hodnotu.Platné jsou následující hodnoty:

  • clock: Zkopíruje aktuální datum a čas z systémových hodin do pole Datum a čas. Jsou vyžadována žádná další atributy.Pro COPY a DEFAULT pravidla, tato hodnota pochází z čas místního počítače.Pro SERVERDEFAULT, hodnota pochází z server clock, když uživatel uloží pracovní položku.

  • currentuser: Zkopíruje jméno uživatele, který je aktuálně přihlášeni.Jako hodnotu použijte krátký uživatelské jméno aktuálního uživatele.Jsou vyžadována žádná další atributy.Používá se pro polí s řetězcem.

  • field: Zkopíruje hodnotu field atribut, který zadáte.Vyžaduje field="abc" atributu.Ve výchozím nastavení Pokud zadaný "od" je pole prázdné, nic se provádí.field Atribut se používá pouze pro < kopie > a < výchozí > pravidla.

  • value: Zkopíruje hodnotu value atribut, který zadáte.Použijte hodnotu řetězce konstantu, která zadáte.Vyžaduje value="abc" atributu.valuese používá pouze pro < kopie > a < výchozí > pravidla.

Pokud zadáte v poli "hodnota" nebo "pole", musíte rovněž uvést atribut hodnotu nebo pole v uvedeném pořadí.

field

pole = "fieldReferenceName"

Volitelné.Určuje název pole, jehož hodnota je zkopírovat do pole při field je určena pro from atributu.

pattern

Vzor = "patternValue"

Požadováno.Zajišťuje základní porovnávání pro pouze řetězce.patternValue je řetězec, který se skládá z 1 až 255 znaků, včetně.Tento řetězec nesmí obsahovat zpětné lomítko (\).Každý znak v řetězci je interpretován jako literál, pokud je jedním z následujících šesti metaznaky:

  • "A" nebo "a" představují jeden abecední znak.

  • "N" nebo "n" představují jednotlivé číslici.

  • "X" nebo "x" představují alfanumerický znak.

Hodnota vzorku: ^ [^ \\] * $

Například pattern="xxxxx.nn.nn" odpovídá pěti alfanumerických znaků, a po dobu a potom vyberte dvě číslice, pak po dobu, pak dvě více číslic.

value

Hodnota = "valueToCopy"

Volitelné.Určuje hodnotu, která má být zkopírována do pole při value je určena pro from atributu.

Viz také

Koncepty

Definování a úprava polí pracovní položky

Změna pracovního postupu pro typ pracovní položky