Prvek pole (definice)

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.Atributy, které můžete přiřadit k poli určit, jak bude vypadat ve formulář pracovní položky a zda je do sestavy zahrnout.Spravovat nastavení pole přiřazení pro kolekci týmového projektu.Proto atributy, které přiřadíte polí, které jsou definovány v jeden typ pracovní položky musí odpovídat všech typů pracovních položek pro všechny týmové projekty v kolekci.Kromě toho všech hodné pole ze všech kolekcí jsou vyváženy do databáze datového skladu.

[!POZNÁMKA]

Informace týkající FIELD element (pracovní postup), které můžete určit pravidla a podmínky, které pole během přechod pro změnu nebo pracovní postup stavu, viz Prvek pole (pracovní postup).

Můžete změnit atribut přiřazení, provedené na stávající pole kolekce pomocí witadmin příkaz nástroje.Další informace naleznete v tématu Správa polí pracovních položek [witadmin].

Schéma hierarchie

WITD

   WORKITEMTYPE

      POLE

            FIELD

<xs:element name="FIELD" type="FieldDefinition" maxOccurs="unbounded"/>

<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID" syncnamechanges ="true | false" reportable="Dimension | Detail | Measure" formula="sum" reportingname="ReportingDisplayName" reportingrefname="ReportingReferenceName" >
   <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>

Atributy a elementy

Následující části popisují atributy, podřízené prvky a rodičovské prvky.

Atributy

