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

Článek
09/11/2015

Použijete pole pracovní položky ke sledování dat pro typ pracovní položky a definování kritérií filtru pro dotazy a také pro použití v sestavách. Jakékoli pole, mimo systémová pole, které chcete zobrazit v sestavě, musí být definováno v souboru definic pro typy pracovních položek, které bude pole sledovat. Systémová pole jsou automaticky definována pro každý typ pracovní položky. Musí být však obsaženy ve formuláři pracovní položky a podpořit tak zadávání dat.

Pro podporu vytváření sestav můžete přidat pole nebo změnit atributy existujících polí. Při přidání nebo změně polí byste měli použít systematické konvence pojmenování a ujistit se, že data jsou logicky rozdělena do složek v datové krychli služby SQL Server Analysis Services.

V tomto tématu

Doporučené postupy
Použít existující pole
Seznam polí definovaných pro kolekci týmového projektu
Reportovatené atributy pole
Změna využitelného atributu pro pole
Přidání polí pro podporu sestav
Ověřit změny provedené u atributů vykazovatelných polí
Doporučené postupy při přiřazování vykazování názvů odkazů

Seznam systémových polí definovaných v rámci výchozích šablon procesů naleznete v tématu Reportable fields reference for Visual Studio ALM.

Doporučené postupy

Než přidáte nebo změníte pole, zkontrolujte následující doporučené postupy:

Zjistěte, zda můžete použít pole, které je již definováno v kolekci týmového projektu, která obsahuje váš týmový projekt. Použití existujícího pole podporuje vykazování mezi projekty.
Zjistěte, zda můžete použít pole, které je již definováno v jiné kolekci projektu v nasazení Visual Studio Team Foundation Server. Použití existujícího pole podporuje vykazování mezi projekty.
V jedné kolekci projektu nemůžete mít více než 1024 polí a více než 1024 jedinečných vykazovatelných polích ve všech kolekcích produktu v nasazení Team Foundation Server. Sloučená pole se počítají jako jediné reportovatelné pole.
Zaveďte standardní postup a zkontrolujte postup pro přidání a úpravu polí v šablonách procesů, týmových projektech nebo kolekci projektů.
Použijte systematické konvence pojmenování při označování polí pro vykazování. Když přiřadíte referenční názvy systematicky přes všechny kolekce týmových projektů v nasazení Team Foundation Server, zaručíte tím konzistentnější a použitelnější schéma skladu a krychle a předejdete konfliktům schématu ve skladu. Další informace naleznete v tématu Resolve schema conflicts that are occurring in the data warehouse.

Můžete přiřadit až čtyři atributy popisků poli pracovní položky:

Poznámka

Polím, která jsou definována v procesu šablony pro Microsoft Solutions Framework není přiřazen Název výkazu nebo Název referenčního výkazu.Standardně se používá referenční název a atributy názvu.
- name. Popisný název pole, které se zobrazí v rozevíracích nabídkách dotazů na pracovní položku. Popisný název musí být jedinečný ve všech oblastech, které jsou definovány v rámci týmového projektu. Popisný název se také může lišit od zobrazeného popisku, který je přiřazen poli ve formuláři pracovní položky. Další informace naleznete v tématu Control – referenční dokumentace elementu XML.
- refname. Jedinečný popisek, který je přiřazen poli, které se odlišuje od všech ostatních polí definovaných v kolekci týmového projektu. Hodnotu přiřazenou refname nelze změnit.
  
  Požadavky a omezení vhodných názvů a názvů odkazů pro pole naleznete v tématu Vytváření názvů pro objekty sledování pracovní položky.
- reportingname. Nepovinný atribut. Název používaný k identifikaci polí v sestavách. Pokud není hodnota výslovně stanovena, bude použita hodnota, která je přiřazena atributu name.
- reportingrefname. Nepovinný atribut. Jedinečný popisek, který je přiřazen poli s možností vykazování, které ho odlišuje od všech ostatních vykazovatelných polí definovaných ve všech kolekcích týmového projektu. Pokud není hodnota výslovně stanovena, bude použita hodnota, která je přiřazena atributu refname. Doporučené konvence pojmenování naleznete v oddílu Doporučené postupy při přiřazování reportování názvů odkazů dále v tomto tématu.
  
  Poznámka
  
  Vykazování názvů odkazu je viditelné pouze v sestavě kontingenční tabulky nebo v datové krychli Analysis Services.

