Sdílet prostřednictvím

Práce s poli pracovní položky

  • Článek

Pomocí polí položky práce sledovat data pro položky typu práce a definovat kritéria filtru pro dotazy i ke generování sestav. Datový prvek, s výjimkou pro jádro systému datová pole, které chcete sledovat, použijte k definování pracovního postupu nebo tiskopis pro položky typu práce musí být definována jako položky pole práce. Můžete definovat pole položky pracovní definici položky typu práce nebo globální pracovního postupu.

Kolekce týmu projektu jsou zachovány položky pole práce. Přidejte pole při provádění následujících úloh:

  • Vytvoření týmu projektu. Všechna pole jsou smyslu definic pro typy položek práce nebo globální pracovního postupu a který definované pro vybraný proces šablony jsou vytvořeny. Další informace naleznete v tématech Pracovní položka pole (agilní) a Pracovní položka pole (CMMI). Základní systémová pole automaticky definováno pro každý typ položky práce definovaný pro tým projektu. Seznam těchto polí naleznete v tématu Použití systémových polí a polí definovaných šablon procesů MSF.

  • Importovat definici pracovní položky typu. Všech nových polí definovaných v definici typu pracovní položky jsou přidány do kolekce. Další informace naleznete v tématu Všechny referenční elementy WITD XML.

  • Import definice pracovního postupu globální. Všech nových polí definovaných v rámci globálního pracovního postupu jsou přidány do kolekce. Pokud chcete zachovat sada polí položky práce sdílející několika typů položek práce definujete globální pracovního postupu. Další informace naleznete v tématu Přizpůsobení pracovního postupu globální.

  • Kolekce projektu mapování na instanci tohoto projektu webové aplikace (PWA). Po instalaci Visual Studio Team Foundation Server 2010 a integrace serveru Project feature pack konfigurovat mapování různé součásti Integrace Team Foundation. Při mapování kolekce importu definice globální pracovního postupu, který podporuje několik polí v polích serveru Project Server. Další informace naleznete v tématu Project Server Fields Added to Support Data Synchronization.

Všechna pole, která jsou definována v všech typů práce položky a všechny globální pracovní postupy pro všechny projekty týmu tvoří úplnou sadu polí definovaných pro kolekci. Změnit atribut, přejmenovat a odstranit existující pole. Však určité náklady účtovány při provádění změn těchto druhů. Další informace naleznete v tématu Přizpůsobení projektu sledování dat, formulářů, pracovního postupu a jiné objekty.

Chcete-li přidat nebo upravit pole pro kolekci, upravte obsah XML definice typu globální pracovního postupu nebo položky práce. Definovat jednotlivá pole až FIELD prvku FIELDS části definice typu pracovní položky nebo globální pracovního postupu. Informace o struktuře a umístění těchto souborů v Všechny referenční elementy WITD XML a Přizpůsobení pracovního postupu globální.

V tomto tématu

  • Struktura syntaxe pole (definice)

  • Datové typy

  • Hodné atributy přiřazené pole

  • 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á název odkazu, který je vyžadován a popisný název, který je volitelný,. Název odkazu musí být jedinečný v rámci kolekce. Další informace naleznete v tématu Konvence pro sledování objektů pracovní položky.

Důležité

Popisný název pro pole lze změnit pomocí witadmin changefield nástroj příkazového řádku. Však pole přejmenujete, ovlivní všechny typy položek práce ve všech projektech týmu v rámci kolekce.

Definovat pole pomocí následující syntaxe 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="avg" >
   <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

Datové typy

Typ pole definuje typ a velikost dat, které lze uložit v poli. Pole může mít pouze jeden typ na Team Foundation Server. Toto omezení se doporučuje organizace společných polí mezi projekty a práce typy položek.

Následující seznam obsahuje typy podporovaných pole:

Typ dat

Popis

DateTime

Určuje datum koordinovaný světový čas (UTC) okamžiku v čase.

Můžete přidat DateTime pole formuláře pomocí položky práce FieldControl nebo DateTimeControl type atributy.

Double

Určuje hodnotu s plovoucí desetinnou čárkou. Dvojitá polí jsou často používány filtry a seznam výsledků dotazu.

Můžete přidat Double pole formuláře pomocí položky práce FieldControl type atributu.

GUID

Určuje pole obsahující jedinečný identifikátor.

Nelze přidat GUID pole formuláře položky práce.

History

Podporuje zobrazení posloupnosti diskusí a dalších historických informací o sledování.

PoznámkaPoznámka
System.History Pole je pouze pole, která používá tento typ dat.Nelze definovat vlastní pole pomocí tohoto typu.

Můžete přidat System.History pole formuláře pomocí položky práce WorkItemLogControl type atribut, který podporuje ovládací prvky formát RTF.

HTML

Podporuje schopnost zachycení dat RTF a používat delší textové popisy jako popis pracovní položky. Pole HTML se liší od pole ve formátu prostého textu v tomto poli HTML silný do HTML pro bohatší zobrazí informace.

Můžete přidat HTML pole formuláře pomocí položky práce HTMLControl type atribut, který podporuje ovládací prvky formát RTF.

Integer

Určuje hodnotu 32bitové číslo se znaménkem. Celočíselných polí jsou často používány filtry a seznam výsledků dotazu.

Můžete přidat Integer pole formuláře pomocí položky práce FieldControl type atributu.

PlainText

Položka textový řetězec, který může obsahovat maximálně 255 znaků Unicode podporuje.

