Sdílet prostřednictvím

Všechny referenční elementy XML pole

  • Článek

Informace v tomto tématu můžete použít jako rychlý odkaz na všechny prvky a hlavní atributy, které definují datové pole typu pracovní položky. Určit tyto prvky FIELD prvku kontejneru (definice). Přidání pole pro položky typu práce zadáním FIELD prvku (definice) FIELDS prvku (definice). Tyto prvky v rámci definice typu práce můžete určit položky nebo jako součást globální pracovního postupu. Můžete vytvořit podřízené prvky, které toto téma popisuje chování pole zadat, definovat výchozí hodnoty nebo definovat seznam hodnot vyskladnění. Pravidlo prvky pole můžete použít v kombinaci s sebou. Obor lze většinu pravidel pro jeden nebo více uživatelů nebo skupin nebo ignorována u jednoho nebo více uživatelů nebo skupin.

Poznámka

Dříve než můžete definovat globální pracovní postup, musí být povoleno funkci vrstva aplikace serveru. Proto musí být spuštěn server verze Visual Studio Team Foundation Server, jako například Team Foundation Server 2010 Service Pack 1 (SP1) podporující tuto funkci. Aktualizace service pack můžete stáhnout z následující stránky na webu společnosti Microsoft: Service Pack 1 aplikace Visual Studio Team Foundation Server 2010 Beta. Další informace naleznete v tématu Přizpůsobení pracovního postupu globální.

Všechny podřízené prvky FIELD prvku jsou volitelné. S výjimkou HELPTEXT prvku, můžete určit všechny prvky jako podřízené prvky FIELD (definice) FIELD (pracovní) a FIELD prvky (globální pracovní postup). Použití FIELD prvku definovat pole pracovní položky a určit pravidla a podmínky, které uplatňují provázaných (definice) Určit pravidla pro FIELD prvku (pracovní) definovat hodnotu nebo použít pravidla pole jako pracovní položka přechody z jednoho státu do druhého. Můžete určit na základě pravidla pro pole STATE, TRANSITION, DEFAULTREASON, nebo REASON prvek, který jeho nadřazený prvek pole je dítě. Další informace naleznete v tématu Práce s poli pracovní položky a Návrhu pracovního postupu.

V tomto tématu

  • Kontejner prvek pole (definice)

  • Podřízené prvky pole

  • GLOBALLIST a podřízené prvky LISTITEM

  • Atributy určené podřízené prvky pole

Kontejner prvek pole (definice)

