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

Článek
03/04/2013

Pracovní položka pole lze využít ke sledování dat pro položku Typ práce, chcete-li definovat kritéria filtru pro dotazy a pro použití v sestavách.Všechna pole kromě pole systému, které se mají zobrazit v sestavě musí být definován v souboru definice typů pracovních položek, které budou sledovat pole.Systém automaticky polí pro každý typ položky práce.Však musí být obsažena v formulář pracovní položky pro podporu zadávání dat.

Pro podporu vytváření sestav, můžete přidat pole nebo změnit atributy existujících polí.Je-li přidat nebo upravit pole, můžete zažádat o systematické konvence, ujistěte se, že data je logicky seskupeny 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ýmového projektu
Hodné atributy pole
Změna hodné atribut pro 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í názvů odkaz

Seznam hodné polí definovaných v procesu výchozích šablon naleznete v tématu Hodné pole odkazu sady Visual Studio ALM.

Doporučené postupy

Předtím, než přidáte nebo změníte pole, přečtěte si následující doporučené postupy:

Zjistěte, zda můžete použít pole, který je již definován v kolekce týmového projektu, který obsahuje týmového projektu.Použití existujícího pole podporuje vykazování mezi více projekty.
Zjistěte, zda můžete použít pole, který je již definován v kolekci jiného projektu nasazení Visual Studio Team Foundation Server. Použití existujícího pole podporuje vykazování mezi více projekty.
Můžete mít více než 1 024 polí v každé kolekci projektu a ne více než 1 024 jedinečný hodné polí ve všech kolekcích projektu po celou dobu nasazení sady Team Foundation Server.Sloučit pole počet jako jedno hodné pole.
Zavést jednotný postup a recenzování můžete přidávat a upravovat šablony procesů, týmové projekty nebo kolekce projektů.
Systematické vytváření názvů použijte v případě, že popisek pole pro vykazování.Když přiřadíte referenční názvy systematicky přes všechny kolekce týmových projektů nasazení z 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émat, které se vyskytují v datovém skladu.

Přiřadíte-li až čtyři atributů popisku pole položku práce:

[!POZNÁMKA]

Pole, které jsou definovány v procesu šablony pro Microsoft Solutions Framework nejsou přiřazeny, přídavné jméno nebo přídavné název odkazu.Standardně se používají název odkazu a atributy názvu.
- name.Popisný název pole, které se objeví v rozevíracích nabídkách pracovní položku dotazy.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 popisku, který je přiřazen do pole na formulář pracovní položka.Další informace naleznete v tématu Odkaz Element jazyk XML řízení.
- refname.Jedinečný popisek, který je přiřazen do pole, která ji odlišuje od jiných polí, které jsou definovány v kolekci týmového projektu.Hodnota, která je přiřazena refname nelze změnit.
  
  Požadavky a omezení popisné názvy a názvy odkaz pro pole naleznete v tématu Vytváření názvů pro objekty sledování pracovní položky.
- reportingname.Nepovinný atribut.Název, který se používá k identifikaci pole do sestavy.Pokud není explicitně nastavena, hodnota, která je přiřazena name atribut je použit.
- reportingrefname.Nepovinný atribut.Jedinečný popisek, který je přiřazen k hodné pole, která ji odlišuje od všech hodné polí, která jsou definována v všechny kolekce týmových projektů.Pokud není explicitně nastavena, hodnota, která je přiřazena refname atribut je použit.Doporučené zásady vytváření názvů, viz Doporučené postupy při přiřazování vykazování názvů odkaz dále v tomto tématu.
  
  [!POZNÁMKA]
  
  Přídavné referenční názvy jsou viditelné pouze v kontingenční tabulce nebo datové krychli služby Analysis Services.

Použít existující pole

Pokud použijete pole, který je již definován, je-li toto pole odpovídá informacím, které chcete sledovat a podávat zprávy o.Chcete-li použít existující pole, proveďte následující kroky:

Určete pole, která chcete použít.Použití witadmin listfields příkaz k identifikaci polí a jejich atributů, které jsou definovány pro všechny projektu kolekce.Další informace naleznete v tématu Seznam polí, jsou definovány pro kolekci týmového projektu dále v tomto tématu.
Určete, zda je pole hodné a zda hodné atributy potřebám vykazování.
Pokud se hodné, použijte witadmin changefield změnit atribut hodné pro kolekce projektů, ve kterých je použit.Další informace naleznete v tématu Změna hodné atribut pro pole dále v tomto tématu.
Kolekce projektu, kde není definováno pole přidejte jej do definiční soubory XML pro práci typy položek, které chcete použít ke sledování dat.Další informace naleznete v tématu Přidat pole Support Reporting dále v tomto tématu.

