Práce s poli pracovní položky

Sledovat data pro položky typu práce a definovat kritéria filtru pro dotazy i pokud jde o generování sestav, použijte pole položku práce.Libovolný prvek dat, s výjimkou jádra systému datových polí v Team Foundation Server (TFS), chcete-li sledovat, slouží k definování pracovního postupu nebo zobrazit ve formuláři pro typ položky práce musí být definován jako pole položku práce.Můžete definovat položky pole práce v rámci definice položky typu práce nebo globální pracovního postupu.

Pole pracovní položky jsou udržovány pro kolekci týmového projektu.Při provádění následujících úkolů přidáte pole:

• Vytvoření týmového projektu.Všechna pole, které jsou definovány v rámci definice typů položek práce 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 položky práce, který je definován pro týmového projektu.Seznam těchto polí naleznete v tématu Referenční dokumentace polí pracovních položek pro Visual Studio ALM.

• Importovat definici pro typ pracovní položka.Všech nových polí, které jsou definovány v rámci definice typu pracovní položky jsou přidány do kolekce.Další informace naleznete v tématu Všechny referenční elementy jazyk XML WITD.

• Import definice pracovního postupu globální.Všech nových polí, které jsou definovány v rámci globálních pracovních postupů jsou přidány do kolekce.Můžete definovat globální pracovního postupu, pokud chcete zachovat nastavení polí položky práce, které mají několik typů pracovních položek.Další informace naleznete v tématu Přizpůsobení globálního pracovního postupu.

• Kolekce projektu přiřadit instanci aplikace Project Web App (aplikace PWA).Po instalaci Team Foundation Server rozšíření pro projektový Server, konfigurovat integraci mapováním různé součásti Team Foundation.Při mapování kolekce definice globální pracovního postupu, který podporuje několik polí v serveru Microsoft Office Project pole importována.Další informace naleznete v tématu Pole aplikace Project Server přidána podpora synchronizace dat.

Všechna pole, které jsou definovány ve všech typů práce položky a všechny globální pracovní postupy pro všechny týmové projekty tvoří úplnou sadu polí, které jsou definovány pro kolekci.Můžete změnit atribut, přejmenovat a odstranit existující pole.Nicméně vynakládá určitých provedete-li tyto druhy změn.Další informace naleznete v tématu Přizpůsobení dat, formulářů, pracovních postupů a dalších objektů pro sledování projektů.

Chcete-li přidat nebo upravit pole pro kolekci, upravte obsah XML pro definici typu pracovní položka nebo globální pracovního postupu.Definování jednotlivých polí pomocí FIELD element v rámci FIELDS část definici pro typ pracovní položka nebo globální pracovního postupu.Informace o struktuře a umístění těchto souborů naleznete v tématu Všechny referenční elementy jazyk XML WITD a Přizpůsobení globálního pracovního postupu.

V tomto tématu

• Struktura syntaxe pole (definice)

• Typy datových polí

• Hodné atributy, které jsou přiřazeny k polím

• Indexovaná pole

• Podřízené prvky pole (definice)

• Systémová pole a předdefinovaných polí

Struktura syntaxe pole (definice)

Každý FIELD (definice) prvek 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 položek práce ve všech projektech týmu v rámci kolekce.

Definujte pole pomocí následující syntaxe jazyka XML v souboru definice typu 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 Prvek pole (definice).

Zpět na začátek

Typy datových polí

Typ pole definuje typ a velikost dat, která lze ukládat do pole.Pole může mít pouze jeden typ definované v rámci kolekce týmového projektu.Toto omezení vyzývá organizace pomocí společného pole napříč projekty a práce typy položek.

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

