Praca z polami elementu pracy

Śledzenie danych dla typu elementu pracy i zdefiniowania kryteriów filtrowania dla kwerend, a także co do generowania raportów za pomocą pola elementu pracy.Dowolnego elementu danych, z wyjątkiem podstawowych pól danych systemowych w Team Foundation Server (TFS), że chcesz śledzić, służy do definiowania przepływu pracy lub występować w formularzu na typ pozycji roboczej musi być zdefiniowany jako pole elementu pracy.Można zdefiniować pola elementu pracy w ramach definicji typ pozycji roboczej lub globalnego przepływu pracy.

Pola elementu pracy są utrzymywane przez Kolekcja projektów zespołu.Możesz dodać pola, gdy wykonasz jedną z następujących czynności:

• Tworzenie zespołu projektu.Tworzone są wszystkie pola, które są definiowane według definicji dla typów elementów pracy lub globalnego przepływu pracy i które zostały zdefiniowane dla szablonu wybranego procesu.Pola systemowe core automatycznie są definiowane dla każdego typu elementu pracy, jest zdefiniowany dla zespołu projektu.Aby uzyskać listę tych pól, zobacz Odwołania pola elementu pracy dla Visual Studio ALM.

• Importuj definicję dla typu elementu pracy.Wszystkie nowe pola, które są zdefiniowane w ramach definicji dla typu elementu pracy są dodawane do kolekcji.Aby uzyskać więcej informacji, zobacz Wszystkie odniesienia do elementów XML WITD.

• Importuj definicję globalnego przepływu pracy.Wszystkie nowe pola, które są zdefiniowane w ramach globalnego przepływu pracy są dodawane do kolekcji.Definiujemy globalnego przepływu pracy, gdy użytkownik chce zachować zestaw pól elementu pracy, które współużytkują kilka typów elementów roboczych.Aby uzyskać więcej informacji, zobacz Dopasowywanie globalnego przepływu pracy.

• Mapować Kolekcja projektów do wystąpienia programu PWA Project Web App (została).Po zainstalowaniu Team Foundation Server rozszerzeń dla programu Project Server, konfigurowanie integracji mapując różnych składników Team Foundation.Podczas mapowania kolekcja jest importowana definicja globalnego przepływu pracy, która obsługuje kilka pól w polach programu Project Server.Aby uzyskać więcej informacji, zobacz Pola programu Project Server jest dodawane do obsługi synchronizacji danych.

Wszystkie pola, które są zdefiniowane w wszystkie typy elementów pracy i globalnych przepływów pracy dla wszystkich projektów zespołu tworzą kompletny zestaw pól, które są zdefiniowane dla kolekcji.Można zmienić atrybut, zmiana nazwy i usuwać istniejących pól.Jednak możesz ponosić pewne koszty, podczas dokonywania tego rodzaju zmian.Aby uzyskać więcej informacji, zobacz Dostosowanie danych śledzenia projektu, formularzy, przepływu pracy i innych obiektów.

Aby dodać lub dostosować pola dla kolekcji, należy zmodyfikować zawartość XML w definicji typu element pracy lub globalnego przepływu pracy.Zdefiniować każde pole przez FIELD elementu wewnątrz FIELDS sekcji definicji dla typu elementu pracy lub globalnego przepływu pracy.Aby uzyskać informacje na temat struktury i lokalizacji tych plików, zobacz Wszystkie odniesienia do elementów XML WITD i Dopasowywanie globalnego przepływu pracy.

W tym temacie

• Struktura Składnia pola (definicja)

• Typy danych pól

• Atrybuty objętego obowiązkiem sprawozdawczym, przypisane do pola

• Pola indeksowane

• Elementy podrzędne pola (definicja)

• Wstępnie zdefiniowane pola i pola systemowe

Struktura Składnia pola (definicja)

Każdy FIELD (definicja) element ma przyjazną nazwę, która jest opcjonalny, a nazwa odniesienia, która jest wymagana.Nazwa referencyjna musi być unikatowa w kolekcji.Aby uzyskać więcej informacji, zobacz Konwencje nazewnictwa dla elementu pracy śledzenia obiektów.

Ważne
Można zmienić przyjazną nazwę dla pola przy użyciu witadmin changefield narzędzie wiersza polecenia.Jednak w przypadku zmiany nazwy pola, dotyczy wszystkich typów elementów pracy we wszystkich projektach zespołu w zbiorze.