Seznam polí, která jsou definována pro kolekci týmového projektu

Můžete použít witadmin listfields příkaz seznamu polí a jejich atributů.Můžete vytvořit seznam zadaného pole nebo všechna pole, které jsou definovány v kolekci projektu.witadmin listfields Příkaz má následující syntaxi:

witadmin listfields /collection:CollectionURL /n:RefName

Další informace naleznete v tématu Správa polí pracovních položek [witadmin].

Hodné atributy pole

Hodné pole mají reportable hodnotu atributu Detail, Dimension, nebo Measure.Následující atributy určují, jak pracovní položky pole vyváží a zpracována data skladové databáze:

reportingtype.Chcete-li do sestavy zahrnout pole, musíte přiřadit jednu z následujících hodnot reportable atributu:
- Přiřazení Detail Chcete-li exportovat pole v relační databázi, ale nikoli krychle.Jak ukazuje následující příklad použití Detail typu pouze pro pole Integer, Double, řetězec nebo datum a čas:
```
<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">
```
- Přiřazení Dimension Chcete-li exportovat pole v relační databázi a datovou krychli.Jak ukazuje následující příklad použití Dimension pouze pro pole Integer, Double, řetězec nebo datum a čas.Tato hodnota je vhodné zahrnout pole, 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řazení Measure pro podporu zpracování předem vypočítaných hodnotách v datové krychli.Použití Measure typu pouze pro pole celé číslo a Double.
  
  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.Přiřadíte-li různé referenční název pole, která je označena jako hodné.Pokud není zadána žádná hodnota, hodnota, která je přiřazena refname atribut je použit.

Tento atribut můžete použít 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 pro obě.Odchýlit se dvě pole, které mají stejný název odkazu, ale které jsou definovány v kolekce různých projektů, můžete přiřadit jinou reportingrefname k jednotlivým polím.

Měli byste sloučit pole, kdykoli je to možné, minimalizovat počet polí ve skladu a vést pod maximální limit 1024 hodné polí.Můžete generovat sestavy křížové skupiny obsahující sloučené pole.

reportingname.Přiřadíte-li jiný popisek pole, které slouží k zobrazení dat v sestavách.Pokud není zadána žádná hodnota, popisný název, který je přiřazen name atribut je použit.Hodnota, která je přiřazena reportingname se zobrazí v datové krychli.Hodnota, která je přiřazena reportingrefname se nezobrazí.

Důležité
Měli byste použít doporučené postupy pro popisek vykazování polí tak, aby jejich jsou seskupeny 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 hodné atribut pro pole položku práce

Hodné existující pole můžete provést změnou přiřazení atributu pole, které jsou definovány pro kolekci 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 úložištích.

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

Můžete použít witadmin changefield příkaz ke změně přiřazení atributu do pole.Vykonávat tento příkaz 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 hodné, změňte reportingtype.Například pole AW.Common.TeamPriority zpřístupnit pro filtrování sestav, přiřadíte jí hodnotu dimenze:
```
witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.Common.TeamPriority /reportingtype:dimension 
```
Další informace naleznete v tématu Správa polí pracovních položek [witadmin].
(Volitelné) Pokud máte více než jeden projekt, může být vhodné provést změny podobné položky pole práce, který je definován v této kolekci.Konfliktům schématu při exportu a zpracování dat pro data skladu databází, je nutné přiřadit stejné hodnoty těchto atributů přes všechny kolekce:
- Typ pole (hodnota pro toto pole nelze změnit stávající pole).
- Hlášení typu.
- Přídavné jméno.
Další informace naleznete v tématu Řešení konfliktů schémat, které se vyskytují v datovém skladu.
Po provedení všech změn do pole na práce položky, které chcete použít pro vykazování, je nutné zpracovat data skladové databáze.Můžete použít ProcessWarehouse a ProcessAnalysis webových služeb, které jsou k dispozici WarehouseControlWebService.

Tento krok zajistí, že lidé, kteří pomocí sestav není zobrazí chyba, když změníte pole atributů.

Další informace naleznete v tématu Správa polí pracovních položek [witadmin].

Přidání polí do Support Reporting

Přidáte-li pole definici pracovní položky typ nebo typy.Přidáte-li pole, měli byste přidat stejnou definici prvku pole pro všechny typy pracovních položek, pro které bude podporovat vytváření sestav.Pokud chcete, aby pole, a nepodporuje proto vytváření vazby mezi projekty, by mělo být pole do všech typů práce položky v týmové projekty, které budou vykazovány v.

Další informace naleznete v tématu Práce s poli pracovní položky.

Zkontrolujte změny atributů hodné pole

