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

Článek
08/11/2011

Pomocí polí položky práce sledovat data pro položky typu práce, definovat kritéria filtru pro dotazy a použití v sestavách. Všechna pole kromě systémová pole, které chcete zobrazit v sestavě musí být definována v souboru definice typů pracovních položek, které budou sledovat pole. Systém automaticky polí pro každý typ položky práce. Musí však být obsažena ve formuláři práce pro vstup dat.

Podporovat vytváření sestav, můžete přidat pole nebo změna atributů existujících polí. Přidat nebo upravit pole platit systematické konvence, ujistěte se, že data logicky seskupena do složek v SQL Server krychli služby Analysis Services.

V tomto tématu

Doporučené postupy
Použít existující pole
Seznam polí, která jsou definována pro kolekci týmu projektu
Hodné atributy pole
Změnit atribut hodné pole.
Přidání polí do Support Reporting
Zkontrolujte změny atributů hodné pole
Doporučené postupy při přiřazování vykazování referenční názvy
Hodné pole, která jsou definovány v šablonách proces MSF

Doporučené postupy

Přidat nebo upravit pole, přečtěte si následující doporučené postupy:

Zjistěte, zda můžete použít pole již definované v kolekci týmu projektu obsahující týmu projektu. Použití existujícího pole podporuje vykazování mezi projekty.
Zjistěte, zda můžete použít pole již definované v kolekci jiného projektu nasazení Visual Studio Team Foundation Server. Použití existujícího pole podporuje meziprojektové vykazování.
Můžete mít více než 1 024 pole v kolekci každého projektu a více než 1 024 hodné jedinečné pole v celém nasazení všech kolekcí projektu Team Foundation Server. Sloučit pole počet jako hodné jedno pole.
Zavést standardní postup a zkontrolujte proces přidání a úprava šablon procesů, týmové projekty nebo projekt kolekce polí.
Popisek pole pro vykazování použijte systematické konvence. Když přiřadit názvy referenční systematicky přes všechny kolekce týmu projektu nasazení v Team Foundation Server, zaručit konzistentní a použitelné skladu a krychle schématu a vyhnout se konfliktu schématu ve skladu. Další informace naleznete v tématu Řešení konfliktů schématu, které se vyskytnou v datového skladu.

Můžete přiřadit až čtyři atributů popisku pole pracovní položky:

Poznámka

Pole, které jsou definovány v procesu šablon Microsoft Solutions Framework nejsou přiřazeny přídavné jméno nebo název odkazu vykazování. Standardně se používají název odkazu a název atributy.
- name. 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 týmu projektu. Popisný název může být odlišné od zobrazeného popisek, který je přiřazen do pole na formuláři práce. Další informace naleznete v tématu Odkaz Element XML řízení.
- refname. Jedinečný popisek, který je přiřazen do pole, které odlišuje od všech polí definovaných v kolekci týmu projektu. Hodnota přiřazená refname nelze změnit.
  
  Požadavky a omezení popisné názvy a názvy polí reference naleznete Konvence pro sledování objektů pracovní položky.
- reportingname. Nepovinný atribut. Název používaný k identifikaci pole v sestavách. Když není explicitně nastavena, hodnota přiřazená name atribut použit.
- reportingrefname. Nepovinný atribut. Jedinečný popisek přiřazený hodné pole, které odlišuje od všech ostatních hodné polí definované ve všech kolekcí týmu projektu. Když není explicitně nastavena, hodnota přiřazená refname atribut použit. Doporučené konvence, viz Doporučené postupy při vykazování názvy odkaz přiřazením dále v tomto tématu.
  
  Poznámka
  
  Vykazování referenční názvy jsou viditelné pouze z kontingenční tabulky nebo datové krychli služby Analysis Services.

Použít existující pole

Pokud toto pole odpovídá informace, které chcete sledovat a hlásit v již definované pole byste měli použít. Chcete-li použít existující pole, proveďte následující kroky:

Označte pole, které chcete použít. Použití witadmin listfields příkaz k identifikaci polí a jejich atributů, které jsou definovány pro všechny kolekce projektu. Další informace naleznete v Seznam že polí pro kolekci týmu projektu dále v tomto tématu.
Určete, zda je pole hodné a zda hodné atributy potřebám vykazování.
Pokud není hodné, použít witadmin changefield Změnit projekt kolekcí, ve kterých je použit atribut hodné. Další informace naleznete v Změna hodné atribut pole dále v tomto tématu.
Kde není definováno pole kolekce projektu přidáte do souborů XML definice pro práce typy položek, které chcete použít ke sledování dat. Další informace naleznete v Přidat pole Support Reporting dále v tomto tématu.

