Sdílet prostřednictvím

Prvek pole (definice)

  • Článek

Použití FIELD prvku definovat pole pracovní položky a určit pravidla a podmínky, které uplatňují provázaných (definice) Atributy, které přiřadíte na pole určit způsob zobrazení ve formuláři položky práce a zda je k dispozici pro zahrnutí do sestavy. Spravovat nastavení pole přiřazení týmu projektu kolekce. Proto musí odpovídat atributy, které přiřadíte polí definovaných v jeden typ položek práce přes všechny typy pracovních položek pro všechny projekty týmu v kolekci. Kromě toho jsou exportovány hodné všechna pole ze všech kolekcí databází datového skladu.

Poznámka

Informace o FIELD (pracovní) prvek, který slouží k určení pravidel a podmínek polí při stavu pracovního postupu nebo změnit přechod, viz Prvek pole (pracovní postup).

Můžete změnit existující pole kolekce provedené pomocí atributu přiřazení witadmin příkaz nástroje. Další informace naleznete v tématu Správa pracovní položka pole [witadmin].

Hierarchii schématu

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 prvky

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

v případě vícehodnotových atributů

Atribut

Popis

name

Povinné. Popisný název pole, které zobrazí rozevírací nabídky položku dotazy práce. Popisný název musí být jedinečný ve všech oblastech, které jsou definovány v rámci týmu projektu. Popisný název se také může lišit od popisek, který se zobrazí vedle pole ve formuláři položky práce. Další informace naleznete v tématu Odkaz Element XML řízení.

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

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

Vzorek Příklad hodnoty: Přiřazeno

refname

Povinné. Jedinečný popisek, který odlišuje pole ze všech polí definovaných v kolekci týmu projektu.

Další požadavky a omezení popisné názvy a odkazy naleznete v Konvence pro sledování objektů pracovní položky.

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

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

Vzorek Příklad hodnoty: Company.IssueType

type

Povinné. Určuje typ dat, která do pole zadat.

PoznámkaPozná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ší, data konflikty mohou nastat při zpracování datového skladu.Další informace naleznete v tématu Řešení konfliktů schématu, které se vyskytnou v datového skladu.

Následující tabulka uvádí platné hodnoty pro tento atribut:

HodnotaPoužití
DateTime Určuje datum koordinovaný světový čas (UTC) okamžiku v čase.
Double Určuje hodnotu s plovoucí desetinnou čárkou.
GUID Určuje pole obsahující jedinečný identifikátor.
History
Diskuse podporuje a sleduje jiné historické informace.
PoznámkaPoznámka
System.History Pole je pouze pole, která používá tento typ dat.Nelze definovat vlastní pole pomocí tohoto typu.
HTML Podporuje sběr dat RTF a pro delší textové popisy jako popis pracovní položky.
Integer Určuje hodnotu 32bitové číslo se znaménkem.
PlainText Položka textový řetězec, který může obsahovat maximálně 255 znaků Unicode podporuje.
String Položka textový řetězec, který může obsahovat až 255 znaků Unicode podporuje.Pomocí pole řetězec popisku nebo jiných krátký textový řetězec na jeden řádek.
TreePath
Určuje pole, které zobrazuje položky hierarchická nebo stromové struktury, například co je třeba zobrazit oblast a iterace cesty pro produkt.
PoznámkaPoznámka
System.AreaPath a System.IterationPath pole jsou pouze pole používající tento typ dat.Nelze definovat vlastní pole pomocí tohoto typu.

syncnamechanges

Nepovinné. Určuje, zda pole položky práce slouží k ukládání názvů, které chcete aktualizovat, jakmile změny ve službě Active Directory nebo pracovní skupiny. Tato možnost je platná pouze při type="String". Typ atributu je xs:boolean.

Určit true Chcete-li povolit synchronizaci dat pole zadat false zakázat synchronizaci dat pole.

reportable

Nepovinné. Určuje, zda je pole zahrnout do sestavy. Výchozí hodnota pole None jsou exportovány do skladu relačních dat ani pro zpracované SQL Server krychli služby Analysis Services. Další informace o polích hodné, viz Přidání a úpravy polí Support Reporting pracovní položky.