Použít existující pole

Měli byste použít pole, které je již definováno, pokud toto pole odpovídá informacím, které chcete sledovat a vykazovat. Chcete-li použít existující pole, proveďte následující kroky:

Určete pole, která chcete použít. Použijte příkaz witadmin listfields k identifikaci polí a jejich atributů, které jsou definovány pro všechny kolekce projektu. Další informace naleznete v tématu Seznam polí definovaných pro kolekci týmového projektu dále v tomto tématu.
Určete, zda je pole reportovatelné a zda reportovatelné atributy odpovídají potřebám vykazování.
Pokud není reportovatelné, použijte witadmin changefield pro změnu reportovatelného atributu pro kolekce projektů, ve kterých se použije. Další informace naleznete v tématu Změna událostí podléhajících poli atributu dále v tomto tématu.
Pokud není definováno pole kolekce pro projekt, přidejte ho do definičních souborů XML pro typy pracovních položek, které chcete použít ke sledování dat. Další informace naleznete v tématu Přidání polí pro podporu zasílání zpráv dále v tomto tématu.

Seznam polí definovaných pro kolekci týmového projektu

Pomocí příkazu witadmin listfields můžete vytvořit seznam polí a jejich atributů. Můžete vytvořit seznam určitého pole nebo všech polí, která jsou definována v kolekci projektu. Příkaz witadmin listfields má následující syntaxi:

witadmin listfields /collection:CollectionURL /n:RefName

Další informace naleznete v tématu Manage work item fields [witadmin].

Reportovatené atributy pole

Reportovatená pole mají hodnotu atributu reportable Detail, Dimension nebo Measure. Následující atributy určují, jak se pole pracovní položky exportují a zpracovávají v datech databáze úložiště:

reportingtype. Chcete-li do sestavy zahrnout pole, musíte přiřadit jednu z následujících hodnot atributu reportable:
- Přiřaďte Detail pro export pole do skladu relační databáze, ale ne do kostky. Jak ukazuje následující příklad, použijte typ Detail pouze pro pole Integer, Double, String nebo DateTime:
```
<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">
```
- Přiřaďte Dimension pro export pole do skladu relační databáze a současně do kostky. Jak ukazuje následující příklad, použijte Dimension pouze pro pole Integer, String nebo DateTime. Tato hodnota je užitečná pro zahrnutí polí, která slouží k filtrování sestav (například pole, která mají seznamy platných hodnot).
```
<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">
```
- Přiřaďte Measure pro podporu zpracování předem vypočítaných hodnot v datové krychli. Používejte typ Measure pouze pro celé číslo a dvojitá pole.
  
  Když 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 jiný referenční název poli, které je označeno jako vykazovatelné. Pokud nezadáte hodnotu, je použita hodnota, která je přiřazena atributu refname.

Použijte tento atribut ke sloučení nebo odchýlení polí, která jsou zahrnuta do sestav. Chcete-li sloučit dvě pole, která jsou definována v různých projektech kolekce s různými názvy odkazu, přiřaďte jiný reportingrefname k oběma polím. Chcete-li odchýlit dvě pole, která jsou definována v různých projektech kolekce ale se stejným názvem odkazu, přiřaďte jiný reportingrefname k jednotlivým polím.

Měli byste sloučit pole, kdykoli je to možné, abyste minimalizovali počet polí ve skladu a pomohli zůstat pod maximálním limitem 1024 reportovatelných polí. Můžete generovat sestavy křížové skupiny obsahující sloučená pole.
reportingname. Můžete přiřadit jiný popisek k poli, který se používá k zobrazení dat v sestavách. Pokud nezadáte hodnotu, bude použit popisný název, který je přiřazen atributu name. Hodnota přiřazená k reportingname se objeví v datové krychli. Hodnota přiřazená k reportingrefname se nezobrazí.

Důležité

Měli byste použít doporučené postupy značení polí pro vytváření sestav, aby byla seskupena dohromady v kontingenčních tabulkách.Další informace naleznete v tématu Doporučené postupy při přiřazování vykazování názvů odkazů.

Změna využitelného atributu pro pole pracovní položky