Můžete ověřovat změny, provedené hodné pole atributy zpracování datových skladů na požádání a pak zkontroluje sestavy chcete-li ověřit, zda jsou aktualizovány.Nebo můžete počkat, dokud spustit úlohy adaptér skladu.Ve výchozím nastavení je zpracována relační databáze každých několik minut.Nicméně je datová kostka zpracována každé dvě hodiny ve výchozím nastavení.

[!POZNÁMKA]

Další informace o WarehouseControlWebService, viz Ruční zpracování datového skladu a analýzy datová krychle služby pro sadu Team Foundation Server.

Zpracování relační datový sklad na požádání pomocí ProcessWarehouse WarehouseControlWebService.
Zpracování datové krychle na požádání pomocí ProcessAnalysisDatabase WarehouseControlWebService.
Ověřte, že aktualizované zprávy.Zobrazení sestavy prostřednictvím řídicího panelu nebo správce sestav.Další informace naleznete v tématech Řídicí panely (agilní) a Sestavy (agilní).

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

Pro vykazování názvů odkaz, kterou chcete přiřadit popisky, takže můžete snadno najít pole v sestavě kontingenční tabulky a datové krychle.To lze dosáhnout použitím systematické vytváření názvů tak, aby pole jsou seskupeny v logické posloupnosti.Kromě toho pole nebudou seskupeny vhodným způsobem, můžete změnit přídavné jméno referenční pole.

Použití systematické pojmenování stává stále důležitější, protože všech hodné data z všechny týmové projekty, které jsou definovány ve všech kolekcích projektu zapsána do jednoho relační datový sklad.Data z tohoto skladu je pak zpracována a zapsány do datové krychle.Protože pracovní položky pole jsou spravovány odděleně pro každou kolekci projektu, různé popisky mohou být použity a může vést k sadu polí, která nejsou dobře uspořádána pro podporu vytváření sestav.

Pracovní položky pole, která mají hodné typ dimenze odpovídají atributy dimenzí v krychli.Dimenze atributů jsou uspořádány do složek, které jsou založeny na vykazování název odkazu, který je přiřazen ve šablonu procesu nebo pracovní definici typu položky.Dojde k následující typy mapování:

Pole, která mají předponu "Systém" jsou vnitřní a přímo pod dimenze položky pracovní položkou"práce" před.
Ostatní pole jsou umístěny ve složkách, jejichž názvy odpovídají předpony v jejich názvech odkaz.Například pole, která mají předponu "Microsoft.VSTS.Common" jsou uvedeny ve složce, který je s popiskem "Microsoft VSTS společného."

Jak je vidět na následujícím obrázku, přidání složky pro každou skupinu polí, které sdílejí společný prefix předpona:

Struktura složek v datové krychli OLAP

Následující tabulka uvádí pole, jejichž názvy odkaz začíná textem "System" a které jsou uvedeny v sestavě kontingenční tabulky s předponou "Pracovní položka." Tato pole jsou umístěny přímo pod pracovní položka dimenze.Všechna ostatní pole jsou umístěny ve složkách, jejichž názvy odpovídají předpony v jejich názvech odkaz.

[!POZNÁMKA]

Nasazení, které nepoužívají verzi Enterprise SQL Server služby Analysis Services nemají přístup k překladatelské funkce, které jsou součástí této verze.V těchto nasazení polí jsou označeny podle jejich názvu úplný odkaz v datové krychli, "." nahrazuje "_" (například "System_Id" a "System_Title").

Název v kontingenční tabulce a krychle	Název odkazu	Typ dat
Pracovní cesta Item.Area	System.AreaPath	TreeType
Item.Assigned práce na	System.AssignedTo	Řetězec
Item.Changed práce podle	System.ChangedBy	Řetězec
Pracovní datum Item.Changed	System.ChangedDate	Datum a čas
Item.Created práce podle	System.Created podle	Ř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 obsahuje pole, která se zobrazí v sestavě kontingenční tabulky ve složce s názvem "Microsoft.VSTS.Common" v rámci dimenze pracovní položky.Tato pole mají odkaz začínající na "Microsoft.VSTS.Common".

Název v kontingenční tabulce a krychle	Název odkazu	Typ dat
Item.Activated práce podle	Microsoft.VSTS.Common.ActivatedBy	Řetězec
Pracovní datum Item.Activated	Microsoft.VSTS.Common.ActivatedDate	Datum a čas
Item.Closed práce podle	Microsoft.VSTS.Common.ClosedBy	Řetězec
Pracovní datum Item.Closed	Microsoft.VSTS.Common.ClosedDate	Datum a čas
Item.Created práce podle	Microsoft.VSTS.Common.CreatedBy	Řetězec
Pracovní datum Item.Created	Microsoft.VSTS.Common.CreatedDate	Datum a čas
Item.Resolved práce podle	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

Viz také

Sdílet prostřednictvím