Atribut	Description
name	Povinné.Popisný název pole, které se objeví v rozevíracích nabídkách pracovní položku dotazy.Popisný název musí být jedinečný ve všech oblastech, které jsou definovány v rámci týmového projektu.Popisný název se také může lišit od popisek, který se zobrazí vedle pole na formulář pracovní položky.Další informace naleznete v tématu Odkaz Element jazyk XML řízení. Atribut type je typelib:FieldName.Minimální délka: 1; Maximální délka: 128. Vzorek hodnota: ^ [^ \.\[\]]+$ Příklad hodnoty vzorek: přiřazené k
refname	Povinné.Jedinečný popisek, který odlišuje pole ze všech polí, které jsou definovány v kolekci týmového projektu. Další požadavky a omezení popisné názvy a názvy odkaz naleznete v tématu Vytváření názvů pro objekty sledování pracovní položky. Atribut type je typelib:ReferenceFieldName.Minimální délka: 1; Maximální délka: 70. Vzorek hodnota: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [-zA-Z0-9_] +) +$ Příklad hodnoty vzorek: Company.IssueType
type	Povinné.Určuje typ dat, který přijímá pole. Poznámka Pole v jiném projektu kolekcí, které mají stejný reportingrefname musí být přiřazena stejná hodnota pro type.Pokud se hodnoty liší, konflikty dat může dojít při zpracování datového skladu.Další informace naleznete v tématu Řešení konfliktů schémat, které se vyskytují v datovém skladu. V následující tabulce jsou uvedeny platné hodnoty pro tento atribut: ValuePoužití DateTime Určuje datum podle koordinovaný světový čas (UTC) okamžiku v čase. Double Určuje hodnotu s plovoucí desetinnou čárkou. GUID Určuje pole, která bude obsahovat jedinečný identifikátor. History Podporuje posloupnosti diskusí a uchovává informace o dalších historických informací. Poznámka System.History Je pouze pole, která používá tento typ dat pole.Nelze definovat vlastní pole, pomocí tohoto datového typu. HTML Podporuje sběr dat RTF a používá se pro delší textové popisy, jako je například popis položky práce. Integer Určuje hodnotu 32bitové celé číslo se znaménkem. PlainText Podporuje vstup textový řetězec, který může obsahovat maximálně 255 znaků Unicode. String Podporuje vstup textový řetězec, který může obsahovat až 255 znaků Unicode.Použijte pole řetězec popisku nebo jiných krátký textový řetězec až jeden řádek. TreePath Určuje pole, které zobrazuje položky v hierarchická nebo stromové struktury, například co je nutné k zobrazení plochy a iterace cesty pro produkt.Chcete-li definovat podřízené uzly, viz Vytvořit a upravit oblasti a iterací. Poznámka System.AreaPath a System.IterationPath jsou pouze pole, které používají tento typ dat pole.Nelze definovat vlastní pole, pomocí tohoto datového typu.
syncnamechanges	Nepovinné.Určuje, zda pole položku práce slouží k ukládání jmen, které mají být aktualizovány, jakmile jsou změny ve službě Active Directory nebo k pracovní skupině.Tato možnost je platná pouze při type="String".Atribut type je xs:boolean. Zadejte true Chcete-li povolit synchronizaci pro datové pole, zadejte false Chcete-li zakázat synchronizaci pro datové pole.
reportable	Nepovinné.Určuje, zda data z pole do sestavy zahrnout.Pole s výchozí hodnotou None jsou exportovány do skladu relačních dat ani zpracování SQL Server krychli služby Analysis Services.Další informace o polích hodné, viz Přidání a úpravy polí pracovních položek jako podpora tvorby sestav. Poznámka Pole v jiném projektu kolekcí, které mají stejnou hodnotu reportingrefname musí být přiřazena stejná hodnota pro reportable.Pokud se hodnoty liší, konflikty dat může dojít při zpracování datového skladu.Další informace naleznete v tématu Řešení konfliktů schémat, které se vyskytují v datovém skladu. V následující tabulce jsou uvedeny platné hodnoty pro tento atribut: Value Použití Detail Lze určit pro pole typu datum a čas, Double, celé číslo nebo řetězec. Data v tomto poli je přesunuta do relační databázi pracovní položky a aktuální pracovní položky tabulky, ale ne do krychli služby Analysis Services.Tento typ je vhodný pro neomezené textové pole, protože je lze využít v sestavách bez vytváření datové krychle podstatně větší. Dimension Lze určit pro pole typu datum a čas, Double, celé číslo nebo řetězec. Data v tomto poli zadá relační databázi a datovou krychli služby Analysis Services jako atribut dimenze pracovní položku, aby data lze použít k filtrování sestav.Pomocí tohoto typu pole, které seznamy platných hodnot.Pracovní položka Typ a stav jsou dobrým příkladem dimenze. Measure Typ opatření slouží pouze pro celé číslo a dvojité polí.Opatření jsou číselné hodnoty v sestavách.Při zpracování datové krychle služby pro analýzu dat je předem vypočítány na pole jehož reportable atributy jsou nastaveny pro měření.Například pracovní položky a aktuální pracovní položka skupiny měr obsahují souhrnná data pro následující pole: původní odhad, zbývající hodiny a hodiny byla dokončena.Zadáte-li opatření, je nutné zadat formula atribut. None Zadejte None není Chcete-li použít pole zahrnout do sestavy.Toto je výchozí přiřazení.
formula	Nepovinné.Typ agregace pro measure hodné typu.Jediná platná hodnota je sum, která vrací součet všech hodnot v sadě.
reportingname	Nepovinné.Určuje název, který se objeví v sestavách.Pokud nezadáte hodnotu, hodnotu, která je přiřazena name atribut je použit. Poznámka Pole v jiném projektu kolekcí, které mají stejný reportingrefname musí být přiřazena stejná hodnota pro reportingname.Pokud se hodnoty liší, konflikty dat může dojít při zpracování datového skladu.Další informace naleznete v tématu Řešení konfliktů schémat, které se vyskytují v datovém skladu. Atribut type je typelib:FieldName.Minimální délka: 1; Maximální délka: 128. Vzorek hodnota: ^ [^ \.\[\]]+$ Příklad hodnoty vzorek: přiřazené k
reportingrefname	Nepovinné.Určuje název odkazu, který se používá při zpracování událostí podléhajících pole.Pokud nezadáte hodnotu, hodnotu, která je přiřazena refname atribut je použit. Tento atribut můžete použít ke sloučení nebo odchýlit polí, které jsou zpracovány do datového skladu.Sloučit dvě pole, které jsou definovány v kolekce různých projektů, které mají názvy odlišné odkaz, přiřadíte stejné reportingrefname obou z nich.Odchýlit se dvě pole, které mají stejný název odkazu, ale které jsou definovány v kolekce různých projektů, můžete přiřadit jinou reportingrefname k jednotlivým polím. Měli byste sloučit pole, kdykoli je to možné, minimalizovat počet polí ve skladu a vést pod maximální limit 1024 hodné polí.Můžete generovat sestavy křížové skupiny obsahující sloučené pole. Atribut type je typelib:ReferenceFieldName.Minimální délka: 1; Maximální délka: 70. Vzorek hodnota: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [-zA-Z0-9_] +) +$ Příklad hodnoty vzorek: Company.IssueType

Podřízené elementy

