Sdílet prostřednictvím

All FIELD XML elements reference

  • Článek

Toto téma použít k vyhledání syntaxe FIELD elementu nebo jedna z jejích podřízených elementů.

Zadejte tyto prvky v FIELD kontejner elementu (definice). Přidat pole pro typ pracovní položky (ŽÁ) tak, že určíte FIELD element (definice) v rámci FIELDS element (definice). Můžete zadat tyto prvky v rámci definice kon nebo jako součást globální pracovního postupu.

Můžete přidat podřízené prvky k určení chování pole, definovat výchozí hodnoty nebo definovat výběr seznam hodnot. Pravidlo elementy pole můžete použít v kombinaci s sebou. Můžete obor většinu pravidel, které má být použita pro jeden nebo více uživatelů nebo skupin nebo ignorovat pro jeden nebo více uživatelů nebo skupin.

Element kontejneru pole (definice)

Pomocí následující syntaxe pro definování datová pole pro typ pracovní položky. Tento příklad ukazuje formát FIELD element (definice) a všechny volitelné podřízené prvky. Další informace naleznete v tématu FIELD (Definition) element reference.

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

POLE podřízených elementů

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

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é prvky jsou volitelné.

Element

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 třeba zadat 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 Define pick lists.

ALLOWEXISTINGVALUE

Určuje, zda pole můžete zachovat existující hodnotu, i když je již v seznamu výběr. Všechny nové hodnoty polí musí být v seznamu.

<ALLOWEXISTINGVALUE />

Další informace naleznete v tématu Define pick lists.

CANNOTLOSEVALUE

Určuje, zda uživatelé nelze vymazat pole všech hodnot poté, co byla zadána hodnota. Poté, co toto pole obsahuje hodnotu, toto 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 do 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 Define a default value or copy a value to a field.

DEFAULT

Určuje hodnotu pro pole, které je prázdný, když uživatel vytvoří nebo upraví pracovní položku. Pokud 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 Define a default value or copy a value to a field.

EMPTY

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

Hodnota pole není zaškrtnuto, když uživatel uloží s pracovní položkou a nelze zadat libovolnou hodnotu. Toto pravidlo se používá především během přechod stavu zrušte pole, které se vztahují na stav, na kterou je přechod položky.

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

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

FROZEN

Určuje, že jakmile změny potvrzeny, nelze změnit pole na neprázdnou hodnotu. Jakmile uživatel uloží pracovní položku 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 znaků.

<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 Apply pattern matching to a string field.

NOTSAMEAS

Určuje, zda pole není přiřazen stejnou hodnotu jako, ke kterému je přiřazena jiného zadaného pole. Hodnota field atribut musí být platný odkaz na 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é nemohou obsahovat pole. Uživatele nelze uložit pracovní položky, je-li toto pole obsahuje zakázané hodnoty.

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

Další informace naleznete v tématu Define pick lists.

READONLY

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

<READONLY for="userGroupName" not="userGroupName" />
PoznámkaPoznámka
Nepoužívejte tento element spolu s EMPTY elementu vzhledem k tomu, EMPTY také usnadňuje pole jen pro čtení.Pokud kombinujete tyto prvky, budou výsledky nekonzistentní.

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

REQUIRED

Určuje, zda uživatelé musí určovat hodnotu pro pole. Povinná pole nesmí být prázdný. Uživatele nelze uložit pracovní položky, dokud jejich přiřadili hodnoty všechna povinná pole.

<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 se obvykle vyskytují jen pro čtení ve formuláři.

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

Další informace naleznete v tématu Define a default value or copy a value to a field.

SUGGESTEDVALUES

Definuje seznam hodnot, které mohou uživatelé v seznamu polí ve formulářích pracovní položky a v editoru dotazu navrhované. 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 Define pick lists.

VALIDUSER

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

Všechny atributy jsou volitelné. Všechny atributy musí skládat z řetězce text, který obsahuje mezi 1 až 255 znaků. 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á má být použita pro aktuální pole, má-li jiné pole konkrétní 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 Assign conditional-based values and rules

WHENNOT

Určuje jedno nebo více pravidel, který bude použit na aktuální pole, pokud jiné pole nemá konkrétní hodnotu. 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 Assign conditional-based values and rules.

WHENCHANGED

Určuje jedno nebo více pravidel, která má být použita pro aktuální pole, je-li jiné pole změněn 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 Assign conditional-based values and rules.

WHENNOTCHANGED

Určuje jedno nebo více pravidel, který bude použit na aktuální pole, pokud jiné pole se nezmění 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 Assign conditional-based values and rules.

GLOBALLIST a LISTITEM podřízených elementů

Můžete zadat GLOBALLIST a LISTITEM elementy jako podřízené prvky ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES elementů. 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 Define global lists.

Element

Popis

GLOBALIST

Definuje sadu LISTITEM elementů, u nichž je uložen pro tým projektů kolekce a že všechny týmové projekty v kolekci můžete použít.

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

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

GLOBALLIST je povinný podřízený element elementu GLOBALLISTS element a volitelný podřízený prvek ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES elementů. Můžete definovat globální seznam v rámci definici pracovní položky, definice globálního seznamu nebo globální pracovního postupu.

LISTITEM

Definuje platnou položku seznamu.

<LISTITEM value="listName" />

LISTITEM je povinný podřízený element elementu GLOBALLIST a volitelný podřízený prvek ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES elementů.

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

Většina kvalifikovat FIELD pravidla, která použije nelze použít na sady skupin nebo uživatelů tak, že uvedete 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 tak, aby obsahoval podřízené skupiny v seznamu. Výchozí hodnota tohoto atributu je true.

filteritems

filteritems = "excludegroups"

Volitelné. Určuje, že pouze členové skupiny a nikoli pro názvy skupin, jsou zahrnuty v seznamu. Jediným povolená hodnota pro tento atribut je excludegroups.

for

for = "userGroupName"

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

not

není = "userGroupName"

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

from

from = "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 polí data a času. Je vyžadováno žádné další atributy. Pro COPY a DEFAULT pravidla, tato hodnota pochází z času hodin místního počítače. Pro SERVERDEFAULT, když uživatel uloží pracovní položku – hodnota pochází z hodin serveru.

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

  • field: Zkopíruje hodnotu field atribut, který určíte. Vyžaduje, aby field="abc" atributu. Ve výchozím nastavení Pokud zadaný "od" pole je 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ý určíte. Použijte hodnotu na řetězcovou konstantu. Vyžaduje, aby value="abc" atributu. value se používá pouze pro < kopie > a < výchozí > pravidla.

Pokud zadáte v poli "hodnota" nebo "pole", musíte rovněž uvést atribut value 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 rozmezí 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í jeden alfanumerický znak.

Hodnota vzorku: ^ [^ \\] * $

Můžete 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ě další číselné znaky.

value

Hodnota = "valueToCopy"

Volitelné. Určuje hodnota, kterou chcete zkopírovat do pole při value je určena pro from atributu.

Viz také

Koncepty

Define and modify work item fields

Change the workflow for a work item type