Můžete přidat PlainText pole formuláře pomocí položky práce FieldControl atribut typu a omezené na prostý text nebo HTMLControl type atribut, který podporuje ovládací prvky formát RTF.

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. Řetězec polí jsou často používány filtry a seznam výsledků dotazu.

Můžete přidat String pole formuláře pomocí položky práce FieldControl type atributu.

TreePath

Určuje pole, které zobrazuje položky hierarchická nebo stromové struktury, jako jsou požadavky 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.

Můžete přidat System.AreaPath a System.IterationPath pole práce položky pomocí formuláře WorkItemClassificationControl type atributu.

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 vykazování. 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 Measure, podle toho, zda a jak má pole mají být zahrnuty do sestavy. Data z polí, které mají hodnotu než None tohoto atributu jsou exportovány do datového skladu a lze zahrnout do sestavy.

    Po přidání existujícího pole pracovní položku zadejte, aktuální hodnotu reportable atribut použit. Přidáte-li pole položku typu práce, vykazování je zakázán, pokud explicitně zadat pomocí reportable atributu.

  • reportingname. Pole používá při zobrazení dat v sestavách můžete přiřadit jmenovku. Pokud zadáte hodnotu, popisný název, který je přiřazen name atribut použit.

  • reportingrefname. Pole používá při exportu dat do skladu relačních dat můžete přiřadit různé referenční název. Pokud nezadáte hodnotu přiřazenou hodnotu refname atribut použit.

    Tento atribut můžete sloučit nebo odchýlit polí, které jsou zahrnuty do sestavy. 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 do obou polí. Chcete-li odchýlit dvě pole, jsou definovány v různých projekt kolekce, které mají stejný název odkazu přiřadit jinou reportingrefname do každého pole.

Po definování pole můžete použít witadmin changefield příkazu na příkazovém řádku změňte hodnotu všechny atributy s výjimkou refname atributu.

Informace o doporučených postupech pro pojmenování polí pro účely vykazování v Přidání a úpravy polí Support Reporting pracovní položky.

Zpět na začátek

Hodnoty atributů hodné

Následující tabulka popisuje, jak je můžete přiřadit jednu z následujících hodnot reportable atribut: žádný, dimension, podrobnosti a měření.

Poznámka

Můžete vytvořit pole hodné po byl použit pro pracovní položku. Po nastavení hodnoty hodné nové revize pracovní položky, které budou zkopírovány do skladu bude obsahovat hodnotu pole. Revize, které jsou ve skladu již nebude backfilled s existující hodnoty.

Hodnota atributu

Popis

Detail

Použití Detail typu pouze pro celé číslo, dvojité, řetězec nebo DateTime polí.

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 krychli služby Analysis Services. Pomocí tohoto typu neomezený textových polí, můžete jim v sestavách bez vytváření krychle výrazně větší.

Dimension

Použití Dimension typu pouze pro celé číslo, dvojité, řetězec nebo DateTime polí.

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žití Measure typu pouze pro celé číslo a dvojité polí. 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 nastavená na Measure. 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é. Další informace o skupinách měr naleznete v Měření stanovené v krychli služby Analysis Team System metriky a skupin.

Při zadávání Measure, musíte zadat sum pro formula odkazuje atribut, který vrátí součet jednotlivých opatření v dotazu.

None

Určit None Při zahrnout pole v sestavách. Tato hodnota je výchozí přiřazení.

Zpět na začátek

Příklady způsobu určení vykazování

Příklad podrobnosti

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

Napří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í položky pole práce witadmin indexfield příkaz. Při povolení indexování pole může zvýšit výkon pracovních položek, jejichž dotazy určete pole hledání. Přidat vlastní pole používané v mnoha dotazů pracovní položky, můžete povolit indexování pole. Další informace naleznete v tématu Správa pracovní položka pole [witadmin].

Zpět na začátek

Podřízené prvky pole (definice)

Existuje několik volitelných podřízené prvky, které položky pole práce, můžete zadat například:

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

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

  • Pole hodnota auto populace. Určuje hodnotu pole (DEFAULT, COPY, SERVERDEFAULT).

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

  • Pole podmínky. Při změně nebo nezmění jiného pole nebo jiného pole má nebo nemá určitou hodnotu nebo jiné podmínky platí jedno nebo více pravidel pro pole (WHEN, WHENNOT, WHENCHANGED, WHENNOTCHANGED, CANNOTLOSEVALUE, NOTSAMEAS).

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

Zpět na začátek

Systém a předdefinovaných polí

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

Jejich použití na základě předdefinovaných polí definovaných pomocí Microsoft Solutions Framework (MSF) šablon procesů se dále liší a začínají Microsoft.VSTS. Příklady předdefinovaných polí používaných v běžných plánování účely a integraci s Microsoft Office 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 předdefinovaných polí definovaných pro MSF š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. Další informace o zadávání názvů polí naleznete v Konvence pro sledování objektů pracovní položky.

Zpět na začátek

Viz také

Úkoly

Pole, které chcete přidat nebo odebrat pole z položky typu práce

Odkaz

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

Prvek pole (definice)

Koncepty

Všechny referenční elementy WITD XML

Všechny referenční elementy XML pole

Další zdroje

Řešení konfliktů schématu, které se vyskytnou v datového skladu

Přidání a úpravy polí Support Reporting pracovní položky

Definování položky pole práce

Historie změn

Datum

Poslední dokumenty

Důvod

Leden 2011

Přidány informace o globální pracovního postupu a několika oddílů aktualizován odkazy na Příbuzná témata. Odebrané části o definici schématu.

Rozšíření informace