Definice datových polí typu pracovní položky pomocí následující syntaxe. Tento příklad ukazuje formát FIELD prvku (definice) a všechny volitelné podřízené prvky. Další informace naleznete v tématu Prvek pole (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é prvky pole

Následující tabulka popisuje podřízené prvky, které můžete určit pravidla pro přiřazení hodnoty pole. Všechny podřízené prvky jsou volitelné. Obor lze použít pouze jednu skupinu nebo s výjimkou pro uživatele v jedné skupině everyone většina podřízené prvky.

Prvek

Popis a syntaxe

ALLOWEDVALUES

Definuje seznam hodnot, které mohou uživatelé zadat do seznamu polí ve formulářích položky práce a editor dotazů. Musí uživatelé zadat jednu z hodnot seznamu je.

<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í seznamů vyskladnění.

ALLOWEXISTINGVALUE

Určuje pole zůstanou zachovány existující hodnoty, i když je již v seznamu vyskladnění. V seznamu musí být všechny nové hodnoty pole.

<ALLOWEXISTINGVALUE />

Další informace naleznete v tématu Definování seznamů vyskladnění.

CANNOTLOSEVALUE

Určuje, že uživatelé nelze vymazat pole všech hodnot po byla zadána hodnota. Po pole obsahuje hodnotu, toto pole musí vždy obsahovat NENULOVOU hodnotu.

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

Další informace naleznete v tématu Nastavení podmínek na poli položku práce.

COPY

Zkopíruje zadané hodnoty pole 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 Definice výchozí hodnoty nebo kopírování hodnoty pole.

DEFAULT

Určuje hodnotu pole, když uživatel vytvoří nebo upraví pracovní položka je prázdná. Pokud pole již obsahuje hodnotu, výchozí pravidlo je 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 Definice výchozí hodnoty nebo kopírování hodnoty pole.

EMPTY

Pole hodnot, které obsahuje vymaže. EMPTY Pravidlo také pole určené jen pro čtení, a není vhodné používat s READONLY pravidlo.

Hodnota pole není zaškrtnuté, když uživatel uloží položku a nelze zadat libovolnou hodnotu. Toto pravidlo slouží především během přechod stavu zaškrtnutí pole použít státu, do kterého je zboží přechází.

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

Další informace naleznete v tématu Nastavení podmínek na poli položku práce.

FROZEN

Určuje, že po změny potvrzeny, nelze změnit pole na neprázdnou hodnotu. Jakmile uživatel uloží se hodnota v poli pracovní položky, hodnota již změnit.

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

Další informace naleznete v tématu Nastavení podmínek na poli položku práce.

HELPTEXT

Definuje text se zobrazí, jestliže uživatel umístí na pole ve formuláři Položka práce.

tooltipText: Řetězec textu obsahujícího od 1 do 255 znaků.

<HELPTEXT>tooltipText </HELPTEXT>

Další informace naleznete v tématu Definování pracovní položky pole textu nápovědy.

MATCH

Definuje hodnoty polí typu řetězec musí odpovídat vzorek.

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

Další informace naleznete v tématu Provedení řetězce pole odpovídají vzorku.

NOTSAMEAS

Určuje, že pole je přiřazena stejná hodnota jako jiné zadané pole přiřazenou. Hodnota field atributu musí být platný odkaz na název pole.

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

Další informace naleznete v tématu Nastavení podmínek na poli položku práce.

PROHIBITEDVALUES

Definuje seznam hodnot, které nemůže obsahovat pole. Pokud pole obsahuje hodnotu zakázáno, uživatelé nemohou 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í seznamů vyskladnění.

READONLY

Určuje hodnotu pole přiřazenou nelze upravovat.

<READONLY for="userGroupName" not="userGroupName" />
PoznámkaPoznámka
Nepoužívejte tento prvek spolu s EMPTY prvek protože EMPTY také vytvoří pole určené jen pro čtení.Kombinace těchto prvků, nebudou výsledky konzistentní.

Další informace naleznete v tématu Nastavení podmínek na poli položku práce.

REQUIRED

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

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

Další informace naleznete v tématu Nastavení podmínek na poli položku práce.

SERVERDEFAULT

Uživatel uloží pracovní položka zkopíruje pole hodnotu určeného serveru. Tato pole se obvykle zobrazují jen pro čtení ve formuláři.

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

Další informace naleznete v tématu Definice výchozí hodnoty nebo kopírování hodnoty pole.

SUGGESTEDVALUES

Definuje navrhované seznam hodnot, které mohou uživatelé zadat do seznamu polí ve formulářích položky práce a editor dotazů. Uživatelé mohou určit hodnoty jiné než ty, které navrhnete.

<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í seznamů vyskladnění.

VALIDUSER

Omezuje pracovní položky upravovat uživatelé patřící do skupiny, kterou zadáte. Výchozí skupinu Team Foundation platní uživatelé skupiny.

Všechny atributy jsou volitelné. Musí obsahovat všechny atributy obsahující mezi 1 a 255 znaků textového řetězce. Můžete určit skupiny tokeny. Další informace naleznete v tématu Používání tokenů referenční uživatelům a skupinám.

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

Další informace naleznete v tématu Správa oprávnění vytvářet nebo upravovat pracovní položky.

WHEN

Určuje jedno nebo více pravidel použít aktuální pole při jiné pole má určitou hodnotu. Rodiče FIELD prvek 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 získáte v tématu Přiřazení hodnoty založené na podmíněné a pravidla

WHENNOT

Určuje jedno nebo více pravidel použít aktuální pole při jiné pole nemá určitou hodnotu. Rodiče FIELD prvek 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í hodnoty založené na podmíněné a pravidla.

WHENCHANGED

Určuje jedno nebo více pravidel použít aktuální pole při změně jiného pole během revize pracovní položky. Rodiče FIELD prvek 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í hodnoty založené na podmíněné a pravidla.

WHENNOTCHANGED

Určuje jedno nebo více pravidel použít aktuální pole při jiného pole se nezmění během revize pracovní položky. Nadřazený prvek 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í hodnoty založené na podmíněné a pravidla.

GLOBALLIST a podřízené prvky LISTITEM

Následující tabulka popisuje GLOBALLIST a LISTITEM prvky. Určit tyto prvky jako podřízené prvky ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky. Tyto prvky můžete vytvořit výčet seznamu hodnot se zobrazí jako seznam vyskladnění nebo rozevírací nabídky zboží, které může uživatel zadat. Další informace naleznete v tématu Definování a použití seznamů vyberte seznamy a seznamy globální.

Prvek

Syntaxe

Popis

GLOBALIST

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

Definuje sadu LISTITEM prvky, které jsou uloženy pro tým projektu sběru a že všechny týmové projekty v kolekci můžete použít.

globalListName: Řetězec textu obsahujícího od 1 do 255 znaků.

GLOBALLISTje vyžadován podřízený prvek GLOBALLISTS prvek a volitelné podřízený prvek ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky. Můžete definovat globální seznam definici pracovní položky, definice globálního seznamu nebo globální pracovního postupu.

LISTITEM

 
<LISTITEM value="listName" />

Definuje seznam platnou hodnotu.

LISTITEMje vyžadován podřízený prvek GLOBALLIST a volitelné podřízeného prvku ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky.

Zpět na začátek

Atributy určené podřízené prvky pole

Většina lze kvalifikovat FIELD pravidla vztahují nebo nevztahují na sadu skupin či uživatelů včetně for nebo not atributy. Další informace naleznete v tématu Pravidlo pro pole do skupiny oborů.

Atribut

Syntaxe

Popis

expanditems

expanditems = "true | false"

Nepovinné. Určuje, zda skupina, LISTITEM identifikuje prvek by měl být rozšířen zahrnout skupiny podřízeného seznamu. Výchozí hodnota tohoto atributu je true.

filteritems

filteritems = "excludegroups"

Nepovinné. Určuje, že pouze členové skupiny a nejsou názvy skupin jsou zahrnuty v seznamu. Jedinou povolenou hodnotu tohoto atributu je excludegroups.

for

u = "userGroupName"

Nepovinné. Určuje název uživatele nebo skupiny v Team Foundation ke kterému se vztahuje pravidlo. Platné hodnoty jsou tvořeny obsahující mezi 1 a 255 znaků textového řetězce.

not

není = "userGroupName"

Nepovinné. Určuje název uživatele nebo skupiny v Team Foundation ke kterému pravidlo nevztahuje. Platné hodnoty jsou tvořeny obsahující mezi 1 a 255 znaků textového řetězce.

from

z = "hodnota | pole | hodiny | CurrentUser"

Povinné. Určuje zdroj hodnota kopírování hodnoty nebo zadat výchozí hodnotu. Platné jsou následující hodnoty:

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

  • currentuser: Zkopíruje jméno aktuálně přihlášeného uživatele. Jako hodnotu použijte krátké jméno aktuálního uživatele. Jsou vyžadovány žádné další atributy. Použít u polí řetězec.

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

  • value: Zkopíruje hodnotu value atribut, který určíte. Použijte hodnotu řetězcová konstanta, kterou zadáte. Vyžaduje value="abc" atributu. valueslouží pouze pro <COPY> a <DEFAULT> pravidla.

Pokud zadáte "hodnota" nebo "pole" pole nebo hodnotu atributu musí obsahovat také jednotlivě.

field

pole = "fieldReferenceName"

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

value

Hodnota = "valueToCopy"

Nepovinné. Určuje hodnotu zkopírovány do pole při value je určena pro from atributu.

Zpět na začátek

Viz také

Koncepty

Definování a použití seznamů vyberte seznamy a seznamy globální

Práce s poli pracovní položky

Návrhu pracovního postupu

Historie změn

Datum

Poslední dokumenty

Důvod

Leden 2011

Revidované poskytují syntaxi pro všechny FIELD podřízené prvky a odebrat odkazy na témata, které byly odebrány.

Rozšíření informace