Sdílet prostřednictvím

FIELD (Definition) element reference

  • Článek

Můžete použít FIELD (definice) elementu, který chcete definovat pole pracovní položku a zadejte pravidly a podmínkami, které se vztahují k němu. Atributy, které můžete přiřadit k poli určuje datový typ a zda je k dispozici pro zařazení do sestavy.

Poznámka

Informace o FIELD element (pracovního postupu), který použijete k určení pravidly a podmínkami k polím během přechod stavu změnit nebo pracovního postupu, naleznete v části FIELD (pracovní postup) – element (referenční dokumentace).

Schéma hierarchie

WITD

   WORKITEMTYPE

      POLE

            FIELD

<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 nadřazené prvky.

Atributy

Atribut

Popis

name

Požadováno. Popisný název pole, které se zobrazí v rozevírací nabídky dotazů pracovní položku. Popisný název musí být jedinečné v rámci všechna pole, které jsou definovány v rámci týmový projekt. Popisný název se také mohou lišit od popisek, který se zobrazí vedle pole ve formuláři pracovní položky. Další informace naleznete v tématu Control – referenční dokumentace elementu XML.

Typ atributu je typelib:FieldName. Minimální délka: 1; Maximální délka: 128.

Hodnota vzorku: ^ [^ \. \[\]]+$

Příklad hodnoty vzor: přiřazená k

refname

Požadováno. Jedinečný popisek, která odlišuje pole ze všech ostatních polí, které jsou definovány v kolekce týmových projektů.

Další požadavky a omezení týkající se popisné názvy a názvy referenční informace naleznete v tématu Vytváření názvů pro objekty sledování pracovní položky.

Typ atributu je typelib:ReferenceFieldName. Minimální délka: 1; Maximální délka: 70.

Hodnota vzorku: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [ -zA-Z0-9_] +) + $

Příklad hodnoty vzor: Company.IssueType

type

Požadováno. Určuje typ dat, které lze do pole zadat.

PoznámkaPoznámka
Pole v různých projektů kolekcí, které mají stejný reportingrefname musí být přiřazen stejnou hodnotu pro type.Hodnoty lišit, dat může dojít ke konfliktům při zpracování datového skladu.Další informace naleznete v tématu Resolve schema conflicts that are occurring in the data warehouse.

V následující tabulce jsou uvedeny platné hodnoty pro tento atribut:

HodnotaVyužití
DateTime Určuje datum podle okamžiku koordinovaný světový čas (UTC) v čase.
Double Určuje hodnotu s plovoucí desetinnou čárkou.
GUID Určuje pole, které bude obsažen jedinečný identifikátor.
History
Podporuje posloupnosti diskusí a si udržuje přehled o dalších historických informací.
PoznámkaPoznámka
System.History Pole je pouze pole, které používá tento datový typ.Vlastní pole, které používá tento datový typ nelze definovat.
HTML Zajišťuje podporu pro sběr dat ve formátu RTF a se používá pro delší popisy text jako popis pracovní položky.
Integer Určuje hodnotu 32bitová podepsaná hodnota typu integer.
PlainText Podporuje položka textový řetězec, který může obsahovat více než 255 znaků Unicode.
String Podporuje položka textový řetězec, který může obsahovat maximálně 255 znaků Unicode.Pomocí pole řetězce pro popisek nebo jiné krátký textový řetězec až dlouhý jeden řádek.
TreePath
Určuje pole, které zobrazuje položky v hierarchickou nebo stromové struktury, například co je třeba k zobrazení oblasti a iterace cest pro produkt.Chcete-li definovat podřízené uzly, naleznete v části Add and modify area and iteration paths.
PoznámkaPoznámka
System.AreaPath a System.IterationPath pole jsou pouze pole, které používají tento datový typ.Vlastní pole, které používá tento datový typ nelze definovat.

syncnamechanges

Volitelné. Určuje, zda pole pracovní položky slouží k uložení názvy, které chcete aktualizovat, jakmile změny ve službě Active Directory nebo k pracovní skupině. Tato možnost je platný pouze při type="String". Typ atributu je xs:boolean.

Zadejte true Chcete-li povolit synchronizaci pro pole dat, zadejte false Zakázání synchronizace pro datové pole.

reportable

Volitelné. Určuje, zda data z pole je k dispozici pro zařazení do sestavy. Pole s výchozí hodnotu None jsou vyexportovány do relační datového skladu ani zpracovaných SQL Server datové krychli služby Analysis Services. Další informace o událostí podléhajících polích naleznete v tématu Přidání a změna polí pracovních položek jako podpora tvorby sestav.

PoznámkaPoznámka
Pole v různých projektů kolekce, které mají stejnou hodnotu pro reportingrefname musí být přiřazen stejnou hodnotu pro reportable.Hodnoty lišit, dat může dojít ke konfliktům při zpracování datového skladu.Další informace naleznete v tématu Resolve schema conflicts that are occurring in the data warehouse.

