Element pola (definicja)
Możesz użyć FIELD element (definicja), aby zdefiniować pole elementu pracy i określić zasady i warunki, które go dotyczą.Atrybuty, które można przypisać do pola określają, jak wygląda w formularza elementu pracy i czy jest dostępne do dołączenia w raportach.Zestaw pól przydziałów dla Kolekcja projektów zespołu można zarządzać.W związku z tym atrybuty, które można przypisać do pól, które są zdefiniowane w jednym typie elementu pracy muszą być zgodne dla wszystkich typów elementów roboczych dla wszystkich projektów zespołu w kolekcji.Dodatkowo wszystkie pola objętego obowiązkiem sprawozdawczym, ze wszystkich kolekcji są eksportowane do baz danych z magazynu danych.
[!UWAGA]
Aby uzyskać informacje o FIELD (przepływ pracy) element, który używasz, aby określić zasady i warunki do pól podczas przejście stanu zmiany lub przepływu pracy, zobacz Element pola (przepływ pracy).
Można zmienić przypisywania atrybutów, składające się z istniejącymi polami dla zbioru za pomocą witadmin narzędzia polecenia.Aby uzyskać więcej informacji, zobacz Zarządzanie polami elementów pracy [witadmin].
Hierarchii schematów
FIELD
<xs:element name="FIELD" type="FieldDefinition" maxOccurs="unbounded"/>
<FIELD name="fieldDisplayName" refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID" syncnamechanges ="true | false" reportable="Dimension | Detail | Measure" formula="sum" reportingname="ReportingDisplayName" reportingrefname="ReportingReferenceName" >
<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>
Atrybuty i elementy
W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.
Atrybuty
Atrybut |
Opis |
|---|---|
name |
Wymagane.Przyjazna nazwa pola, które pojawia się w menu rozwijanych kwerend elementu pracy.Przyjazna nazwa musi być unikatowa we wszystkich dziedzinach, które są zdefiniowane w ramach projektu zespołu.Ponadto przyjazną nazwę mogą się różnić od etykietę, która pojawia się obok pola formularza elementu pracy.Aby uzyskać więcej informacji, zobacz Odwołanie Element XML kontroli. Typ atrybutu jest typelib:FieldName.Minimalna długość: 1; Maksymalna długość: 128. Wzór wartość: ^ [^ \.\[\]]+$ Przykład wartość wzór: przypisane do |
refname |
Wymagane.Unikatową etykietę, która odróżnia pola z innych pól, które są zdefiniowane w Kolekcja projektów zespołu. Dodatkowe wymagania i ograniczenia przyjazne nazwy oraz nazwy odniesień, zobacz Konwencje nazewnictwa dla elementu pracy śledzenia obiektów. Typ atrybutu jest typelib:ReferenceFieldName.Minimalna długość: 1; Maksymalna długość: 70. Wzór wartość: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [a-zA-Z0-9_] +) +$ Wzór wartość przykład: Company.IssueType |
type |
Wymagane.Określa typ danych, która akceptuje pole. .gif "Uwaga") Uwaga
Pola w różnych projektu kolekcje, które mają taką samą reportingrefname musi być przypisany taką samą wartość type.Jeśli są różne wartości, może wystąpić konflikt danych, podczas przetwarzania hurtowni danych.Aby uzyskać więcej informacji, zobacz Rozwiązywanie konfliktów dotyczących schematów, które pojawiają się w magazynie danych.
Poniższa tabela zawiera listę prawidłowych wartości dla tego atrybutu:
WartośćUżycie
DateTime Określa datę zgodnie z uniwersalnym czasem koordynowanym (UTC) moment w czasie.
Double Określa wartość zmiennoprzecinkowa.
GUID Określa pola, która będzie zawierać identyfikator unikatowy.
History
Obsługuje wątki dyskusji i śledzi 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.
HTML Obsługuje przechwytywanie danych tekstu sformatowanego i jest używany do dłużej opisy tekstowe, takie jak opis elementu pracy.
Integer Określa wartość 32-bitowa podpisana liczba całkowita.
PlainText Obsługuje zapis ciąg tekstowy, który może zawierać więcej niż 255 znaków Unicode.
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.
TreePath
Określa pole, które wyświetla wpisy w hierarchicznym lub struktura drzewa, co jest potrzebne do wyświetlania ścieżki obszaru i iteracji dla produktu.Aby zdefiniować węzły podrzędne, zobacz Tworzenie i modyfikowanie obszarów i iteracje.
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.
|
syncnamechanges |
Opcjonalne.Określa, czy pole elementu Praca jest używany do przechowywania nazw, które mają być aktualizowane, zmiany w usłudze Active Directory lub grupy roboczej.Ta opcja jest ważny pod type="String".Typ atrybutu jest xs:boolean. Określ true Aby włączyć synchronizację dla pola danych, należy określić false Aby wyłączyć synchronizację dla pola danych. |
reportable |
Opcjonalne.Określa, czy dane z tego pola jest dostępne do dołączenia w raportach.Pola z wartością domyślną None nie są eksportowane do relacyjnej magazyn danych ani przetwarzane dla SQL Server moduł usług analiz.Aby uzyskać więcej informacji o polach objętych obowiązkiem sprawozdawczym, zobacz Dodawanie i modyfikowanie pól elementów pracy w celu obsługi raportowania. Uwaga
Pola w różnych projektu kolekcje, które mają taką samą wartość reportingrefname musi być przypisany taką samą wartość reportable.Jeśli są różne wartości, może wystąpić konflikt danych, podczas przetwarzania hurtowni danych.Aby uzyskać więcej informacji, zobacz Rozwiązywanie konfliktów dotyczących schematów, które pojawiają się w magazynie danych.
Poniższa tabela zawiera listę prawidłowych wartości dla tego atrybutu:
Value Użycie
Detail Można określić dla pól typu Data/Godzina, Podwójna precyzja, liczba całkowita lub ciąg. Dane w tym polu jest przenoszony do bazy danych relacyjnych magazynu w tabelach element pracy i bieżący element pracy, ale nie w module usług Analysis Services.Ten typ jest dobrym wyborem w przypadku pól tekstowych bez ograniczeń, ponieważ mogą być użyte w raportach bez dokonywania moduł znacznie większy.
Dimension Można określić dla pól typu Data/Godzina, Podwójna precyzja, liczba całkowita lub ciąg. 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 Typ miary służy tylko do liczby całkowitej i podwójne pól.Środki są wartościami numerycznymi w raportach.Podczas przetwarzania moduł Analysis Services, dane są wstępnie obliczane na polach którego reportable atrybuty są ustawione do pomiaru.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.Po określeniu miary, należy określić formula atrybut.
None Określ None kiedy nie chcesz używać pola do włączenia w raportach.To jest przydział domyślny.
|
formula |
Opcjonalne.Typ agregacji dla measure typu objętego obowiązkiem sprawozdawczym.Tylko prawidłowe wartości to sum, która zwraca sumę wszystkich wartości przez zestaw. |
reportingname |
Opcjonalne.Określa nazwę, która jest wyświetlana w raportach.Jeśli nie określisz wartości, wartość, która jest przypisana do name atrybut jest używany. Uwaga
Pola w różnych projektu kolekcje, które mają taką samą reportingrefname musi być przypisany taką samą wartość reportingname.Jeśli są różne wartości, może wystąpić konflikt danych, podczas przetwarzania hurtowni danych.Aby uzyskać więcej informacji, zobacz Rozwiązywanie konfliktów dotyczących schematów, które pojawiają się w magazynie danych.
Typ atrybutu jest typelib:FieldName.Minimalna długość: 1; Maksymalna długość: 128. Wzór wartość: ^ [^ \.\[\]]+$ Przykład wartość wzór: przypisane do |
reportingrefname |
Opcjonalne.Określa nazwę odwołania, który jest używany podczas przetwarzania pola objętego obowiązkiem sprawozdawczym.Jeśli nie określisz 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 są przetwarzane w celu hurtowni danych.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 się z nimi.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. Typ atrybutu jest typelib:ReferenceFieldName.Minimalna długość: 1; Maksymalna długość: 70. Wzór wartość: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [a-zA-Z0-9_] +) +$ Wzór wartość przykład: Company.IssueType |
Elementy podrzędne
Element |
Opis |
|---|---|
Opcjonalne.Określa listę dozwolonych wartości dla pola.Wartości dopuszczalne są wartości, które są dostępne do wybrania liście pól w formularzach elementu pracy i w Konstruktorze kwerend.Należy wybrać z jedną z następujących wartości. |
|
Opcjonalne.Określa pole, aby zezwolić na wartości istniejących.Ten element pozwala wartości pól, które już istnieją mają być stosowane, nawet jeśli nie są prawidłowe.Wszystkie nowe wartości pól muszą być prawidłowe. |
|
Opcjonalne.Określa to pole nie może stracić wartość.Ten element przechowuje bieżącą wartość pola i nie może być czyszczony ani opróżnione. |
|
Opcjonalne.Określa innego pola, które zawiera wartości, które będą skopiowane do bieżącego pola. |
|
Opcjonalne.Określa wartość domyślną dla pola. |
|
Opcjonalne.Definiuje pole jako pusty. |
|
Opcjonalne.Określa to pole jako zablokowany.Nie można zmienić pola mrożonych dowolną wartość nie jest pusta, po zmiany są przekazywane.Można jednak ręcznie wyczyścić pole, Zapisz element pracy, a następnie określ inną wartość. |
|
Opcjonalne.Określa tekst wyświetlany w etykietce narzędzia dla pola. |
|
Opcjonalne.Definiuje wzorzec pola, które musi odpowiadać wartości pola. |
|
Opcjonalne.Określa innego pola, których wartość nie może być identyczna z wartością bieżącego pola. |
|
Opcjonalne.Definiuje lista zabronionych wartości dla pola. |
|
Opcjonalne.Określa to pole jako tylko do odczytu. |
|
Opcjonalne.Określa to pole jako wymagane. |
|
Opcjonalne.Określa składnik serwera, który zapewni wartość dla pola. |
|
Opcjonalne.Określa listę sugerowanych wartości dla pola.Sugerowane wartości są wartości, które są dostępne do wybrania liście pól w formularzach elementu pracy i w Konstruktorze kwerend.Można wprowadzić inne wartości dodatkowo do tych, na liście. |
|
Opcjonalne.Określa, że wykaz dozwolonych wartości musi składać się tylko z prawidłowymi użytkownikami systemu. |
|
Opcjonalne.Określa jedną lub więcej reguł, aby zastosować do bieżącego pola, gdy kolejne pole ma określoną wartość. |
|
Opcjonalne.Dotyczy jednej lub kilku reguł w bieżącym polu wartość określonego pola zostanie zmieniona. |
|
Opcjonalne.Dotyczy jednej lub kilku reguł w bieżącym polu innego pola nie ma określonej wartości. |
|
Opcjonalne.Dotyczy jednej lub kilku reguł w bieżącym polu wartość określonego pola nie zostanie zmieniona. |
Elementy nadrzędne
Element |
Opis |
|---|---|
Wymagane.Zawiera definicje pól Typ elementu pracy. |
Uwagi
FIELD(Definicja) jest elementem podrzędnym wymagane FIELDS (definicja).
minOccurs = "1"
W tym samym Kolekcja projektów zespołu można zdefiniować pola elementu pracy nie więcej niż 1024, a można zdefiniować nie więcej niż 1 024 pola do objętych obowiązkiem sprawozdawczym w wszystkie kolekcje projektu zespołu.Aby uzyskać więcej informacji, zobacz Dodawanie i modyfikowanie pól elementów pracy w celu obsługi raportowania.
[!UWAGA]
Po dodaniu istniejącego pola na inny typ pozycji roboczej, są używane bieżące wartości atrybutów objętego obowiązkiem sprawozdawczym.
Dodatkowe wymagania i ograniczenia dotyczące nazw przyjaznych dla pola i odniesienia, zobacz Konwencje nazewnictwa dla elementu pracy śledzenia obiektów.Aby uzyskać informacje na temat umieścić etykietę pola na potrzeby sprawozdawczości, zobacz Dodawanie i modyfikowanie pól elementów pracy w celu obsługi raportowania.
Nie można zdefiniować pola niestandardowego, który rozpoczyna się od System. prefiksu.Pola można zdefiniować przy użyciu Microsoft. prefiks, jednak praktyka ta jest zdecydowanie niewskazane, ponieważ mogłyby utrudniać Team Foundation Server funkcjonalność.
Omówienie obiektu śledzenia elementu pracy pola, zobacz Praca z polami elementu pracy.
Aby uzyskać omówienie wszystkich systemu i wstępnie zdefiniowane pola, które są zdefiniowane dla Framework rozwiązań firmy Microsoft (MSF) dla Agile Software Development v5.0 proces szablonu, zobacz Odwołania pola elementu pracy dla Visual Studio ALM.
Nie można zmienić nazwy pól odwołanie.Można wyświetlić listę pól, zmienić nazwę pola przyjazną nazwę i zmienić atrybuty pól przy użyciu witadmin narzędzie wiersza polecenia.Aby uzyskać więcej informacji, zobacz Zarządzanie polami elementów pracy [witadmin].
Aby uzyskać informacje na temat używania pól całej kolekcji projektu zespołu, zobacz Rozwiązywanie konfliktów dotyczących schematów, które pojawiają się w magazynie danych i Dodawanie i modyfikowanie pól elementów pracy w celu obsługi raportowania.
Przykład
<FIELD name="Activity" refname="Microsoft.VSTS.Common.Activity" type="String" reportable="dimension">
<HELPTEXT>Type of work involved</HELPTEXT>
<SUGGESTEDVALUES>
<LISTITEM value="Development"/>
<LISTITEM value="Testing"/>
<LISTITEM value="Requirements"/>
<LISTITEM value="Design"/>
<LISTITEM value="Deployment"/>
<LISTITEM value="Documentation"/>
</SUGGESTEDVALUES>
</FIELD>
Zobacz też
Informacje
Zarządzanie polami elementów pracy [witadmin]
Koncepcje
Konwencje nazewnictwa dla elementu pracy śledzenia obiektów
Odwołania pola elementu pracy dla Visual Studio ALM
Dostosowanie danych śledzenia projektu, formularzy, przepływu pracy i innych obiektów