Należy zdefiniować pole przy użyciu następującej składni XML w pliku definicji dla typu elementu pracy.

<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="sum" >
   <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>

Aby uzyskać więcej informacji, zobacz Element pola (definicja).

Powrót do początku

Typy danych pól

Typ pola określa rodzaj i rozmiar danych, który można przechowywać w polu.Pole może mieć tylko jeden typ zdefiniowany w ramach Kolekcja projektów zespołu.Ograniczenie to zachęca organizacje wspólne pola służą w projektach i pracy typów elementów.

Na poniższej liście przedstawiono typy pól obsługiwanych:

Typ danych	Opis
DateTime	Określa datę zgodnie z uniwersalnym czasem koordynowanym (UTC) moment w czasie. Dodać DateTime pola do formularza elementu pracy przy użyciu formatu FieldControl lub DateTimeControltype atrybuty.
Double	Określa wartość zmiennoprzecinkowa.Podwójne pola są często używane w Kwerenda filtruje i wyniki list. Dodać Double pola do formularza elementu pracy przy użyciu FieldControltype atrybut.
GUID	Określa pola, która będzie zawierać identyfikator unikatowy. Nie można dodać GUID pola do formularza elementu pracy.
History	Obsługuje przeglądanie wątków dyskusji i śledzenia innych informacji historycznych. Uwaga System.History Pole jest jedynym polem, które wykorzystuje ten typ danych.Nie można zdefiniować przy użyciu tego typu danych pola niestandardowego. Dodać System.History pola do formularza elementu pracy przy użyciu WorkItemLogControltype atrybut, który obsługuje formanty w formacie tekstu sformatowanego.
HTML	Obsługuje możliwość do przechwytywania danych tekstu sformatowanego i używania dłuższe opisy tekstowe, takie jak opis elementu pracy.Polem HTML różni się od pola zwykłego tekstu, w tym polem HTML zdecydowanie jest wpisana w formacie HTML dla bogatsze wyświetla informacji. Dodać HTML pola do formularza elementu pracy przy użyciu HTMLControltype atrybut, który obsługuje formanty format tekstu sformatowanego.
Integer	Określa wartość 32-bitowa podpisana liczba całkowita.Pola liczb całkowitych są często stosowane w Kwerenda filtruje i wyniki list. Dodać Integer pola do formularza elementu pracy przy użyciu FieldControltype atrybut.
PlainText	Obsługuje zapis ciąg tekstowy, który może zawierać więcej niż 255 znaków Unicode. Dodać PlainText pola do formularza elementu pracy przy użyciu formatu FieldControl atrybut typu i ogranicza się do zwykłego tekstu, lub HTMLControltype atrybut, który obsługuje formanty w formacie tekstu sformatowanego.
String	Obsługuje zapis ciąg tekstowy, który może zawierać maksymalnie 255 znaków Unicode.Użyj pola String dla etykiety lub innych krótki ciąg tekstowy do pojedyncza linia.Pola są często stosowane w Kwerenda filtruje i wyniki list. Dodać String pola do formularza elementu pracy przy użyciu FieldControltype atrybut.
TreePath	Określa pole, które wyświetla wpisy w hierarchicznym lub struktury drzewa, takie jak wymagania, aby wyświetlić obszar i iteracji ścieżek dla produktu. Uwaga System.AreaPath i System.IterationPath pola to tylko pola, które ten typ danych.Nie można zdefiniować przy użyciu tego typu danych pola niestandardowego. Dodać System.AreaPath i System.IterationPath pól do obiektu budowlanego elementu formularza za pomocą WorkItemClassificationControl type atrybut.

Powrót do początku

Objętych obowiązkiem sprawozdawczym atrybuty, które są przypisane do pola

Niektóre wartości pól są szczególnie przydatne do raportowania.Za pomocą języka definicji typu elementu pracy, można określić następujące atrybuty opcjonalne:

• reportable.Atrybut objętego obowiązkiem sprawozdawczym na None, Detail, Dimension, lub Measure, w zależności od czy i jak chcesz, aby pole, które mają zostać uwzględnione w raportach.Dane z pól, które mają inne niż wartość None dla tego atrybutu są eksportowane do hurtowni danych i mogą być zawarte w raportach.

  Po dodaniu istniejącego pola do elementu pracy wpisz, bieżącą wartość dla reportable atrybut jest używany.Po dodaniu pola do typ pozycji roboczej Raportowanie jest wyłączone, o ile nie zostanie jawnie określone za pomocą reportable atrybut.

• reportingname.Przypisać inną etykietę pole, które jest używane, gdy dane są wyświetlane w raportach.Jeśli nie określisz wartości, przyjazną nazwę, która jest przypisana do name atrybut jest używany.

• reportingrefname.Przypisz nazwę różnych wzorcowych do pola, które jest używana, gdy dane są eksportowane do galerii w relacyjnej bazie danych.Jeśli nie określisz wartości, wartość, która jest przypisana do refname atrybut jest używany.

  Ten atrybut służy do korespondencji seryjnej 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 tych pól.Aby odbiegać dwa pola w tym taką samą nazwę odwołania, które zostały zdefiniowane w zbiorach innego projektu, należy przypisać inny reportingrefname do każdego pola.

Po zdefiniowaniu pola, można użyć witadmin changefield polecenie w wierszu polecenia do zmiany wartości wszystkich atrybutów, z wyjątkiem refname atrybut.

Aby uzyskać informacje na temat najlepszych praktyk w tworzenia etykiet pól na potrzeby sprawozdawczości, zobacz Dodawanie i modyfikowanie pól elementów pracy w celu obsługi raportowania.

Powrót do początku

Wartości atrybutów objętego obowiązkiem sprawozdawczym

Jak w poniższej tabeli opisano, można przypisać jedną z poniższych wartości: reportable atrybut: none, wymiar, szczegółowo i zmierzyć.

[!UWAGA]

Pola można wprowadzać objętego obowiązkiem sprawozdawczym, po to został użyty dla elementu pracy.Po ustawieniu wartości objętych obowiązkiem sprawozdawczym, nowe wersje elementu pracy, które są kopiowane do magazynu będzie zawierać wartość pola.Jednakże poprawki, znajdujących się już w magazynie nie będzie wypełniającego z istniejących wartości.

Wartość atrybutu	Opis
Detail	Użycie Detail typu tylko w przypadku pól typu Liczba całkowita, Double, ciąg znaków lub data/godzina. Dane w tym polu jest przenoszony do magazynu relacyjnej bazy danych w tabelach bieżącego elementu pracy i pozycją roboczą, ale nie do SQL Server moduł usług analiz.Za pomocą tego typu pola tekstowe bez ograniczeń, mogą być użyte w raportach bez dokonywania moduł znacznie większy.
Dimension	Użycie Dimension typu tylko w przypadku pól typu Liczba całkowita, Double, ciąg znaków lub data/godzina. Dane w tym polu wprowadza magazynu relacyjnej bazy danych i moduł Analysis Services jako atrybut wymiaru elementu pracy tak, że dane mogą być używane do filtrowania raportów.Użyj tego typu dla pól, które mają list prawidłowych wartości.Typ pozycji roboczej i Państwo są dobrym przykładem wymiaru.
Measure	Użycie Measure typu tylko w stosunku do pola Liczba całkowita i podwójne.Środki są wartościami numerycznymi w raportach. Podczas przetwarzania moduł Analysis Services, dane są wstępnie obliczane na polach, które są ustawione na Measure.Na przykład, element pracy i bieżący element pracy grup miar zawierają skumulowane dane w następujących polach: oryginalnego oszacowania, pozostałe godziny i godziny ukończone.Aby uzyskać więcej informacji o grupach miar, zobacz Perspektywy i grupy pomiarowe udostępniane w Analysis Services Cube dla systemu zespołowego. Po określeniu Measure, należy określić sum dla formula atrybut, który zwraca sumę każdego środka, do których odwołuje się w kwerendzie.
None	Określ None gdy nie chce uwzględnić pole w raportach.Ta wartość jest przydział domyślny.

Powrót do początku

Przykłady pokazano, jak określić, raportowanie

Przykład szczegółów

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

Przykład wymiaru

<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">

Przykład miary

<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">

Pola indeksowane