V následující tabulce jsou uvedeny platné hodnoty pro tento atribut:

Value Využití
Detail Lze zadat pro pole typu datum a čas, Double, Integer nebo řetězec. Data v tomto poli je přesunuta do databáze relační skladu v tabulkách pracovní položky a aktuální pracovní položky, ale ne do datové krychli služby Analysis Services.Tento typ je vhodný pro neomezený textová pole, protože je můžete používat v sestavách bez provedení významně vyšší datové krychli.
Dimension Lze zadat pro pole typu datum a čas, celé číslo, řetězec nebo TreePath. Data v tomto poli vstupuje do skladu relační databáze a datové krychli služby Analysis Services jako atribut dimenze pracovní položky tak, aby data lze použít k filtrování sestav.Pomocí tohoto typu pro pole, které jsou k dispozici seznam platných hodnot.Typ pracovní položky a stavu jsou dobrým příkladem dimenze.
Measure Typ měr používejte pouze pro celé číslo a dvojité polí.Míry jsou číselné hodnoty ve svých sestavách.Při zpracování datové krychli služby Analysis Services dat je předem vypočítány na pole jehož reportable k měření jsou nastaveny atributy.Můžete například pracovní položkou a aktuální pracovní položky skupiny měr obsahují kumulativní data pro následující pole: původní odhad, zbývající hodiny a dokončit hodin.Při zadávání měr, je třeba zadat formula atributu.
None Zadejte None Pokud nechcete používat pole pro zařazení do sestavy.Toto je výchozí přiřazení.

formula

Volitelné. Typ agregace pro measure událostí podléhajících typu. Je platný pouze hodnota sum, která vrací součet hodnot v sadě.

reportingname

Volitelné. Určuje název, který se zobrazí v sestavách. Pokud nezadáte hodnotu, hodnotu, která je přiřazena k name je použit atribut.

PoznámkaPoznámka
Pole v různých projektů kolekcí, které mají stejný reportingrefname musí být přiřazen stejnou hodnotu pro reportingname.Hodnoty lišit, dat může dojít ke konfliktům při zpracování datového skladu.Další informace naleznete v tématu Resolve schema conflicts that are occurring in the data warehouse.

Typ atributu je typelib:FieldName. Minimální délka: 1; Maximální délka: 128.

Hodnota vzorku: ^ [^ \. \[\]]+$

Příklad hodnoty vzor: přiřazená k

reportingrefname

Volitelné. 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 k refname je použit atribut.

Tento atribut slouží ke sloučení nebo odchýlit pole, které jsou zpracovávány do datového skladu. Chcete-li sloučit dvě pole, které jsou definovány v kolekcích jiného projektu, které mají odlišné odkaz na názvy, je stejná přiřadit reportingrefname do obou z nich. O odchylce dvě pole, které mají stejný název odkazu, ale které jsou definovány v kolekcích jiného projektu, můžete přiřadit jinou reportingrefname pro každé pole.

Měli byste sloučit pole, pokud je to možné, chcete-li minimalizovat počet polí ve skladu a sledovat maximálního limitu 1024 událostí podléhajících polí. Můžete generovat sestavy různé skupiny se sloučené pole.

Typ atributu je typelib:ReferenceFieldName. Minimální délka: 1; Maximální délka: 70.

Hodnota vzorku: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [ -zA-Z0-9_] +) + $

Příklad hodnoty vzor: Company.IssueType

Podřízené elementy

Element

Popis

ALLOWEDVALUES

Volitelné. 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 pracovní položky a Tvůrce dotazů. Je třeba vybrat jednu z těchto hodnot.

ALLOWEXISTINGVALUE

Volitelné. Definuje pole, které chcete povolit existující hodnoty. Tento element umožňuje hodnoty pole, které již existují mají být použity, i v případě, že nejsou platné. Všechny nové hodnoty polí musí být platný.

CANNOTLOSEVALUE

Volitelné. Definuje pole jako nemůže dojít ke ztrátě hodnotu. Tento element zachová aktuální hodnota pole a nemůže být zrušeno nebo být prázdný.

KOPÍROVÁNÍ

Volitelné. Určuje jiné pole, které obsahuje hodnotu, která mají být zkopírována do aktuálního pole.

VÝCHOZÍ HODNOTA

Volitelné. Definuje výchozí hodnotu pro pole.

PRÁZDNÝ

Volitelné. Definuje pole jako prázdný.

ZMRAZENÉ

Volitelné. Definuje pole jako zmrazené. Ukotvené pole nelze změnit na libovolnou hodnotu neprázdný, jakmile změny potvrzeny. Můžete však ručně vymažte pole, uložit s pracovní položkou a poté zadejte jinou hodnotu.