Element	Description
ALLOWEDVALUES	Nepovinné.Definuje seznam povolených hodnot pro pole.Povolené hodnoty jsou hodnoty, které jsou k dispozici pro výběr v seznamu polí ve formulářích položky práce a v okně Tvůrce dotazu.Je třeba vybrat jednu z těchto hodnot.
ALLOWEXISTINGVALUE	Nepovinné.Definuje pole Povolit existující hodnoty.Tento prvek umožňuje hodnoty polí, které již mají být použity, i v případě, že nejsou platné.Všechny nové hodnoty pole musí být platné.
CANNOTLOSEVALUE	Nepovinné.Definuje pole nemůže dojít ke ztrátě hodnoty.Tento prvek udržuje aktuální hodnotu pole a nemůže být zrušeno nebo provedené prázdný.
KOPIE	Nepovinné.Určuje další pole, které obsahuje hodnoty mají být zkopírovány do aktuálního pole.
VÝCHOZÍ	Nepovinné.Definuje výchozí hodnotu pro pole.
PRÁZDNÉ	Nepovinné.Definuje pole jako prázdný.
ZMRAZENÉ	Nepovinné.Definuje pole jako zmrazené.Zmrazené pole nelze změnit na libovolnou hodnotu prázdný, po změny potvrzeny.Můžete však ručně vymazat pole, uložit pracovní položky a zadejte jinou hodnotu.
TEXT NÁPOVĚDY	Nepovinné.Určuje text zobrazený v popisku pole.
SHODA	Nepovinné.Definuje vzor pro pole, která se musí shodovat s hodnotou pole.
NOTSAMEAS	Nepovinné.Určuje další pole, jejichž hodnota se nesmí shodovat s hodnota aktuálního pole.
PROHIBITEDVALUES	Nepovinné.Definuje seznam zakázaných hodnoty pole.
JEN PRO ČTENÍ	Nepovinné.Definuje pole jen pro čtení.
POŽADOVÁNO	Nepovinné.Definuje pole podle potřeby.
SERVERDEFAULT	Nepovinné.Určuje součást serveru, který bude poskytovat hodnotu pro pole.
SUGGESTEDVALUES	Nepovinné.Definuje seznam navržených hodnot pro pole.Navrhované hodnoty jsou hodnoty, které jsou k dispozici pro výběr v seznamu polí ve formulářích položky práce a v okně Tvůrce dotazu.Můžete zadat jiné hodnoty navíc k těm, které v seznamu.
VALIDUSER	Nepovinné.Určuje, že seznam povolených hodnot musí obsahovat pouze platné uživatele systému.
PŘI	Nepovinné.Určuje jedno nebo více pravidel lze aplikovat na aktuální pole, když má určitou hodnotu jiného pole.
WHENCHANGED	Nepovinné.Při změně hodnoty určitého pole, platí pro aktuální pole jedno nebo více pravidel.
WHENNOT	Nepovinné.Platí jedno nebo více pravidel pro aktuální pole při jiné pole nemá určitou hodnotu.
WHENNOTCHANGED	Nepovinné.Při určité pole hodnoty se nezmění, platí pro aktuální pole jedno nebo více pravidel.

Nadřazené elementy

Element	Description
POLE	Povinné.Obsahuje definice pracovní položka typ pole.

Poznámky

FIELD(Definice) je vyžadovaným podřízeným prvkem FIELDS (definice).

parametr minOccurs = "1"

Ne více než 1 024 pracovní položky pole můžete definovat ve stejné kolekci týmového projektu a můžete nastavit více než 1 024 pole hodné v všechny kolekce týmových projektů.Další informace naleznete v tématu Přidání a úpravy polí pracovních položek jako podpora tvorby sestav.

[!POZNÁMKA]

Je-li přidat existující pole na jiný typ pracovní položky, jsou použity aktuální hodnoty hodné atributy.

Další požadavky a omezení pro názvy polí ekologicky šetrné a odkaz naleznete v tématu Vytváření názvů pro objekty sledování pracovní položky.Informace o tom, jak popisek pole pro účely vykazování, viz Přidání a úpravy polí pracovních položek jako podpora tvorby sestav.

Nelze definovat vlastní pole, které začíná System. předpony.Pole lze definovat pomocí tlačítka Microsoft. předpony, tato praxe se však důrazně nedoporučuje, protože by mohly bránit Team Foundation Server funkce.

Přehled objektu pole pracovní položka sledování, viz Práce s poli pracovní položky.

Přehled systémů a předdefinovaných polí, které jsou definovány pro Microsoft Solutions Framework (MSF) pro šablonu procesu v5.0 agilní vývoj softwaru naleznete v tématu Referenční dokumentace polí pracovních položek pro Visual Studio ALM.

Názvy polí odkaz nelze přejmenovat.Seznam polí, popisný název pole přejmenovat a změnit atributy pole pomocí witadmin nástroj příkazového řádku.Další informace naleznete v tématu Správa polí pracovních položek [witadmin].

Informace o použití polí celé kolekce týmových projektů naleznete v tématu Řešení konfliktů schémat, které se vyskytují v datovém skladu a Přidání a úpravy polí pracovních položek jako podpora tvorby sestav.

Příklad

<FIELD name="Activity" refname="Microsoft.VSTS.Common.Activity" type="String" reportable="dimension">
   <HELPTEXT>Type of work involved</HELPTEXT>
   <SUGGESTEDVALUES>
      <LISTITEM value="Development"/>
      <LISTITEM value="Testing"/>
      <LISTITEM value="Requirements"/>
      <LISTITEM value="Design"/>
      <LISTITEM value="Deployment"/>
      <LISTITEM value="Documentation"/>
   </SUGGESTEDVALUES>
</FIELD>

Viz také

Referenční dokumentace

Správa polí pracovních položek [witadmin]

Koncepty

Vytváření názvů pro objekty sledování pracovní položky

Referenční dokumentace polí pracovních položek pro Visual Studio ALM

Přizpůsobení dat, formulářů, pracovních postupů a dalších objektů pro sledování projektů

Práce s poli pracovní položky

Další zdroje

Rejstřík definic elementů XML pro typy pracovních položek