Definování a úprava polí pracovní položky

Použijete pole pracovních položek sledování dat pro typ pracovní položky a definovat kritéria filtru pro dotazy také tak, aby generování sestav.Libovolný element dat, s výjimkou polí data jádro systému v Team Foundation Server (TFS), že chcete sledování, použijte k definování pracovního postupu nebo se zobrazí ve formuláři pro typ pracovní položky musí být definován jako pole pracovní položku.Můžete definovat pole pracovních položek v rámci definice typ pracovní položky nebo globální pracovního postupu.

Pole pracovních položek jsou zachovány pro kolekci týmového projektu.Při provádění jednu z následujících úkolů, přidejte pole:

• Vytvořte týmový projekt.Všechna pole, které jsou definovány v rámci definice pro typy pracovních položek nebo globální pracovního postupu a které jsou definovány pro vybraný proces šablony jsou vytvářeny.Základní systémová pole jsou automaticky definovány pro každý typ pracovní položky, který je definován pro týmový projekt.Seznam těchto polích naleznete v tématu Referenční dokumentace polí pracovních položek pro Visual Studio ALM.

• Import definice pro typ pracovní položky.Všechny nové pole, které jsou definovány v rámci definice pro typ pracovní položky jsou přidány do kolekce.Další informace naleznete v tématu Referenční dokumentace všech elementů XML WITD.

• Importovat definici globální pracovního postupu.Všechny nová pole, které jsou definovány v rámci globální pracovního postupu jsou přidány do kolekce.Můžete definovat globální pracovního postupu, když chcete udržovat sadu pole pracovních položek, které sdílejí několik typů pracovních položek.Další informace naleznete v tématu Přizpůsobení globálního pracovního postupu.

• Mapování kolekce projektu na instanci tohoto projektu webové aplikace (PWA).Po instalaci Team Foundation Server rozšíření pro Microsoft Project Server nakonfigurovat integraci mapováním různé součásti Team Foundation.Při připojování kolekce je importován definici globální pracovního postupu, která podporuje více polí v polích serveru Microsoft Office Project.Další informace naleznete v tématu Pole produktu Project Server přidaná do produktu TFS na podporu synchronizace dat.

Všechna pole, které jsou definovány v všechny typy pracovních položek a všechny globální pracovní postupy pro všechny týmové projekty tvoří kompletní sadu pole, které jsou definovány pro kolekci.Můžete změnit atribut, přejmenovat a odstranit existující pole.Při provedení změny tohoto typu se však vést určité poplatkům.Další informace naleznete v tématu Přizpůsobení objektů pro sledování práce na podporu týmových procesů.

Chcete-li přidat nebo upravit pole pro kolekci, upravte obsah XML pro definici typ pracovní položky nebo globální pracovního postupu.Pro každé pole prostřednictvím definovat FIELD element v rámci FIELDS části definice pro typ pracovní položky nebo globální pracovního postupu.Informace o struktuře a umístění těchto souborů naleznete v tématu Referenční dokumentace všech elementů XML WITD a Přizpůsobení globálního pracovního postupu.

V tomto tématu

• Struktura syntaxe pole (definice)

• Typy dat pole

• Událostí podléhajících atributy přiřazené k polím

• Indexované pole

• Podřízené prvky pole (definice)

• Systémová pole a předdefinované pole

Struktura syntaxe pole (definice)

Každý FIELD element (definice) má popisný název, který je volitelné, a název odkazu, který je vyžadován.Název odkazu musí být jedinečné v rámci kolekce.Další informace naleznete v tématu Vytváření názvů pro objekty sledování pracovní položky.

Důležité
Popisný název pro pole lze změnit pomocí witadmin changefield nástroj příkazového řádku.Nicméně pokud přejmenujete pole, ovlivňuje všechny typy pracovních položek ve všech projektech týmu v rámci kolekce.

Je třeba definujte pole pomocí následující syntaxe jazyka XML v souboru definice pro typ pracovní položky.

<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="sum" >
   <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>

Další informace naleznete v tématu Referenční dokumentace elementů FIELD (definice).

Zpět na začátek

Typy dat pole

Typ pole definuje druh a velikost dat, který můžete uložit do pole.Pole může mít pouze jeden typ definované v rámci kolekce týmových projektů.Toto omezení doporučuje organizacím používat společná pole ve všech projektech a pracovních položek typů.

V následujícím seznamu jsou uvedeny typy podporované pole:

