Sdílet prostřednictvím

Všechny referenční elementy jazyk 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 pro typ pracovní položky.Určení těchto prvků v FIELD (definice) prvku kontejneru.Přidat pole typu pracovní položky zadáním FIELD prvku (definice) FIELDS element (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 určit chování pole, definovat výchozí hodnoty nebo definovat rozevíracího seznamu hodnot.Prvky pole pravidlo lze použít v kombinaci s sebou.Většina pravidla platí pro jeden nebo více uživatelů nebo skupin nebo ignorovat pro jeden nebo více uživatelů nebo skupin lze obor.

Všechny podřízené prvky FIELD element jsou volitelné.S výjimkou HELPTEXT prvku, můžete určit všechny prvky jako podřízené prvky FIELD (definice), FIELD (pracovní postup), a FIELD prvky (globální pracovní postup).Můžete použít FIELD (definice) prvek definovat pole položku práce a určit pravidla a podmínky, které se vztahují k němu.Určit pravidla pro FIELD element (pracovní postup) Chcete-li definovat hodnotu nebo použít pravidla pro pole jako pracovní položka přechází z jednoho státu do druhého.Můžete určit na základě pravidla pro pole STATE, TRANSITION, DEFAULTREASON, nebo REASON které jeho nadřazený prvek pole je podřízený prvek.Další informace naleznete v tématu Práce s poli pracovní položky a Návrh pracovního postupu.

V tomto tématu

  • Kontejner prvku pole (definice)

  • Podřízené prvky pole

  • GLOBALLIST a LISTITEM podřízené prvky

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

Kontejner prvku pole (definice)

Použijte následující syntaxi pro definování datových polí 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 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 použít pravidla pro přiřazení hodnoty pole.Všechny podřízené prvky jsou volitelné.Většina podřízené prvky použít pouze pro jednu skupinu nebo pro všechny uživatele s výjimkou uživatelů v jedné skupině můžete obor.

Element

Popis a syntaxe

ALLOWEDVALUES

Definuje seznam hodnot, které mohou uživatelé v seznamu polí ve formulářích položky práce a v editoru dotazu.Uživatelé musí zadat jednu z hodnot v tomto seznamu.

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

Další informace naleznete v tématu Definice rozevíracích seznamů.

ALLOWEXISTINGVALUE

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

<ALLOWEXISTINGVALUE />

Další informace naleznete v tématu Definice rozevíracích seznamů.

CANNOTLOSEVALUE

Určuje, že uživatelé nelze vymazat pole všech hodnot, je-li poté, co byla zadána hodnota.Poté, co toto 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 v poli pracovní položky.

COPY

Když uživatel vytvoří nebo změní pracovní položka zkopíruje pole Zadaná hodnota.

<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 zkopírování hodnoty do pole.

DEFAULT

Určuje hodnotu pole, které je prázdné, když uživatel vytvoří nebo změní pracovní položky.Je-li pole již obsahuje 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 Definice výchozí hodnoty nebo zkopírování hodnoty do pole.

EMPTY

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

Hodnota pole není zaškrtnuto, pokud uživatel uloží pracovní položky a nelze zadat libovolnou hodnotu.Toto pravidlo se používá především během přechod stavu zaškrtnutí pole, která se vztahuje na stav, ke kterému je zboží přechází.

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

Další informace naleznete v tématu Nastavení podmínek v poli pracovní položky.

FROZEN

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

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

Další informace naleznete v tématu Nastavení podmínek v poli pracovní položky.

HELPTEXT

Určuje text, který se zobrazí, pokud uživatel umístí na pole ve formuláři Položka práce.

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

<HELPTEXT>tooltipText </HELPTEXT>

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

MATCH

Definuje vzor, který musí odpovídat hodnoty polí typu řetězec.

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

Další informace naleznete v tématu Zajištění, aby pole řetězce odpovídalo vzoru.

NOTSAMEAS

Určuje, že pole není přiřazena stejná hodnota jako, ke kterému je přiřazena jinému 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 Nastavení podmínek v poli pracovní položky.

PROHIBITEDVALUES

Definuje seznam hodnot, které nemůže obsahovat pole.Pokud pole obsahuje hodnotu zakázáno, nemohou uživatelé uložit pracovní položky.

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

Další informace naleznete v tématu Definice rozevíracích seznamů.

READONLY

Určuje, že nelze změnit hodnotu pole přiřazenou.

<READONLY for="userGroupName" not="userGroupName" />
PoznámkaPoznámka
Nepoužívejte tento prvek spolu s EMPTY element protože EMPTY také vytvoří pole jen pro čtení.Pokud zkombinujete tyto prvky, budou výsledky nekonzistentní.

Další informace naleznete v tématu Nastavení podmínek v poli pracovní položky.

REQUIRED

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

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

Další informace naleznete v tématu Nastavení podmínek v poli pracovní položky.

SERVERDEFAULT

Zkopíruje hodnotu zadaného serveru na pole, když uživatel uloží pracovní položka.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 Definice výchozí hodnoty nebo zkopírování hodnoty do pole.

SUGGESTEDVALUES

Definuje navrhovaný seznam hodnot, které mohou uživatelé v seznamu polí ve formulářích položky práce a v editoru dotazu.Uživatelé mohou zadat hodnoty, 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 Definice rozevíracích seznamů.

VALIDUSER

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

Všechny atributy jsou volitelné.Všechny atributy musí být tvořena textový řetězec, který obsahuje 1 až 255 znaků.Určit skupiny můžete použít tokeny.Další informace naleznete v tématu Odkazování na uživatele a skupiny pomocí tokenů.

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

Další informace naleznete v tématu Správa oprávnění k vytváření a úpravám pracovních položek.

WHEN

Určuje jedno nebo více pravidel lze aplikovat na aktuální pole, když má určitou hodnotu jiného pole.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 lze aplikovat na aktuální pole, když jiné pole nemá určitou 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 Přiřazení podmíněných hodnot a pravidel.

WHENCHANGED

Určuje jedno nebo více pravidel lze aplikovat na aktuální pole, když jiné pole je 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 Přiřazení podmíněných hodnot a pravidel.

WHENNOTCHANGED

Určuje jedno nebo více pravidel lze aplikovat na aktuální pole, když 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 Přiřazení podmíněných hodnot a pravidel.

GLOBALLIST a LISTITEM podřízené prvky

V následující tabulce jsou popsány GLOBALLIST a LISTITEM prvky.Zadáte-li tyto prvky jako podřízené prvky ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky.Tyto prvky lze vytvořit výčet seznamu hodnot, který se zobrazí jako seznam vyskladnění nebo rozbalovací nabídky položky, které může uživatel zadat.Další informace naleznete v tématu Definice vlastních seznamů, rozevíracích seznamů a globálních seznamů.

Element

Syntaxe

Description

GLOBALIST

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

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

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

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

LISTITEM

 
<LISTITEM value="listName" />

Určuje platnou položku seznamu.

LISTITEMje vyžadovaným podřízeným prvkem GLOBALLIST a volitelný podřízený prvek ALLOWEDVALUES, SUGGESTEDVALUES, a PROHIBITEDVALUES prvky.

Zpět na začátek

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

Máte nárok většinu FIELD pravidla pro použití nebo není platné pro sadu skupin nebo uživatelů, včetně for nebo not atributy.Další informace naleznete v tématu Omezení oboru pravidla pole na skupinu.

Atribut

Syntaxe

Description

expanditems

expanditems = "true | false"

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

filteritems

filteritems = "excludegroups"

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

for

u = "userGroupName"

Nepovinné.Určuje jméno uživatele nebo skupinu v Team Foundation ke kterému se vztahuje dané pravidlo.Platné hodnoty jsou tvořeny textový řetězec, který obsahuje 1 až 255 znaků.

not

Ne = "userGroupName"

Nepovinné.Určuje jméno uživatele nebo skupinu v Team Foundation do kterého se pravidlo neplatí.Platné hodnoty jsou tvořeny textový řetězec, který obsahuje 1 až 255 znaků.

from

z = "hodnota | pole | hodiny | CurrentUser"

Povinné.Určuje zdroj hodnoty, ze kterého chcete zkopírovat hodnoty nebo určit 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. Žádné další atributy jsou požadovány.Pro COPY a DEFAULT pravidla, tato hodnota je převzata z čas 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 právě přihlášen.Jako hodnotu použijte krátké uživatelské jméno aktuálního uživatele.Žádné další atributy jsou požadovány.Použitá pro řetězec pole.

  • field: Zkopíruje hodnotu field atribut, který zadáte.Vyžaduje field="abc" atribut.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ý zadáte.Použijte hodnotu řetězcová konstanta, který zadáte.Vyžaduje value="abc" atribut.valueslouží pouze pro <COPY> a <DEFAULT> pravidla.

Pokud zadáte "hodnota" nebo "pole", musíte rovněž uvést hodnotu nebo pole atributu, respektive.

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

pattern

vzorek = "patternValue"

Povinné.Uplatňuje základní pouze řetězce pro porovnávání se vzorky.patternValue je řetězec, který se skládá z 1 až 255 znaků, včetně.Tento řetězec nesmí obsahovat znak zpětného lomítka (\).Každý znak v řetězci je interpretován jako literální, není-li jeden 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ředstavuje alfanumerický znak.

Vzorek hodnota: ^ [^ \\] *$

Například pattern="xxxxx.nn.nn" odpovídá pěti alfanumerických znaků a období, pak dvěma číselnými znaky, pak období a potom vyberte dvě další číselné znaky.

value

Hodnota = "valueToCopy"

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

Zpět na začátek

Viz také

Koncepty

Definice vlastních seznamů, rozevíracích seznamů a globálních seznamů

Práce s poli pracovní položky

Návrh pracovního postupu