Dodawanie i modyfikowanie pól elementów pracy w celu obsługi raportowania

Artykuł
03/12/2013

Pola elementu pracy służy do śledzenia danych dla typu elementu pracy, aby zdefiniować kryteria filtru dla kwerend i do budowania raportów.Wszystkie pola oprócz systemowych, które mają zostać zamieszczone w sprawozdaniu musi być zdefiniowana w pliku definicji typów elementów roboczych, które śledzone w polu.Pola systemowe są automatycznie definiowane dla każdego typu elementu pracy.Jednakże muszą być uwzględnione w formularza elementu pracy w celu wspierania wprowadzania danych.

Aby obsługiwał raportowanie, można dodawać pola lub zmiany atrybutów istniejących pól.Podczas dodawania lub modyfikowania pól, należy zastosować systematyczne konwencji nazewnictwa, aby upewnić się, że dane jest logicznie pogrupowane w folderach w SQL Server moduł usług analiz.

W tym temacie

Najważniejsze wskazówki
Użyj istniejącego pola
Wyświetlić listę pól, które są zdefiniowane dla Kolekcja projektów zespołu
Atrybuty pól objętych obowiązkiem sprawozdawczym
Zmień atrybut objętego obowiązkiem sprawozdawczym pola.
Dodaj pola do raportowania obsługi technicznej
Sprawdź zmiany wprowadzone do atrybuty pól objętych obowiązkiem sprawozdawczym
Najważniejsze wskazówki podczas przypisywania zgłoszenie nazwy odniesienia

Aby uzyskać listę pól objętych obowiązkiem sprawozdawczym, zdefiniowane w domyślnych szablonów procesu, zobacz Objętych obowiązkiem sprawozdawczym odniesienia pól dla programu Visual Studio Informatykami.

Najważniejsze wskazówki

Aby dodać lub zmodyfikować pole, opisz według następujących wskazówek:

Określić, czy można użyć pola, które jest już zdefiniowana w Kolekcja projektów zespołu, który zawiera projektu zespołu.Użyj istniejącego pola obsługuje raportowanie między projektami.
Określić, czy można użyć pola, które jest już zdefiniowany w innej kolekcji projektów, wdrażanie Visual Studio Team Foundation Server. Użyj istniejącego pola obsługuje raportowanie między projektami.
Może mieć nie więcej niż 1 024 pola w każdym zbiorze projektu i nie więcej niż 1 024 unikatowe pola objętego obowiązkiem sprawozdawczym w wszystkie kolekcje projektu całej wdrażania programu Team Foundation Server.Scalone liczba pól jako jedno pole objętego obowiązkiem sprawozdawczym.
Instytut standardową procedurę i opisz proces dodawania i modyfikowania pól w szablony procesów, projektów zespołów lub kolekcje projektu.
Etykiety pól za zgłoszenie przy systematycznych konwencji nazewnictwa.Podczas przypisywania nazwy odniesień w systematyczny sposób przez wszystkie kolekcje projektu zespołu w danym wdrożeniu programu Team Foundation Server, zagwarantować bardziej spójne i użyteczne magazynu i schemat modułu i uniknąć konfliktów schematów w magazynie.Aby uzyskać więcej informacji, zobacz Rozwiązywanie konfliktów dotyczących schematów, które pojawiają się w magazynie danych.

Do czterech atrybutów etykiet można przypisać do pola elementu pracy:

[!UWAGA]

Pola, które są zdefiniowane w szablony procesów dla programu Microsoft Solutions Framework nie są przypisane, sprawozdawczości nazwę lub nazwę odwołania raportowania.Domyślnie nazwa odwołania i atrybuty nazwy są używane.
- name.Przyjazna nazwa pola, które pojawia się w menu rozwijanych kwerend elementu pracy.Przyjazna nazwa musi być unikatowa we wszystkich pól, które są zdefiniowane w projekcie zespołu.Ponadto przyjazna nazwa może się różnić od wyświetlonej etykietę, która jest przypisana do pola Praca w formularzu.Aby uzyskać więcej informacji, zobacz Odwołanie Element XML kontroli.
- refname.Unikatową etykietę, przypisanego do pola, które odróżniają ją od wszystkich pozostałych pól, które są zdefiniowane w Kolekcja projektów zespołu.Wartość, która jest przypisana do refname nie można zmienić.
  
  Wymagania i ograniczenia dotyczące przyjazne nazwy oraz nazwy odniesienia dla pól, zobacz Konwencje nazewnictwa dla elementu pracy śledzenia obiektów.