Seznam polí, která jsou definována pro kolekci týmu projektu

Můžete použít witadmin listfields příkaz seznam polí a jejich atributy. Zadané pole nebo všechna pole definované v kolekci projektu můžete vytvořit seznam. witadmin listfields Má následující syntaxi příkazu:

witadmin listfields /collection:CollectionURL /n:RefName

Další informace naleznete v tématu Seznam polí položky práce a zobrazit atributy pole přiřazeno.

Hodné atributy pole

Hodné polí reportable hodnota atributu Detail, Dimension, nebo Measure. Následující atributy určují, jak exportovat a zpracování databáze datového skladu položky pole práce:

reportingtype. Chcete-li do sestavy zahrnout pole, musíte přiřadit jednu z následujících hodnot reportable atribut:
- Přiřadit Detail exportovat pole Sklad relační databáze ale krychle. Jak ukazuje následující příklad použití Detail typu pouze pro pole celé číslo, dvojité, řetězec nebo datum a čas:
```
<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">
```
- Přiřadit Dimension exportovat pole Sklad relační databáze a datové krychle. Jak ukazuje následující příklad použití Dimension pouze pro celé číslo, dvojité, řetězec nebo DateTime polí. Tuto hodnotu je vhodné zahrnout pole, které slouží k filtrování sestav (například pole, jejichž seznam platných hodnot).
```
<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">
```
- Přiřadit Measure k podpoře zpracování vypočítaných hodnotách v krychli. Použití Measure typu pouze pro celé číslo a dvojité polí.
  
  Jestliže přiřadíte opatření jako reportingtype, je nutné přiřadit sum jako formula, jak ukazuje následující příklad:
```
<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">
```
reportingrefname. Můžete přiřadit různé referenční název pole, které je označeno jako hodné. Pokud není zadána žádná hodnota přiřazená hodnota 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 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í.
reportingname. Pole, která slouží k zobrazení dat v sestavách můžete přiřadit jmenovku. Pokud není zadána žádná hodnota, popisný název, který je přiřazen name atribut použit. Hodnota přiřazená reportingname se zobrazí v krychli. Hodnota přiřazená reportingrefname nezobrazí.

Důležité

Použijte doporučené postupy pro vykazování polí tak, aby seskupené v kontingenčních tabulkách popisek. Další informace naleznete v Doporučené postupy při vykazování názvy odkaz přiřazením.

Změnit atribut hodné pole pracovní položky

Hodné existující pole můžete provést změnou přiřazení atribut pole definovaná kolekce projektu. Existující pole je definováno v jedné nebo více definice typu pracovní položky. Můžete také změnit všechny atributy, které určují způsob zpracování pole v datových skladů.

Změnit přiřazení atribut pole můžete použít následující pořadí kroků:

Můžete použít witadmin changefield příkaz změnit atribut přiřazení do pole. Vykonává příkaz kolekce týmu projektu. Použijte následující syntaxi:
```
witadmin changefield /collection:CollectionURL /n:RefName [/name:NewName] [/syncnamechanges:true | false] [/reportingname:ReportingName] [/reportingrefname:ReportingRefName] [/reportingtype:Type] [/reportingformula:Formula] [/noprompt]
```
Chcete-li existující pole hodné, změňte reportingtype. Chcete-li například provést AW.Pole Common.TeamPriority je k dispozici filtrování zpráv, přiřadit k ní hodnoty dimenze:
```
witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.Common.TeamPriority /reportingtype:dimension 
```
Další informace naleznete v tématu Správa pracovní položka pole [witadmin].
(Volitelné) Pokud máte více než jeden projekt, můžete změny pracovního pole položky definovaná kolekce podobné. Chcete-li předejít konfliktům schématu při exportu a zpracování dat dat skladu databází, musíte přiřadit stejné hodnoty těchto atributů přes všechny kolekce:
- Typ pole (hodnota tohoto pole nelze změnit existující pole).
- Hlášení typu.
- Přídavné jméno.
Další informace naleznete v tématu Řešení konfliktů schématu, které se vyskytnou v datového skladu.
Po provedení změn všechny položky pole práce, které chcete použít pro vykazování musí zpracovat databáze datového skladu. Můžete použít ProcessWarehouse a ProcessAnalysis webových služeb, které jsou k dispozici WarehouseControlWebService.

Tento krok zajistí lidé, kteří pomocí sestav změníte atributy pole nezobrazí chybu. Další informace naleznete v tématu Process the Data Warehouse and Analysis Services Cube.