Existující pole můžete nastavit jako prohledatelné změnou přiřazení atributů pole, která jsou definována pro kolekci projektu. Existující pole je definováno v jedné nebo více definicích typu pracovní položky. Můžete také změnit všechny atributy, které určují způsob zpracování pole v datových úložištích.

Chcete-li změnit přiřazení atributu pole, můžete použít následující sled kroků:

Chcete-li změnit přiřazení atributu poli, můžete použít příkaz witadmin changefield. Tento příkaz se používá pro kolekci týmového 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 nastavit jako vykazovatelné, změňte typ vykazování. Například pro zpřístupnění pole AW.Common.TeamPriority pro filtrování sestav, jí přiřaďte hodnoty dimenze:
```
witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.Common.TeamPriority /reportingtype:dimension 
```
Další informace naleznete v tématu Manage work item fields [witadmin].
(Volitelné) Pokud máte více než jednu kolekci projektů, můžete provést změny podobné změny pole pracovní položky, které je definováno v této kolekci. Aby nedošlo ke konfliktům schématu při exportu a zpracování v databázích datového skladu, musíte přiřadit stejné hodnoty těmto atributům ve všech kolekcích:
- Typ pole (hodnotu pro toto pole nelze změnit pro existující pole).
- Typ sestavy.
- Název výkazu.
Další informace naleznete v tématu Resolve schema conflicts that are occurring in the data warehouse.
Po provedení všech změn polí pracovní položky, které chcete použít pro vytváření sestav, je nutné zpracovat databáze datového skladu. Můžete použít webové služby ProcessWarehouse a ProcessAnalysis, které jsou k dispozici prostřednictvím WarehouseControlWebService.

Tento krok zajistí, lidé, kteří používají sestavy, neuvidí při změně pole atributů chybu.

Další informace naleznete v tématu Manage work item fields [witadmin].

Přidání polí pro podporu sestav

Pole můžete přidat do definice typu položky práce nebo typů. Při přidání pole byste měli přidat stejnou definici elementu pole pro všechny typy pracovních položek, u kterých pole podporuje vykazování. Pokud chcete, aby pole podporovalo reportování mezi projekty, mělo by být pole přidáno pro všechny typy pracovních položek ve všech týmových projektech, které budou reportovány.

Další informace naleznete v tématu Define and modify work item fields.

Ověřit změny provedené u atributů vykazovatelných polí

Můžete ověřovat změny, které jste provedli u vykazovatelných atributů polí zpracováním datových skladů na požádání a následnou kontrolou sestav k ověření, zda jsou aktualizovány. Nebo můžete počkat, dokud se nespustí úlohy adaptéru skladu. Ve výchozím nastavení je relační databáze zpracována každých několik minut. Krychle je však ve výchozím nastavení zpracována každé dvě hodiny.

Poznámka

Další informace o WarehouseControlWebService naleznete v tématu Ruční zpracování datového skladu a datová krychle služby pro analýzu pro Team Foundation Server.

Zpracujte datový sklad s relačními daty na vyžádání pomocí ProcessWarehouse WarehouseControlWebService.
Zpracujte datovou krychli na vyžádání pomocí ProcessAnalysisDatabase WarehouseControlWebService.
Ověřte, že jsou zprávy aktualizovány. Zobrazte sestavu prostřednictvím řídicího panelu nebo správce sestav. Další informace naleznete v tématech Řídicí panely projektového portálu a Sestavy (SQL Server Reporting Services).

Doporučené postupy při přiřazování vykazování názvů odkazů

Chcete přiřadit popisky vykazování referenčních názvů, abyste mohli snadno najít pole v sestavě kontingenční tabulky a datové krychle. Lze toho dosáhnout použitím systematických pojmenovacích konvencí, tak aby pole byla seskupena v logické posloupnosti. Kromě toho, pokud pole nejsou seskupeny vhodným způsobem, můžete změnit referenční název pole pro hlášení.

Použití systematické konvence pojmenování se stává čím dál více důležité, protože všechna reportovatelná data ze všech týmových projektů, které jsou definovány ve všech kolekcích projektů pro nasazení produktu, jsou zapsána do jediného relačního datového skladu. Data z tohoto datového skladu jsou potom zpracována a zapsána do datové krychle. Vzhledem k tomu, že pole pracovních položek jsou řízeny odděleně pro každou kolekci projektu, různé popisky mohou být použity a to může vést k sadě polí, která není dobře uspořádána pro podporu vytváření sestav.