- reportingname.Atrybut opcjonalny.Nazwa, która jest używana do identyfikacji pola w raportach.Kiedy nie są jawnie ustawiony, wartość, która jest przypisana do name atrybut jest używany.
- reportingrefname.Atrybut opcjonalny.Unikatową etykietę, przypisanego do objętego obowiązkiem sprawozdawczym pole, które odróżniają ją od wszystkich pozostałych pól objętych obowiązkiem sprawozdawczym, które są zdefiniowane w wszystkie kolekcje projektu zespołu.Kiedy nie są jawnie ustawiony, wartość, która jest przypisana do refname atrybut jest używany.Aby zalecanych konwencji nazewnictwa, zobacz skutecznych rozwiązań gdy przypisywanie zgłoszenie nazwy odniesień dalszej części tego tematu.
  
  [!UWAGA]
  
  Raportowania nazwy odniesień są widoczne tylko na raport tabeli przestawnej lub moduł Analysis Services.

Użyj istniejącego pola

Należy użyć pola, która jest już zdefiniowana, jeśli informacje, które chcesz śledzić i tworzyć raporty na pasuje do tego pola.Aby użyć istniejącego pola, należy wykonać następujące czynności:

Zidentyfikuj pole, którego chcesz użyć.Użycie witadmin listfields do identyfikacji pola i ich atrybutów, które są zdefiniowane dla projektu wszystkie kolekcje.Aby uzyskać więcej informacji, zobacz Listy pól że są zdefiniowane dla Kolekcja projektów zespołu dalszej części tego tematu.
Określić, czy pole jest objęty obowiązkiem sprawozdawczym i czy atrybuty objętego obowiązkiem sprawozdawczym zaspokoi potrzeby firmy.
Jeśli nie jest objęty obowiązkiem sprawozdawczym, użyj witadmin changefield Aby zmienić atrybut objętych obowiązkiem zgłoszenia projektu zbierania danych, w których jest używany.Aby uzyskać więcej informacji, zobacz zmiany objętego obowiązkiem sprawozdawczym atrybutu dla pola dalszej części tego tematu.
Dla zbioru projektu, gdzie pole nie jest zdefiniowane należy go dodać do plików definicji XML dla typów elementów pracy, które chcesz użyć do śledzenia danych.Aby uzyskać więcej informacji, zobacz Dodaj pola do Support Reporting dalszej części tego tematu.

Wyświetlić listę pól, które są zdefiniowane dla Kolekcja projektów zespołu

Można użyć witadmin listfields polecenie do listy pól i ich atrybutów.Można wyświetlić listę określonego pola lub wszystkie pola, które są zdefiniowane w kolekcji projektu.witadmin listfields Polecenia ma następującą składnię:

witadmin listfields /collection:CollectionURL /n:RefName

Aby uzyskać więcej informacji, zobacz Zarządzanie polami elementów pracy [witadmin].

Atrybuty pól objętych obowiązkiem sprawozdawczym

Objętych obowiązkiem sprawozdawczym pola mają reportable wartość atrybut Detail, Dimension, lub Measure.Następujące atrybuty określają, jak pola elementu pracy przy eksportowaniu i przetwarzane do baz danych z magazynu danych:

reportingtype.Umieszczania pola w raportach, należy przypisać jedną z poniższych wartości: reportable atrybut:
- Przypisać Detail Aby wyeksportować pole do magazynu relacyjnej bazy danych, ale nie do modułu.Jak pokazano na poniższym przykładzie, należy użyć Detail typu tylko w przypadku pól typu Liczba całkowita, Double, ciąg znaków lub Data/Godzina:
```
<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">
```
- Przypisać Dimension Aby wyeksportować pole Magazyn relacyjnej bazy danych i moduł.Jak pokazano na poniższym przykładzie, należy użyć Dimension tylko dla pól typu Liczba całkowita, Double, ciąg znaków lub data/godzina.Wartość ta jest użyteczna zawierać pól, które są używane do filtrowania raportów (na przykład pola, które posiada listy prawidłowych wartości).
```
<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">
```
- Przypisać Measure do obsługi przetwarzania obliczone wcześniej wartości w module.Użycie Measure typu tylko w stosunku do pola Liczba całkowita i podwójne.
  
  Podczas przypisywania środek jako reportingtype, należy przypisać sum jako formula, jak w poniższym przykładzie:
```
<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">
```
reportingrefname.Można przypisać nazwę różnych odwołanie do pola, która jest oznaczona za podlegające zgłoszeniu.Jeśli nie określono wartości, wartość, która jest przypisana do refname atrybut jest używany.

Za pomocą tego atrybutu, albo scalić lub odchylania się pola, które znajdują się w raportach.Aby scalić dwa pola w tym nazwy odrębne odwołanie, które zostały zdefiniowane w zbiorach innego projektu, należy przypisać taki sam reportingrefname do obu firm.Aby odbiegać dwa pola, które mają taką samą nazwę odwołania, ale które zostały zdefiniowane w zbiorach innego projektu, należy przypisać inny reportingrefname do każdego pola.

Pola w każdym przypadku, gdy jest to możliwe, aby zminimalizować liczbę pól w magazynie i prowadzi stałą maksymalny limit 1024 objętego obowiązkiem sprawozdawczym pól należy korespondencji seryjnej.Można generować raporty różnych grup z scalonych pól.

reportingname.Do pola, które służy do wyświetlania danych w raportach można przypisać inną etykietę.Jeśli nie określono wartości, przyjazny nazwę, która jest jest przypisany do name atrybut jest używany.Wartość, która jest przypisana do reportingname pojawia się w module.Wartość, która jest przypisana do reportingrefname jest niewidoczny.

Ważne
Należy korzystać z najważniejszych wskazówek, aby etykiety zgłoszenie pól, dzięki czemu są pogrupowane w raportach tabeli przestawnej.Aby uzyskać więcej informacji, zobacz skutecznych rozwiązań gdy przypisywanie zgłoszenie nazwy odniesień.

Zmień atrybut objętego obowiązkiem sprawozdawczym dla pola elementu pracy

Istnieje możliwość istniejącego pola objętego obowiązkiem sprawozdawczym poprzez zmianę przydziałów atrybutu pola, które są zdefiniowane dla kolekcji projektu.Istniejące pole jest zdefiniowany w jednej lub więcej definicji typu elementu pracy.Ponadto można zmieniać wszystkie atrybuty, które określają sposób przetwarzania pole w hurtowni danych.

Aby zmienić przypisanie atrybutu pola, można użyć następującej sekwencji czynności:

Można użyć witadmin changefield polecenie, aby zmienić przypisanie atrybutu do pola.Wykonuje się to polecenie, aby kolekcja projektów zespołu.Należy użyć następującej składni:
```
witadmin changefield /collection:CollectionURL /n:RefName [/name:NewName] [/syncnamechanges:true | false] [/reportingname:ReportingName] [/reportingrefname:ReportingRefName] [/reportingtype:Type] [/reportingformula:Formula] [/noprompt]
```
Aby z istniejącym polem objętego obowiązkiem sprawozdawczym, zmienić reportingtype.Na przykład: Aby udostępnić pole AW.Common.TeamPriority do filtrowania raportów, można przypisać do niej wartość wymiaru:
```
witadmin changefield /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /n:AW.Common.TeamPriority /reportingtype:dimension 
```
Aby uzyskać więcej informacji, zobacz Zarządzanie polami elementów pracy [witadmin].
(Opcjonalnie) Jeśli masz więcej niż jednej kolekcji projektu, można wprowadzić zmiany podobne do pola elementu Praca, która jest zdefiniowana w tej kolekcji.Aby uniknąć konfliktów w schemacie, podczas eksportowania i przetwarzania danych z danymi magazyn baz danych, należy przypisać te same wartości do tych atrybutów przez wszystkie kolekcje:
- Typ pola (wartość dla tego pola nie można zmienić dla istniejącego pola).
- Typ raportowania.
- Nazwa raportowania.
Aby uzyskać więcej informacji, zobacz Rozwiązywanie konfliktów dotyczących schematów, które pojawiają się w magazynie danych.
Po dokonaniu wszystkich zmian do pól elementu pracy, których chcesz użyć dla raportowania, należy przetworzyć bazy danych magazynu danych.Można użyć ProcessWarehouse i ProcessAnalysis usług, które są dostępne za pośrednictwem sieci Web WarehouseControlWebService.