Další informace naleznete v tématu Správa pracovní položka pole [witadmin].

Přidání polí do Support Reporting

Pole můžete přidat definici pracovní položky typ nebo typy. Po přidání pole by stejné definice prvku pole přidejte všechny typy pracovních položek, pro které bude podporovat hlášení. Pokud chcete pole podporuje vykazování mezi více projekty, by mělo být pole do ve všech projektech týmu, které budou hlášeny na všechny typy položek práce.

Další informace naleznete v následujících tématech:

Zkontrolujte změny atributů hodné pole

Můžete ověřovat změny provedené hodné pole atributů zpracování datových skladů na vyžádání a kontrolou sestavy pak ověřte, že jsou aktualizovány. Nebo můžete počkat, dokud spuštění úlohy adaptér skladu. Standardně je zpracována v relační databázi každých několik minut. Krychle je však zpracovány každé dvě hodiny ve výchozím nastavení.

Poznámka

Pro více informací o WarehouseControlWebService si prohlédněte Process the Data Warehouse and Analysis Services Cube.

Procesu pomocí relační datový sklad na vyžádání ProcessWarehouse WarehouseControlWebService.
Pomocí zpracovat krychli na vyžádání ProcessAnalysisDatabase WarehouseControlWebService.
Ověřte aktualizované zprávy. Zobrazte zprávu prostřednictvím řídicího panelu nebo správce sestav. Další informace naleznete v tématech Dashboards a Reports.

Doporučené postupy při přiřazování vykazování referenční názvy

Pro vykazování názvy odkaz chcete přiřadit popisky, takže můžete snadno najít polí v sestavě kontingenční tabulky a krychle. Lze toho dosáhnout použitím systematické vytváření názvů tak, že jsou v logické posloupnosti seskupené pole. Kromě toho pole jsou záznamy seskupeny, vhodným způsobem, můžete změnit vykazování referenční název pole.

Použití pojmenování systematické stane stále důležitější, protože hodné všechna data ze všech projektů týmu definované ve všech kolekcí projektu zapsána do jediného relační datový sklad. Data z tohoto skladu je pak zpracovány a zapsány do krychle. Protože položky pole práce jsou spravovány odděleně pro každou kolekci projektu, mohou být použity různé popisky a může vést k sadu polí nejsou uspořádána také podporovat vytváření sestav.

Pracovní položka pole hodné typem dimenze odpovídají atributů dimenzí v krychli. Atributy dimenze jsou uspořádány do složek, které jsou založeny na vykazování referenční název přiřazený šablonu procesu nebo pracovní definici typu položky. Následující typy mapování dojít:

Polí, které mají "Systém" Předpona jsou vnitřní a přímo pod dimenze položky práce s "Pracovní položky" před.
Ostatní pole jsou vloženy podle složky, jejichž názvy odpovídají předpony v jejich názvech odkaz. Například pole s "Microsoft.VSTS.Common" Předpona jsou uvedeny ve složce je označené "Microsoft VSTS společného."

Jak ukazuje následující obrázek pro každou skupinu polí, které sdílejí běžný prefix prefix je přidána složka:

struktura složek v datové krychli OLAP

Následující tabulka obsahuje pole, jejichž názvy referenční začínají "System" a uvedené v sestavě kontingenční tabulky s předponou "Pracovní položka." Tato pole jsou vloženy přímo pod položku dimenze. Všechna pole jsou vloženy podle složky, jejichž názvy odpovídají předpony v jejich názvech odkaz.

Poznámka

Nasazení, které používají verzi Enterprise SQL Server Analysis Services nemají přístup k funkcím překlad, které jsou k dispozici tuto verzi. V těchto nasazeních pole označena podle jejich názvu úplný odkaz v datové krychli, s '. "nahrazuje"_"(například" System_Id" a "system_title").

Název kontingenční tabulky a krychle	Název odkazu	Typ dat
Pracovní cesta Item.Area	System.AreaPath	TreeType
Práce na Item.Assigned	System.AssignedTo	řetězec
Práce V Item.Changed	System.ChangedBy	řetězec
Pracovní datum Item.Changed	System.ChangedDate	Datum a čas
Práce V Item.Created	Podle System.Created	řetězec
Pracovní datum Item.Created	System.CreatedDate	Datum a čas
Item.ID práce	System.ID	Integer
Pracovní cesta Item.Iteration	System.IterationPath	TreeType
Stav Item.Previous práce	System.PreviousState	řetězec
Item.Reason práce	System.Reason	řetězec
Item.Rev práce	System.rev	Integer
Item.State práce	System.state	řetězec
Item.Title práce	System.title	řetězec
Typ položky Item.Work práce	System.WorkItemType	řetězec