PoznámkaPoznámka
Projekt kolekce, které mají stejnou hodnotu pro pole v různých reportingrefname musí být přiřazena stejná hodnota pro reportable.Pokud se hodnoty liší, data konflikty mohou nastat při zpracování datového skladu.Další informace naleznete v tématu Řešení konfliktů schématu, které se vyskytnou v datového skladu.

Následující tabulka uvádí platné hodnoty pro tento atribut:

Value Použití
Detail Lze určit pro pole typu DateTime, dvojité, celé číslo nebo řetězec. Data v tomto poli přesunuta do skladu relační databáze aktuální pracovní položky a pracovní položky tabulky, ale ne do krychli služby Analysis Services.Tento typ je vhodný pro neomezený textových polí, protože je můžete použít v sestavách bez vytváření krychle výrazně větší.
Dimension Lze určit pro pole typu DateTime, dvojité, celé číslo nebo řetězec. Data v tomto poli zadá skladu relační databázi a datovou krychli služby Analysis Services jako atribut dimenze položky práce, aby data lze použít pro filtrování sestav.Tento typ použijte seznamy platné hodnoty polí.Položky typu práce a stát příklady dobré dimenze.
Measure Použijte pouze pro celé číslo a dvojité pole typ rozměru.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 jsou nastaveny atributy opatření.Například pracovní položky a pracovní položky aktuální skupiny měr obsahují souhrnná data pro následující pole: Původní odhad zbývající hodiny a hodiny dokončené.Při určení opatření, je nutné zadat formula atributu.
None Určit None Při použití pole zahrnout do sestavy.Toto je výchozí přiřazení.

formula

Nepovinné. Typ agregace measure hodné typu. Jediná platná hodnota je sum, která vrací součet všech hodnot přes sadu.

reportingname

Nepovinné. Určuje název, který se objeví v sestavách. Pokud nezadáte hodnotu přiřazenou hodnotu name atribut použit.

PoznámkaPoznámka
Pole v jiném projektu kolekcí, které mají stejné reportingrefname musí být přiřazena stejná hodnota reportingname.Pokud se hodnoty liší, data konflikty mohou nastat při zpracování datového skladu.Další informace naleznete v tématu Řešení konfliktů schématu, které se vyskytnou v datového skladu.

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

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

Vzorek Příklad hodnoty: Přiřazeno

reportingrefname

Nepovinné. Určuje použité při zpracování hodné pole název odkazu. Pokud nezadáte hodnotu přiřazenou hodnotu refname atribut použit.

Tento atribut můžete sloučit nebo odchýlit polí, které jsou zpracovány do datového skladu. Chcete-li sloučit dvě pole, jsou definovány v různých projekt kolekce, které mají rozdílné referenční názvy stejné přiřadíte reportingrefname obou. Chcete-li odchýlit dvě pole, jsou definovány v kolekcích jiný projekt, ale mají stejný název odkazu přiřadit jinou reportingrefname do každého pole.

Měla slučovací pole možno minimalizovat počet polí ve skladu a vést pod maximální limit 1024 hodné polí. Můžete generovat sestavy křížové skupiny s polí.

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

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

Vzorek Příklad hodnoty: Company.IssueType

Podřízené prvky

Prvek

Popis

ALLOWEDVALUES

Nepovinné. Definuje seznam povolených hodnot pole. Povolené hodnoty jsou hodnoty, které jsou k dispozici v seznamu polí ve formulářích položky práce a 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 pole, které již mají být použity, i když jsou neplatné. Všechny nové hodnoty pole musí být platné.

CANNOTLOSEVALUE

Nepovinné. Pole definuje jako hodnota nemůže ztratit. Tento prvek udržuje aktuální hodnotu pole a nemůže být zrušeno nebo provedené prázdné.

KOPÍROVAT

Nepovinné. Určuje další pole obsahující hodnotu zkopírovány do aktuální pole.

VÝCHOZÍ

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

PRÁZDNÝ

Nepovinné. Definuje jako prázdná pole.

ZMRAZENÉ