TEXT NÁPOVĚDY

Volitelné. Definuje text zobrazený v popisu tlačítka pro pole.

SHODA

Volitelné. Definuje základní vzor pro pole, která se musí shodovat s hodnotou pole.

NOTSAMEAS

Volitelné. Určuje jiné pole, jehož hodnota nesmí být shodné s hodnotou aktuálního pole.

PROHIBITEDVALUES

Volitelné. Definuje seznam zakázaných hodnot pro pole.

JEN PRO ČTENÍ

Volitelné. Definuje pole jen pro čtení.

POŽADOVÁNO

Volitelné. Definuje pole podle potřeby.

SERVERDEFAULT

Volitelné. Určuje součást serveru, který bude poskytovat hodnotu pro pole.

SUGGESTEDVALUES

Volitelné. Definuje seznam hodnot navržené pro pole. Navrhované hodnoty jsou hodnoty, které jsou k dispozici pro výběr v seznamu polí ve formulářích pracovní položky a Tvůrce dotazů. Navíc můžete zadat jiné hodnoty na ty v seznamu.

VALIDUSER

Volitelné. Určuje, že seznam povolených hodnot musí obsahovat pouze platné uživatele systému.

KDYŽ

Volitelné. Určuje jedno nebo více pravidel, která má být použita pro aktuální pole, má-li jiné pole konkrétní hodnotu.

WHENCHANGED

Volitelné. Použije jeden nebo více pravidel na aktuální pole při změně hodnoty určitého pole.

WHENNOT

Volitelné. Použije jeden nebo více pravidel pro aktuální pole, pokud jiné pole nemá konkrétní hodnotu.

WHENNOTCHANGED

Volitelné. Použije jeden nebo více pravidel pro aktuální pole, pokud hodnota konkrétní pole se nezmění.

Nadřazené elementy

Element

Popis

POLE

Požadováno. Obsahuje definice pole Typ pracovní položky.

Poznámky

  1. FIELD (Definice) je povinný podřízený element elementu FIELDS (definice).

  2. Přehled všech systému a předdefinované pole, které jsou definovány pro šablony procesů sady TFS, naleznete v části Work item field reference for Visual Studio ALM.

  3. Nelze definovat vlastní pole, které začíná System. předpony. Pole můžete definovat pomocí Microsoft. předpony, tento postup je však doporučeno, protože by mohly bránit Team Foundation Server funkce.

    Další požadavky a omezení týkající se pole pro tisk názvy a referenční informace naleznete v tématu Vytváření názvů pro objekty sledování pracovní položky.

  4. Když přejmenujete popisný název do pole, nelze přejmenovat názvy odkaz pole. Můžete seznamu polí a změnit několik atributů pole pomocí witadmin příkazového řádku toolSee Manage work item fields [witadmin].

  5. Můžete definovat pole více než 1 024 pracovních položek ve stejné kolekce týmových projektů a maximálně 1 024 pole můžete nastavit na událostí podléhajících ve všech kolekce týmových projektů.

    Všechna pole definované v rámci všech položek typů práce (WITs) pro všechny týmové projekty definované pro kolekci projektu jsou pro kolekci týmového projektu. Atributy, které přiřadíte do pole, které jsou definovány v jedné ŽÁ proto musí odpovídat v rámci všech WITs pro všechny týmové projekty v kolekci. Kromě toho jsou všechna pole událostí podléhajících ze všech kolekcí vyexportovány do databáze datových skladů.

  6. Informace o tom, jak popisek pole pro účely generování sestav naleznete v tématu Přidání a změna polí pracovních položek jako podpora tvorby sestav.

  7. Když přidáte různé ŽÁ stávající pole, buď výslovně nastaveny generování sestav atributy, které se mají být stejný jako aktuální definici pole, nebo nechat je výchozí pro tyto hodnoty.

    Konflikty schémat může dojít, pokud jsou přiřazeny různé atributy generování sestav na stejné pole v různých WITs nebo stejné WITs v různých týmové projekty. Chcete-li tyto konflikty vyřešit, naleznete v části Resolve schema conflicts that are occurring in the data warehouse.

  8. Abyste pochopili, jak se pole slouží k podpoře dotazů, sestav a sledování pracovních položek, naleznete v části Modify or add a field to support queries, reports, and workflow.

  9. Přehled jak se má použít na omezení nebo podmínky FIELD pomocí podřízené prvky naleznete v tématu Použití pravidla pro pole pracovní položky.

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

Manage work item fields [witadmin]

Koncepty

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

Work item field reference for Visual Studio ALM

Přizpůsobení objektů pro sledování práce na podporu týmových procesů

Define and modify work item fields

Další zdroje

Work item tracking: Index to XML element definitions