Define and modify work item fields

Článek
09/11/2015

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řit 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 Work item field reference for 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 All WITD XML elements reference.
Importovat globální pracovního postupu definice. 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 Customize global workflow.
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 All WITD XML elements reference a Customize global workflow.

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 FIELD (Definition) element reference.

Typy dat

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. Přidat DateTime pole do formuláře pracovních položek s použitím buď FieldControl nebo DateTimeControl type atributy.
Double	Určuje hodnotu s plovoucí desetinnou čárkou. Dvojité pole se často používají v dotazu filtruje a zobrazí výsledky. Přidat Double pole do formuláře pracovních položek s použitím FieldControl type atributu.
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. Přidat System.History pole do formuláře pracovních položek s použitím WorkItemLogControl type atribut, který podporuje ovládací prvky formátu RTF.
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. Přidat HTML pole do formuláře pracovních položek s použitím HTMLControl type atribut, který podporuje ovládací prvky formátu RTF.
Integer	Určuje hodnotu 32bitová podepsaná hodnota typu integer. Celé číslo pole se často používají v dotazu filtruje a zobrazí výsledky. Přidat Integer pole do formuláře pracovních položek s použitím FieldControl type atributu.
PlainText	Podporuje položka textový řetězec, který může obsahovat více než 255 znaků Unicode. Přidat PlainText pole do formuláře pracovních položek s použitím buď FieldControl atribut type a omezeno na prostý text nebo HTMLControl type atribut, který podporuje ovládací prvky formátu RTF.
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. Přidat String pole do formuláře pracovních položek s použitím FieldControl type atributu.
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.

Událostí podléhajících atributy

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 pro každé pole.

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.

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 Perspectives and measure groups provided in the Analysis Services cube for 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í.

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

Příklad podrobnosti

Příklad dimenze

Příklad měr

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 Manage work item fields [witadmin].

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).
Pole Automatické vyplňování hodnotu. Určuje hodnotu pro pole (DEFAULT, COPY, SERVERDEFAULT).
Pole seznamy. 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 All FIELD XML elements reference.

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 Build, a 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 Work item field reference for 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.

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

Work item field explorer

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é

Sdílet prostřednictvím