Nepovinné. Definuje pole jako zmrazené. Zmrazené pole nelze změnit na neprázdnou hodnotu po změny potvrzeny. Můžete však ručně vymazat pole, uložit položku a pak určete jinou hodnotu.

TEXT NÁPOVĚDY

Nepovinné. Určuje text zobrazený v popisku pole.

MATCH

Nepovinné. Definuje vzorec pro pole, které se musí shodovat s hodnotou pole.

NOTSAMEAS

Nepovinné. Určuje další pole hodnotu nesmí být shodné s hodnotou pole aktuální.

PROHIBITEDVALUES

Nepovinné. Definuje seznam zakázaných hodnoty pole.

JEN PRO ČTENÍ

Nepovinné. Definuje pole jen pro čtení.

POŽADOVÁNO

Nepovinné. Definuje požadované pole.

SERVERDEFAULT

Nepovinné. Určuje součást server poskytující hodnotu pro pole.

SUGGESTEDVALUES

Nepovinné. Definuje seznam navržených hodnot pole. Navrhované hodnoty jsou hodnoty, které jsou k dispozici v seznamu polí ve formulářích položky práce a Tvůrce dotazu. Dále můžete zadat hodnoty jiné dokumenty v seznamu.

VALIDUSER

Nepovinné. Určuje, že seznam povolených hodnot musí sestávat pouze z platného uživatele systému.

WHEN

Nepovinné. Určuje jedno nebo více pravidel použít aktuální pole při jiné pole má určitou hodnotu.

WHENCHANGED

Nepovinné. Při změně hodnoty určitého pole platí jedno nebo více pravidel pro aktuální pole.

WHENNOT

Nepovinné. Jedno nebo více pravidel platí pro aktuální pole při jiné pole nemá určitou hodnotu.

WHENNOTCHANGED

Nepovinné. Jedno nebo více pravidel platí pro aktuální pole při hodnotu určitého pole se nezmění.

Nadřazené prvky

Prvek

Popis

POLE

Povinné. Obsahuje definice pracovní položky typu pole.

Poznámky

FIELDJe vyžadován podřízeného prvku (definice) FIELDS (definice).

parametr minOccurs = "1"

Definujete pole více než 1 024 pracovní položky ve stejné kolekci týmu projektu a můžete nastavit pole více než 1 024 hodné ve všech kolekcí týmu projektu. Další informace naleznete v tématu Přidání a úpravy polí Support Reporting pracovní položky.

Poznámka

Při přidání existujícího pole jiného typu pracovní položky se používají aktuální hodnoty atributů hodné.

Další požadavky a omezení friendly pole názvů a referenčních naleznete Konvence pro sledování objektů pracovní položky. Informace o popisek pole pro účely vykazování v Přidání a úpravy polí Support Reporting pracovní položky.

Nelze definovat vlastní pole, která začíná System. předponu. Pole lze definovat pomocí Microsoft. prefix, tato praxe je však důrazně nedoporučuje, protože může bránit Team Foundation Server funkce.

Přehled objektu sledování zboží práce naleznete v tématu Práce s poli pracovní položky.

Přehled všech předdefinovaných polí, které jsou definovány pro Microsoft Solutions Framework (MSF) pro šablonu procesu v5.0 agilní vývoj softwaru a systému naleznete v tématu Použití systémových polí a polí definovaných šablon procesů MSF.

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 pracovní položka pole [witadmin].

Informace o použití polí přes týmu projektu kolekce Řešení konfliktů schématu, které se vyskytnou v datového skladu a Přidání a úpravy polí Support Reporting 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é

Odkaz

Správa pracovní položka pole [witadmin]

Koncepty

Konvence pro sledování objektů pracovní položky

Použití systémových polí a polí definovaných šablon procesů MSF

Přizpůsobení projektu sledování dat, formulářů, pracovního postupu a jiné objekty

Práce s poli pracovní položky

Další zdroje

Index prvku XML definice typů pracovních položek

Historie změn

Datum

Poslední dokumenty

Důvod

Leden 2011

Zjednodušená obsahu a odebrány odkazy na témata, které byly odebrány.

Rozšíření informace