Pole Pracovní položka, která mají vykazovatelný typ dimenze, odpovídají atributům dimenze v krychli. Atributy dimenze jsou uspořádány do složek, které jsou založeny na referenčním názvu hlášení přiřazenému v šabloně postupu nebo definici každého pracovní položky. Dochází k následujícím typům mapování:

Pole, která mají předponu "Systém" jsou vnitřní objekty a jsou uvedeny přímo pod dimenzí pracovní položky, před "Pracovní položka".
Ostatní pole jsou ve složkách, jejichž názvy odpovídají předponám v jejich referenčních názvech. Například pole s předponou „Microsoft.VSTS.Common“ se nachází ve složce s názvem „Microsoft VSTS Common“.

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

Folder structure in OLAP data cube

V následující tabulce jsou uvedena pole, jejichž referenční názvy začínají textem "System", a které jsou uvedeny v sestavě kontingenční tabulky s předponou "Pracovní položka". Tato pole jsou umístěna přímo pod dimenzi Pracovní položka. Všechna ostatní pole jsou ve složkách, jejichž názvy odpovídají předponám v jejich referenčních názvech.

Poznámka

Nasazení, která nepoužívají verzi Enterprise SQL Server Analysis Services nemají přístup k funkcím překladu, které jsou k dispozici v této verzi.V těchto nasazeních jsou pole označeny podle jejich úplného názvu odkazu v kostce, kde "." nahrazuje "_" (například "System_Id" a "System_Title").

Název v sestavě s kontingenční tabulkou a datové krychli	Název odkazu	Typ dat
Pracovní položka.Cesta oblasti	System.AreaPath	TreeType
Pracovní položka.Přiřazeno	System.AssignedTo	Řetězec
Pracovní položka.Změnil(a)	System.ChangedBy	Řetězec
Pracovní položka.Datum změny	System.ChangedDate	DateTime
Pracovní položka.Vytvořil(a)	System.Created By	Řetězec
Pracovní položka.Datum vytvoření	System.CreatedDate	DateTime
Work Item.ID	ID systému	Integer
Pracovní položka.Cesta iterace	System.IterationPath	TreeType
Pracovní položka.Předchozí stav	System.PreviousState	Řetězec
Pracovní položka.Důvod	System.Reason	Řetězec
Work Item.Rev	System.Rev	Integer
Pracovní položka.Stav	System.State	Řetězec
Pracovní položka.Titul	System.Title	Řetězec
Work Item.Work Item Type	System.WorkItemType	Řetězec

V následující tabulce jsou uvedena pole, která se zobrazí v sestavě kontingenční tabulky ve složce s názvem "Microsoft.VSTS.Common" v dimenzi pracovní položky. Tato pole mají referenční názvy, která začínají Microsoft.VSTS.Common.

Název v sestavě s kontingenční tabulkou a datové krychli	Název odkazu	Typ dat
Pracovní položka.Aktivoval	Microsoft.VSTS.Common.ActivatedBy	Řetězec
Pracovní položka.Datum aktivace	Microsoft.VSTS.Common.ActivatedDate	DateTime
Pracovní položka.Zavřel(a)	Microsoft.VSTS.Common.ClosedBy	Řetězec
Pracovní položka.Datum uzavření	Microsoft.VSTS.Common.ClosedDate	DateTime
Pracovní položka.Vytvořil(a)	Microsoft.VSTS.Common.CreatedBy	Řetězec
Pracovní položka.Datum vytvoření	Microsoft.VSTS.Common.CreatedDate	DateTime
Pracovní položka.Vyřešil(a)	Microsoft.VSTS.Common.ResolvedBy	Řetězec
Pracovní položka.Datum vyřešení	Microsoft.VSTS.Common.ResolvedDate	DateTime
Pracovní položka.Důvod řešení	Microsoft.VSTS.Common.ResolvedReason	Řetězec
Pracovní položka.Priorita	Microsoft.VSTS.Common.Priority	Integer
Pracovní položka.Závažnost	Microsoft.VSTS.Common.Severity	Řetězec
Pracovní položka.Pořadí zásobníku	Microsoft.VSTS.Common.StackRank	Double

Viz také

Sdílet prostřednictvím