Można włączyć lub wyłączyć indeksowanie dla pola elementu pracy przy użyciu witadmin indexfield polecenia.Po włączeniu, indeksowanie dla pola, może zwiększyć wydajność znajdowanie elementów pracy, w których kwerendy określenie tego pola.Jeśli dodasz pole niestandardowe używane w wielu kwerend elementu pracy, można włączyć indeksowanie dla tego pola.Aby uzyskać więcej informacji, zobacz Zarządzanie polami elementów pracy [witadmin].

Powrót do początku

Elementy podrzędne pola (definicja)

Istnieje wiele elementów podrzędnych opcjonalne, które mogą być określone dla pola elementu pracy, na przykład:

• Tekst pomocy.Definiuje informacje porady lub pomocy narzędzia że wyświetla dla pola na podstawie prac pozycja formularz (HELPTEXT).

• W polu ograniczenia.Określa pole, zgodnie z wymaganiami, tylko do odczytu, pusty, mrożone lub pasujące do określonego wzorca (REQUIRED, READONLY, EMPTY, FROZEN, MATCH).

• W polu wartość auto populacji.Określa wartość dla pola (DEFAULT, COPY, SERVERDEFAULT).

• W polu listy.Określa wartości dopuszczalne, sugerowane lub zabronione.(ALLOWEDVALUES, SUGGESTEDVALUES, PROHIBITEDVALUES)

• W polu warunków.Dotyczy jednej lub kilku reguł z polem, gdy zmiany innego pola lub nie zmienione lub innego pola ma lub nie ma określonej wartości lub inne warunki (WHEN, WHENNOT, WHENCHANGED, WHENNOTCHANGED, CANNOTLOSEVALUE, NOTSAMEAS).

Aby uzyskać więcej informacji, zobacz Wszystkie odniesienia do elementów XML pola.

Powrót do początku

System i wstępnie zdefiniowanych pól

Wszystkie pola zdefiniowanych w systemie mają nazwy odwołanie, które rozpoczyna się od systemu, na przykład, System.AreaPath, System.AssignedTo i nadal w ten deseń.

Wstępnie zdefiniowanych pól zdefiniowane przez domyślnych szablonów procesów, które zapewnia TFS zacząć od Microsoft.VSTS, a następnie dalej zależeć ich użytkowania.Przykłady wstępnie zdefiniowanych pól, które są używane wspólnie, w przypadku planowania celów oraz integrację z Microsoft Project, do integracji z Team Foundation Buildoraz integrację z Team Foundation są następujące:

• Microsoft.VSTS.Common.Priority

• Microsoft.VSTS.Scheduling.DueDate

• Microsoft.VSTS.Build.FoundIn

• Microsoft.VSTS.TCM.Steps

Aby uzyskać omówienie wszystkich systemu i wstępnie zdefiniowanych pól, które są zdefiniowane dla domyślnych szablonów procesów, które zapewnia TFS, zobacz Odwołania pola elementu pracy dla Visual Studio ALM.Aby uzyskać więcej informacji na temat określania nazw pól, zobacz Konwencje nazewnictwa dla elementu pracy śledzenia obiektów.

Powrót do początku

Atrybuty ukryte i nie można zmienić i Explorer pole elementu pracy

Oprócz atrybutów, które mogą być zmieniane dla pola elementu pracy istnieje kilka atrybutów nie można zmienić, jak i praktycznie ukryte dla każdego pola.Można wyszukiwać przypisania tych pól za pomocą narzędzia Eksploratora pól elementu pracy.Dostęp do narzędzia Eksploratora pól element pracy z narzędzie Edytor procesu power tool.

Element roboczy Eksploratora pól

[!UWAGA]

Narzędzie power Edytor procesu udostępnia graficzny interfejs użytkownika dostosowywania szablonów procesów Team Foundation Server.Narzędzie to służy do importowania i eksportowania typów elementów pracy, modyfikować zawartość szablonu procesu oraz zbadać zestaw pól zdefiniowanych dla Kolekcja projektów zespołu.Aby uzyskać więcej informacji, zobacz następującą stronę w witrynie firmy Microsoft: Team Foundation Server narzędzia.

Zobacz też

Informacje

Zarządzanie polami elementów pracy [witadmin]

Koncepcje

Dostosowywanie śledzenia elementów pracy oraz projektu zespołowego

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

Wszystkie odniesienia do elementów XML pola

Inne zasoby

Definiowanie pól elementu pracy