Datový typ	Popis
DateTime	Určuje datum podle okamžiku koordinovaný světový čas (UTC) v čase. Add a DateTime field to a work item form by using either the FieldControl or DateTimeControltype attributes.
Double	Určuje hodnotu s plovoucí desetinnou čárkou.Dvojité pole se často používají v dotazu filtruje a zobrazí výsledky. Add a Double field to a work item form by using the FieldControltype attribute.
GUID	Určuje pole, které bude obsažen jedinečný identifikátor. Nelze přidat GUID pole do formuláře pracovních položek.
History	Zajišťuje podporu pro zobrazení posloupnosti diskusí a sledování dalších historických informací. [!POZNÁMKA] System.History Pole je pouze pole, které používá tento datový typ.Vlastní pole, které používá tento datový typ nelze definovat. Add the System.History field to a work item form by using the WorkItemLogControltype attribute which supports rich text format controls.
HTML	Podporuje schopnost shromažďovat data ve formátu RTF a použít popisy delší text jako popis pracovní položky.Pole HTML se liší od pole ve formátu prostého textu v tom, že je pro bohatší zobrazí informace o silného typu pole HTML do formátu HTML. Add an HTML field to a work item form by using the HTMLControltype attribute, which supports rich text format controls.
Integer	Určuje hodnotu 32bitová podepsaná hodnota typu integer.Celé číslo pole se často používají v dotazu filtruje a zobrazí výsledky. Add an Integer field to a work item form by using the FieldControltype attribute.
PlainText	Podporuje položka textový řetězec, který může obsahovat více než 255 znaků Unicode. Add a PlainText field to a work item form by using either the FieldControl type attribute and limited to plain text, or the HTMLControltype attribute which supports rich text format controls.
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.V se často používají polí s řetězcem dotazu filtruje a výsledků seznamy. Add a String field to a work item form by using the FieldControltype attribute.
TreePath	Určuje pole, které zobrazuje položky v hierarchickou nebo stromové struktury, například požadavky Chcete-li zobrazit oblasti a iterace cesty pro produkt. [!POZNÁ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. Přidat System.AreaPath a System.IterationPath polí, která mají svoji pracovní položky pomocí formuláře WorkItemClassificationControl type atributu.

Zpět na začátek

Událostí podléhajících atributy, které jsou přiřazeny k polím

Některé hodnoty polí jsou obzvláště užitečná pro generování sestav.S použitím jazyka pro definici typ pracovní položky, můžete zadat následující volitelné atributy:

• reportable.Nastavit atribut událostí podléhajících na None, Detail, Dimension, nebo Measure, v závislosti na tom, zda a jak se mají pole, které mají být zahrnuty do sestavy.Data z pole, které mají hodnotu jiné než None pro tento atribut jsou vyexportovány do datového skladu a mohou být zahrnuty do sestavy.

  Po přidání existujícího pole k pracovní položce zadejte, aktuální hodnota reportable je použit atribut.Když přidáte pole na typ pracovní položky, vytváření sestav je zakázán, pokud ji explicitně zadat s použitím reportable atributu.

• reportingname.Přiřadíte jiný popisek pole, které se používá v případě, že data se zobrazí v sestavách.Pokud nezadáte hodnotu popisný název, který je přiřazen name je použit atribut.

• reportingrefname.Přiřaďte odkaz na jiný název pole, které se používá při exportu dat do relační datového skladu.Pokud nezadáte hodnotu, hodnotu, která je přiřazena k refname je použit atribut.

  Tento atribut lze použijte ke sloučení nebo odchýlit pole, které jsou zahrnuty do sestavy.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 pro obě pole.O odchylce dvě pole, které mají stejný název odkazu a které jsou definovány v kolekcích jiného projektu, můžete přiřadit na jiný reportingrefname do všech polí.

Po definování pole, můžete použít witadmin changefield příkazu na příkazovém řádku ke změně hodnoty všech atributů s výjimkou refname atributu.

Informace o doporučených postupech v popisování 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.

Zpět na začátek

Hodnoty atributů událostí podléhajících

Následující tabulka popisuje, jak je můžete přiřadit jednu z následujících hodnot reportable atribut: none, dimenze, podrobností a měr.

[!POZNÁMKA]

Můžete si dělat pole událostí podléhajících poté, co byla použita pro pracovní položku.Po nastavení událostí podléhajících hodnotu, bude obsahovat nové revize pracovní položky, které jsou zkopírovány do skladu hodnotu pole.Revize, které jsou již ve skladu však nebude backfilled s existující hodnoty.

Hodnota atributu	Popis
Detail	Použití Detail typu pouze u polí Integer, Double, řetězec nebo data a času. Data v tomto poli je přesunuta do skladu relační databáze v tabulkách aktuální pracovní položky a pracovní položky, ale ne do SQL Server datové krychli služby Analysis Services.Pomocí tohoto typu pro neomezený textová pole, můžete je v sestavách bez provedení významně vyšší datové krychli.
Dimension	Použití Dimension typu pouze u polí Integer, String nebo data a času. 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	Použití Measure typu pouze pro celé číslo a dvojité pole.Míry jsou číselné hodnoty ve svých sestavách. Během zpracování datové krychli služby Analysis Services, data jsou předem vypočítány na pole, které jsou nastaveny na Measure.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.Další informace o skupinách měr naleznete v tématu Perspektivy a skupiny měr poskytované v rámci datové krychle služby Analysis Services pro Visual Studio. Pokud zadáte Measure, je třeba zadat sum pro formula atribut, který vrátí součet každou míru odkazuje v dotazu.
None	Zadejte None Pokud nechcete mají být zahrnuty do pole v sestavách.Tato hodnota je výchozí přiřazení.

Zpět na začátek

Příklady demonstrující jak určit, generování sestav

Příklad podrobnosti

<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">

Příklad dimenze

<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">

Příklad měr

<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">

Indexované pole

Můžete povolit nebo zakázat indexování pro pracovní položku pole s použitím witadmin indexfield příkazu.Když povolíte indexování pro pole, může zvýšit výkon hledání pracovních položek, jejichž dotazy určují tohoto pole.Pokud chcete přidat vlastní pole, které můžete použít v mnoha dotazy pracovní položky, můžete povolit indexování u tohoto pole.Další informace naleznete v tématu Správa polí pracovních položek [witadmin].

Zpět na začátek

Podřízené prvky pole (definice)

Existuje mnoho volitelné podřízených elementů, které můžete určit pro pole pracovních položek, například:

• Text nápovědy.Definuje nástroj tip nebo Nápověda informace, zobrazí pole na práci položku formuláře (HELPTEXT).

• Pole omezení.Určuje pole, podle potřeby jen pro čtení, prázdný, ukotvené nebo odpovídající konkrétnímu vzor (REQUIRED, READONLY, EMPTY, FROZEN, MATCH).

• Hodnota Automatické vyplňování pole.Určuje hodnotu pro pole (DEFAULT, COPY, SERVERDEFAULT).

• Pole zobrazí.Určuje povolená, navrhované nebo zakázané hodnoty.(ALLOWEDVALUES, SUGGESTEDVALUES, PROHIBITEDVALUES)

• Pole podmínky.Použije jeden nebo více pravidel pro pole, pokud jiné pole se nezmění ani nebyl změněn nebo jiné pole má nebo nemá konkrétní hodnotu nebo jiných podmínek (WHEN, WHENNOT, WHENCHANGED, WHENNOTCHANGED, CANNOTLOSEVALUE, NOTSAMEAS).

Další informace naleznete v tématu Referenční dokumentace všech elementů XML FIELD.

Zpět na začátek

Systém a předdefinovaných polí

Všechna pole definovaná systémem mít odkaz na názvy, které začínají řetězcem systém, například System.AreaPath, System.AssignedTo a pokračovat v této vzor.

Předdefinované pole definovaná výchozí šablony procesu, které poskytuje TFS začínat Microsoft.VSTS a potom dále se liší v závislosti na jejich použití.Příklady předdefinovaných polí, které se používají v běžných pro plánování účely a integraci s Microsoft Project, pro integraci s Team Foundation Builda integraci s Team Foundation jsou následující:

• Microsoft.VSTS.Common.Priority

• Microsoft.VSTS.Scheduling.DueDate

• Microsoft.VSTS.Build.FoundIn

• Microsoft.VSTS.TCM.Steps

Přehled všech systému a předdefinované pole, které jsou definovány pro výchozí šablony procesu, které poskytuje sady TFS, naleznete v části Referenční dokumentace polí pracovních položek pro Visual Studio ALM.Další informace o zadání názvů polí, naleznete v části Vytváření názvů pro objekty sledování pracovní položky.

Zpět na začátek

Atributy Skrytý a neměnitelné a Průzkumník pole pracovní položky

Kromě atributy, které můžete změnit pro pole pracovních položek existuje několik atributů neměnitelné a prakticky skrytý pro každé pole.Přiřazení těchto polí můžete vyhledat pomocí nástroje Průzkumník polí pracovní položky.Přístup k nástroji Průzkumník polí pracovní položky z nástroje power proces editoru.

Průzkumník polí pracovní položky

[!POZNÁMKA]

Nástroj power procesu Editor poskytuje grafické uživatelské rozhraní pro přizpůsobení šablony procesů Team Foundation Server.Tento nástroj slouží k importu a exportu pracovních položek typů, změnit obsah šablonu procesu a zkoumat sadu polí definovaných pro kolekci týmového projektu.Další informace získáte na následující stránce webu společnosti Microsoft: Team Foundation Server výkonné nástroje.

Viz také

Referenční dokumentace

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

Koncepty

Běžné oblasti pro přizpůsobení [přesměrováno]

Přidání a změna polí pracovních položek jako podpora tvorby sestav

Referenční dokumentace všech elementů XML FIELD

Další zdroje

Úprava nebo přidání pole na podporu dotazů, sestav a pracovních postupů