Typ dat	Description
DateTime	Určuje datum podle koordinovaný světový čas (UTC) okamžiku v čase. Přidat DateTime pole formuláře pracovních položek pomocí buď FieldControl nebo DateTimeControltype atributy.
Double	Určuje hodnotu s plovoucí desetinnou čárkou.Dvojité polí jsou často používány v dotazu, filtry a výsledky seznamy. Přidat Double pole formuláře pracovních položek pomocí FieldControltype atribut.
GUID	Určuje pole, která bude obsahovat jedinečný identifikátor. Nelze přidat GUID pole formuláře pracovních položek.
History	Podporuje zobrazení posloupnosti diskusí a dalších historických informací o sledování. Poznámka System.History Je pouze pole, která používá tento typ dat pole.Nelze definovat vlastní pole, pomocí tohoto datového typu. Přidat System.History pole formuláře pracovních položek pomocí WorkItemLogControltype atribut, který podporuje ovládací prvky pole s formátovaným textem formát.
HTML	Podporuje schopnost zachycení dat RTF a použít delší textové popisy, jako je například popis položky práce.Pole s HTML se liší od pole ve formátu prostého textu, v tom, že pole typu HTML silného do formátu HTML pro lepší zobrazení informací. Přidat HTML pole formuláře pracovních položek pomocí HTMLControltype atribut, který podporuje ovládací prvky pole s formátovaným textem formát.
Integer	Určuje hodnotu 32bitové celé číslo se znaménkem.Pole celé číslo se často používají v dotazu, filtry a výsledky seznamy. Přidat Integer pole formuláře pracovních položek pomocí FieldControltype atribut.
PlainText	Podporuje vstup textový řetězec, který může obsahovat maximálně 255 znaků Unicode. Přidat PlainText pole formuláře pracovních položek pomocí buď FieldControl atribut type a omezené na prostý text nebo HTMLControltype atribut, který podporuje ovládací prvky pole s formátovaným textem formát.
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.Pole řetězců, které jsou často používány v dotazu, filtry a výsledky seznamy. Přidat String pole formuláře pracovních položek pomocí FieldControltype atribut.
TreePath	Určuje pole, které zobrazuje položky v hierarchická nebo stromové struktury, jako jsou požadavky Chcete-li zobrazit oblasti a iterace cesty pro produkt. 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. Přidat System.AreaPath a System.IterationPath pole, která díla položky pomocí formuláře WorkItemClassificationControl type atribut.

Zpět na začátek

Hodné atributy, které jsou přiřazeny k polím

Některé hodnoty pole jsou obzvláště užitečné pro vytváření sestav.Pomocí jazyka pro definici typu položky práce můžete zadat následující volitelné atributy:

• reportable.Nastavte atribut hodné na None, Detail, Dimension, nebo Measurev závislosti na tom, zda a jak chcete, aby pole, které mají být zahrnuty do sestavy.Data z polí, které mají hodnotu jinou než None pro tento atribut se exportují do datového skladu a mohou být zahrnuty do sestavy.

  Když přidáte existující pole pracovní položka typ, aktuální hodnotu reportable atribut je použit.Při přidání pole do typu položky práce zasílání zpráv není zakázáno, pokud explicitně neurčíte ji pomocí reportable atribut.

• 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 atribut je použit.

• reportingrefname.Přiřadíte různé referenční název pole, které se používá při exportu dat pro relační datový sklad.Pokud nezadáte hodnotu, hodnotu, která je přiřazena refname atribut je použit.

  Tento atribut lze použijte ke sloučení nebo odchýlit polí, které jsou zahrnuty do sestavy.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 do obou polí.Odchýlit dvě pole, které jsou definovány v kolekce různých projektů, které mají stejný název odkazu přiřadit jinou reportingrefname k jednotlivým polím.

Po nadefinování datové pole, můžete použít witadmin changefield příkaz na příkazovém řádku změňte hodnotu všech atributů, s výjimkou refname atribut.

Informace o doporučených postupech v popisování pole pro účely vykazování, viz Přidání a úpravy polí pracovních položek jako podpora tvorby sestav.

Zpět na začátek

Hodné hodnoty atributů

Jak jsou popsány v následující tabulce, můžete přiřadit jednu z následujících hodnot reportable atribut: žádná, dimenze, podrobnosti a měření.

[!POZNÁMKA]

Poté, co byl použit pro pracovní položky, aby pole hodné.Po nastavení hodnoty hodné nové revize pracovní položky, které budou zkopírovány do skladu bude obsahovat hodnotu pole.Revizí, které jsou již ve skladu však nebude zpětným zaplňováním pomocí existujících hodnot.