Ten krok sprawia, że się, że ludzie, którzy korzystają z raportów nie zostanie wyświetlone błąd zmienić atrybuty pól.

Aby uzyskać więcej informacji, zobacz Zarządzanie polami elementów pracy [witadmin].

Dodaj pola do raportowania obsługi technicznej

Można dodać pola do definicji typ pozycji roboczej lub typów.Po dodaniu pola, należy dodać tę samą definicję elementu pola do wszystkich typów elementów roboczych, dla których pole będzie obsługiwał raportowanie.Jeśli chcesz, aby pole, aby obsługiwał raportowanie między projektami, pole należy uwzględnić wszystkie typy elementów pracy we wszystkich projektach zespołu, które będą zgłaszane na.

Aby uzyskać więcej informacji, zobacz Praca z polami elementu pracy.

Sprawdź zmiany wprowadzone do atrybuty pól objętych obowiązkiem sprawozdawczym

Można zweryfikować zmiany, dokonane w atrybuty pól objętych obowiązkiem sprawozdawczym przetwarzania magazynów danych na żądanie i następnie sprawdzając raporty Aby zweryfikować, że są one aktualizowane.Lub poczekać do czasu uruchomienia zadań hurtowni karty.Domyślnie relacyjnej bazy danych jest przetwarzany co kilka minut.Jednakże moduł jest przetwarzany co dwie godziny domyślnie.

[!UWAGA]

Aby uzyskać więcej informacji o WarehouseControlWebService, zobacz ręcznie przetwarzać magazyn danych i moduł usług analiz programu Team Foundation Server.

Proces Magazyn danych relacyjnych, na żądanie za pomocą ProcessWarehouse WarehouseControlWebService.
Przetworzyć moduł na żądanie za pomocą ProcessAnalysisDatabase WarehouseControlWebService.
Sprawdź, że raporty są aktualizowane.Wyświetl raport za pośrednictwem pulpitu nawigacyjnego lub Menedżer raportów.Aby uzyskać więcej informacji, zobacz Pulpity nawigacyjne (Agile) lub Raporty (Agile).

Najważniejsze wskazówki podczas przypisywania zgłoszenie nazwy odniesienia

Za zgłoszenie nazwy odniesień, chcesz przypisać etykiety, dzięki czemu można łatwo znaleźć pola w raporcie tabeli przestawnej, a moduł.Można to osiągnąć poprzez stosowanie systematycznych konwencji nazewnictwa, aby pola były grupowane zgodnie z logiczną sekwencją.Dodatkowo Jeśli pola nie są zgrupowane w użyteczny sposób, można zmienić sprawozdawczości nazwę odwołania, pola.

Staje stosowanie systematycznych konwencję nazewnictwa się coraz większe znaczenie, ponieważ wszystkie dane objętych obowiązkiem sprawozdawczym z wszystkich projektów zespołu, które są zdefiniowane w projekcie wszystkie operacje wyrzucania elementów są zapisywane do składu pojedynczej w relacyjnej bazie danych.Dane z tego magazynu są następnie przetwarzane i zapisywane do modułu.Ponieważ pola elementu pracy są wyraźnie zarządzane dla każdej kolekcji projektów, inne etykiety mogą być stosowane i może prowadzić do zestawu pól nie są dobrze zorganizowane do obsługi tworzenia raportów.

Pola elementu pracy, które mają objętego obowiązkiem sprawozdawczym typ wymiaru odpowiadają atrybutów wymiaru w module.Atrybutów wymiaru są zorganizowane w foldery, które są oparte na raportowania nazwę odniesienia, które przypisano w szablonie procesu lub pracować w definicji typu elementu.Występują następujące rodzaje mapowania:

Pola, które mają prefiks "System" są wymienionych bezpośrednio pod wymiar pozycji roboczej, wewnętrzne z "Element pracy" zabezpieczony.
Inne pola są umieszczane w obszarze foldery, których nazwy odpowiadają prefiksy w nazwach odniesienia.Na przykład, pola, które mają prefiks "Microsoft.VSTS.Common" są wyświetlane w folderze to jest oznaczona jako "Microsoft VSTS Common."

Jak pokazano na poniższej ilustracji, dla każdej grupy prefiks pól, które współużytkują Wspólny prefiks zostanie dodany folder:

Struktura folderów w module danych OLAP

W poniższej tabeli wymieniono pola, których nazwy odniesienia zaczynają się od "System" i wymienione w raporcie tabeli przestawnej za pomocą prefiksu "Elementu pracy." Pola te są umieszczane bezpośrednio w ramach wymiaru elementu pracy.Wszystkie pozostałe pola są umieszczane w obszarze foldery, których nazwy odpowiadają prefiksy w nazwach odniesienia.

[!UWAGA]

Wdrożeń, które nie korzystają z wersji Enterprise SQL Server usługi Analysis Services nie mają dostępu do funkcji tłumaczenia, które są dostarczane przez tę wersję.W przypadku wdrożeń te pola są identyfikowane według nazwy pełne odniesienia w module, z "." zastępuje się "_" (na przykład "System_Id" i "System_Title").

Nazwa w raporcie tabeli przestawnej i kostki wielowymiarowej	Nazwa odwołania	Typ danych
Ścieżka Item.Area robocza	System.AreaPath	TreeType
Item.Assigned do pracy	System.AssignedTo	Ciąg
Item.Changed pracy przez	System.ChangedBy	Ciąg
Data Item.Changed pracy	System.ChangedDate	DateTime
Item.Created pracy przez	System.Created przez	Ciąg
Data Item.Created pracy	System.CreatedDate	DateTime
Item.ID pracy	System.Id	Liczba całkowita
Ścieżka Item.Iteration robocza	System.IterationPath	TreeType
Stan Item.Previous pracy	System.PreviousState	Ciąg
Item.Reason pracy	System.Reason	Ciąg
Item.Rev pracy	System.Rev	Liczba całkowita
Item.State pracy	System.State	Ciąg
Item.Title pracy	System.Title	Ciąg
Typ elementu Item.Work pracy	System.WorkItemType	Ciąg

Poniższa tabela zawiera listę pól, które pojawiają się w raporcie tabeli przestawnej, w folderze o nazwie "Microsoft.VSTS.Common" w obszarze wymiaru elementu pracy.Pola te mają nazwy odniesień, które rozpoczynają się od "Microsoft.VSTS.Common".

Nazwa w raporcie tabeli przestawnej i kostki wielowymiarowej	Nazwa odwołania	Typ danych
Item.Activated pracy przez	Microsoft.VSTS.Common.ActivatedBy	Ciąg
Data Item.Activated pracy	Microsoft.VSTS.Common.ActivatedDate	DateTime
Item.Closed pracy przez	Microsoft.VSTS.Common.ClosedBy	Ciąg
Data Item.Closed pracy	Microsoft.VSTS.Common.ClosedDate	DateTime
Item.Created pracy przez	Microsoft.VSTS.Common.CreatedBy	Ciąg
Data Item.Created pracy	Microsoft.VSTS.Common.CreatedDate	DateTime
Item.Resolved pracy przez	Microsoft.VSTS.Common.ResolvedBy	Ciąg
Data Item.Resolved pracy	Microsoft.VSTS.Common.ResolvedDate	DateTime
Przyczyna Item.Resolved pracy	Microsoft.VSTS.Common.ResolvedReason	Ciąg
Item.Priority pracy	Microsoft.VSTS.Common.Priority	Liczba całkowita
Item.Severity pracy	Microsoft.VSTS.Common.Severity	Ciąg
Ranga Item.Stack pracy	Microsoft.VSTS.Common.StackRank	Wartość dwubajtowa

Zobacz też

Udostępnij za pośrednictwem