Následující tabulka uvádí pole zobrazené v kontingenční tabulce ve složce s názvem "Microsoft.VSTS.Common" pod položku dimenze. Pole obsahují odkaz začínající "Microsoft.VSTS.Common".

Název kontingenční tabulky a krychle	Název odkazu	Typ dat
Práce V Item.Activated	Microsoft.VSTS.Common.ActivatedBy	řetězec
Pracovní datum Item.Activated	Microsoft.VSTS.Common.ActivatedDate	Datum a čas
Práce V Item.Closed	Microsoft.VSTS.Common.ClosedBy	řetězec
Pracovní datum Item.Closed	Microsoft.VSTS.Common.ClosedDate	Datum a čas
Práce V Item.Created	Microsoft.VSTS.Common.CreatedBy	řetězec
Pracovní datum Item.Created	Microsoft.VSTS.Common.CreatedDate	Datum a čas
Práce V Item.Resolved	Microsoft.VSTS.Common.ResolvedBy	řetězec
Pracovní datum Item.Resolved	Microsoft.VSTS.Common.ResolvedDate	Datum a čas
Z důvodu Item.Resolved práce	Microsoft.VSTS.Common.ResolvedReason	řetězec
Item.Priority práce	Microsoft.VSTS.Common.priority	Integer
Item.Severity práce	Microsoft.VSTS.Common.Severity	řetězec
Pořadí Item.Stack práce	Microsoft.VSTS.Common.StackRank	Double

Hodné pole, která jsou definovány v šablonách proces MSF

Následující tabulky obsahují pole definované v procesu šablon Microsoft Solutions Framework (MSF) a přiřazení výchozí pole. Tato pole jsou zobrazeny pouze pro týmové projekty vytvořené pomocí šablony proces MSF verze 5.0. Budou uvedena pouze pole nastavené za podléhající hlášení.

Pole podrobností
Pole dimenzí
Rozměr pole

Úplný seznam polí definovaných šablon procesů MSF, viz Použití systémových polí a polí definovaných šablon procesů MSF. Pokud jste inovovali tým projektu, budete muset provádět další úkoly, než začnete pracovat s některými z těchto polí. Další informace naleznete v tématu Aktualizace projektu inovované týmu přístup nových funkcí.

Pole podrobností

Název pole

Popis

Název odkazu

Typ dat

Stav automatizace

Stav případu test. Můžete zadat následující hodnoty:

Není automatické.
Plánované

Microsoft.VSTS.TCM.AutomationStatus

řetězec

Pole dimenzí