Hodnota atributu	Description
Detail	Použití Detail typu pouze pro pole Integer, Double, řetězec nebo datum a čas. Data v tomto poli je přesunuta do skladu relační databáze v pracovní položky a aktuální pracovní položky tabulky, ale ne do SQL Server krychli služby Analysis Services.Pomocí tohoto typu pro neomezené textové pole je lze využít v sestavách bez vytváření datové krychle podstatně větší.
Dimension	Použití Dimension typu pouze pro pole Integer, Double, řetězec nebo datum a čas. 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	Použití Measure typu pouze pro pole celé číslo a Double.Opatření jsou číselné hodnoty v sestavách. Při zpracování datové krychle Analysis Services data jsou předem vypočítaných polí, které jsou nastaveny na Measure.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.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 edici Team System. Pokud zadáte Measure, je nutné zadat sum pro formula atribut, který vrátí součet každé opatření odkazovaný v dotazu.
None	Zadejte None Pokud nechcete zahrnout pole do sestavy.Tato hodnota je výchozí přiřazení.

Zpět na začátek

Příklady znázorňující, jak určit vykazování

Podrobný příklad

<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 opatření

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

Indexovaná pole

Můžete povolit nebo zakázat indexování pomocí pole položku práce witadmin indexfield příkaz.Povolíte-li indexování pole, může zvýšit výkon vyhledávání pracovních položek, jejichž dotazy určete pole.Je-li přidat vlastní pole, které můžete použít v mnoha dotazů pracovní položky, můžete povolit indexování pro dané 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 několik volitelný podřízený prvky, které můžete určit pro pole položku práce, například:

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

• Pole omezení.Určuje pole, jak je požadováno pouze pro čtení, prázdný, zmrazené nebo odpovídající určitý vzorek (REQUIRED, READONLY, EMPTY, FROZEN, MATCH).

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

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

• Pole podmínky.Pro pole platí jedno nebo více pravidel, pokud jiné pole je změněn nebo nebylo změněno nebo jiného pole má nebo nemá konkrétní hodnotu nebo jiné podmínky (WHEN, WHENNOT, WHENCHANGED, WHENNOTCHANGED, CANNOTLOSEVALUE, NOTSAMEAS).

Další informace naleznete v tématu Všechny referenční elementy jazyk XML pole.

Zpět na začátek

Systém a předdefinovaných polí

Všechna pole definovaná systémem mají referenční názvy, které začínají systému, například System.AreaPath, System.AssignedTo a pokračovat v tomto vzorku.

Předdefinované pole definované výchozí šablony procesů, které poskytuje TFS začínají Microsoft.VSTS a se pak dále 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 systémů a předdefinovaných polí, které jsou definovány pro výchozí šablony procesů, které poskytuje TFS, viz Referenční dokumentace polí pracovních položek pro Visual Studio ALM.Další informace o definování názvů polí, viz 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 polí pracovní položky

Kromě atributů, které lze změnit pro položky pole práce jsou k dispozici počet neměnitelné a prakticky skryté atributy pro každé pole.Můžete vyhledat přiřazení těchto polí pomocí nástroje Průzkumník polí položku práce.Přístup k nástroji Průzkumník polí položky práce z nástroj power tool pro proces editoru.

Pracovní položka Průzkumník polí

[!POZNÁMKA]

Nástroj power tool pro proces Editor poskytuje grafické uživatelské rozhraní pro přizpůsobení šablony procesů Team Foundation Server.Pomocí tohoto nástroje můžete importovat a exportovat položky typy práce, upravte obsah šablonu procesu a prozkoumat sadu polí, které jsou definovány pro kolekci týmového projektu.Další informace získáte na následující stránce na webu společnosti Microsoft: Team Foundation Server nářadí.

Viz také

Referenční dokumentace

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

Koncepty

Přizpůsobení sledování pracovních položek a týmového projektu

Přidání a úpravy polí pracovních položek jako podpora tvorby sestav

Všechny referenční elementy jazyk XML pole

Další zdroje

Definice polí pracovních položek