Název pole	Popis	Název odkazu	Typ dat
ID	Jedinečný identifikátor přiřazený pracovní položku. Ve všech projektech týmu jsou jedinečné ID položek práce a pracovní položky definované v kolekci týmu projektu.	System.ID	Integer
Title	Krátký souhrn položku práce je a pomáhá uživatelům odlišit od jiných pracovních položek v seznamu.	System.title	řetězec
Tým projektu	Týmu projektu, ke kterému patří této pracovní položky.	System.TeamProject	řetězec
Položky typu práce	Název položky typu práce.	System.WorkItemType	řetězec
Oblast	Skupiny pracovních položek do oblastí týmu nebo funkce produktu. Oblast musí být platný uzel v hierarchii projektu.	System.AreaPath	TreePath
Iterace	Skupiny pracovních položek pojmenovaných sprints nebo časových období. Iterace musí být platný uzel v hierarchii projektu.	System.IterationPath	TreePath
Změnit	Jméno člena týmu, která naposledy změnila pracovní položku.	System.ChangedBy	řetězec
Činnost	Typ aktivity potřebné k provedení úkolu.	Microsoft.VSTS.Common.Activity	řetězec
Rev	Číslo přiřazené k historické revize pracovní položku.	System.rev	Integer
Termín splnění	Prognózy z důvodu datum, které bude úkol dokončen.	Microsoft.VSTS.Scheduling.DueDate	Datum a čas
Datum dokončení	Datum a čas, kdy plán označuje dokončení úkolu.	Microsoft.VSTS.Scheduling.FinishDate	Datum a čas
Datum spuštění	Datum a čas, kdy plán označuje úkol začne.	Microsoft.VSTS.Scheduling.StartDate	Datum a čas
V	Produkt číslo sestavení, známé také jako revize, ve kterém byla nalezena chyba.	Microsoft.VSTS.Build.FoundIn	řetězec
Integrace sestavení	Číslo sestavení produktu, který zahrnuje kód nebo opravuje chyby	Microsoft.VSTS.Build.IntegrationBuild	řetězec
Přiřazeno	Jméno člena týmu, který nyní vlastní pracovní položku.	System.AssignedTo	řetězec
Důvod	Důvod, proč pracovní položka je v aktuálním stavu. Hodnoty jsou specifické pro stav a typ pracovní položky. Pole nejsou sledovány pro testování nebo sdílené kroky.	System.Reason	řetězec
Stát	Aktuální stav pracovní položky. Platné hodnoty pro stát jsou specifické pro každý typ pracovní položku.	System.state	řetězec
Aktivován	Jméno člena týmu, kteří aktivaci nebo aktivaci pracovní položku.	Microsoft.VSTS.Common.ActivatedBy	řetězec
Aktivovaný datum	Datum a čas, kdy byla pracovní položka deaktivoval nebo aktivován.	Microsoft.VSTS.Common.ActivatedDate	Datum a čas
Uzavřeno	Jméno člena týmu, který uzavřel pracovní položku.	Microsoft.VSTS.Common.ClosedBy	řetězec
Datum uzavření	Datum a čas, kdy byla uzavřena pracovní položku.	Microsoft.VSTS.Common.ClosedDate	Datum a čas
Vytvořil	Jméno člena týmu, který vytvořil pracovní položku.	Microsoft.VSTS.Common.CreatedBy	řetězec
Datum vytvoření	Datum a čas vytvoření položky práce.	Microsoft.VSTS.Common.CreatedDate	Datum a čas
Vyřešeny	Jméno člena týmu, který text chyby nebo uživatele.	Microsoft.VSTS.Common.ResolvedBy	řetězec
Datum vyřešení	Datum a čas, kdy byl vyřešen textu chyby nebo uživatele.	Microsoft.VSTS.Common.ResolvedDate	Datum a čas
Vyřešení příčiny	Důvod, který byl vyřešen chyb (například jej byla pevná).	Microsoft.VSTS.Common.ResolvedReason	řetězec
Priorita	Subjektivní hodnocení chyby, problém, úkol nebo testovacího případu tak, jak se týká podnikání. Můžete zadat následující hodnoty: 1: Nemůžete produkt dodat bez rozlišení úspěšný pracovní položky a by měla být adresována co nejdříve. 2: Nemůžete produkt dodat bez rozlišení úspěšný pracovní položky, ale nemá okamžitě řešit. 3: Rozlišení pracovní položka je volitelný, na základě zdroje, čas a rizika.	Microsoft.VSTS.Common.priority	Integer
Pořadí	Subjektivní hodnocení uživatele story, úkol, problém nebo Chyba ve srovnání s jinými pracovních položek stejného typu. Přiřazená nižší číslo položky musí být stanovena před položku, která je přiřazena vyšší číslo.	Microsoft.VSTS.Common.RANK	Double
Článek bodů	Subjektivní měrnou shromažďuje velikost textu uživatelem. Story uživatele přiřadíte více bodů, označíte, že je vyžadován k provedení více práce.	Microsoft.VSTS.StoryPoints	Double
Rizika	Subjektivní hodnocení relativní neurčitost o úspěšné dokončení článek uživatele. Můžete zadat následující hodnoty: 1 - Vysoká 2 - Střední 3 - Nízká	Microsoft.VSTS.Common.risk	řetězec
Závažnost	Subjektivní hodnocení účinku chyby na projektu. Můžete zadat následující hodnoty: 1 – Kritický 2 - Vysoká 3 - Střední 4 - Nízká	Microsoft.VSTS.Common.Severity	řetězec
Termín splnění	Datum prognózy podle kterého bude dokončena problém. Toto pole platí pouze pro vydávání pracovních položek.	Microsoft.VSTS.Scheduling.DueDate	Datum a čas

Rozměr pole

Název pole	Popis	Název odkazu	Typ dat
Původní odhad	Počet hodin, které jsou nutné k dokončení úkolu.	Microsoft.VSTS.Scheduling.OriginalEstimate	Double
Zbývající	Počet hodin, které zůstanou na dokončení úkolu.	Microsoft.VSTS.Scheduling.RemainingWork	Double
Dokončeno	Počet hodin, které byly strávené v práci na úkolu.	Microsoft.VSTS.Scheduling.CompletedWork	Double

Viz také

Sdílet prostřednictvím