Element FIELD (Definition) — Odwołanie
Możesz użyć FIELD elementu (definicja) do definiowania pola elementów roboczych i określ reguły i warunki mające zastosowanie do niego. Atrybuty, które można przypisać do pola określa typ danych i określa, czy jest dostępny do włączenia w raportach.
Uwaga
Aby uzyskać informacje na temat FIELD element (przepływu pracy), który służy do określania zasad i warunków do pól podczas przejścia stanu zmiany lub przepływu, zobacz Dokumentacja elementu FIELD (Workflow).
Schemat hierarchii
FIELD
<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 |
Parametr wymagany. Przyjazna nazwa pola, które jest wyświetlany w menu rozwijane kwerend elementu pracy. Przyjazna nazwa musi być unikatowa we wszystkich pól, które są zdefiniowane w ramach projektu zespołowego. Ponadto przyjazna nazwa może różnić się od etykiety, który pojawi się obok pola formularza elementu pracy. Aby uzyskać więcej informacji, zobacz Element formantu XML — Odwołanie. Typ atrybutu typelib:FieldName. Minimalna długość: 1; Maksymalna długość: 128. Wartość do wzorca: ^ [^ \. \[\]]+$ Przykład wartość wzorzec: przypisane do |
refname |
Parametr wymagany. Etykieta unikatowy odróżniająca pola z wszystkich pól, które są zdefiniowane w kolekcji projektów zespołowych. Dodatkowe wymagania i ograniczenia przyjaznych nazw i odwołania, zobacz Konwencje nazewnictwa dla elementu pracy śledzenia obiektów. Typ atrybutu typelib:ReferenceFieldName. Minimalna długość: 1; Maksymalna długość: 70. Wartość do wzorca: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [ a-zA-Z0-9_] +) + $ Wzorzec wartość przykład: Company.IssueType |
type |
Parametr wymagany. Określa typ danych, który akceptuje pole. .jpeg "Uwaga") Uwaga
Pola w różnych projektu kolekcje, które mają taki sam reportingrefname musi zostać przypisane taką samą wartość type.Jeśli są różne wartości, konflikty danych może wystąpić, gdy są przetwarzane w magazynie 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 chwili uniwersalny czas koordynowany (UTC) w czasie.
Double Określa wartość zmiennoprzecinkowa.
GUID Określa pole, które zawiera unikatowy identyfikator.
History
Obsługuje wątków dyskusji i przechowuje informacje o innych informacji historycznych.
Uwaga
System.History Pole jest tylko pole, które używa tego typu danych.Nie można zdefiniować pola niestandardowe przy użyciu tego typu danych.
HTML Obsługuje przechwytywanie danych tekstu sformatowanego, umożliwia dłuższy opis tekstu, takich jak opis elementu pracy.
Integer Określa wartość 32-bitowa wartość całkowita ze znakiem.
PlainText Obsługuje zapis ciągu tekstowego, który może zawierać więcej niż 255 znaków Unicode.
String Obsługuje zapis ciągu tekstowego, który może zawierać więcej niż 255 znaków Unicode.Użyj pola ciągu dla etykietę lub innych krótki ciąg tekstowy maksymalnie jeden wiersz długi.
TreePath
Określa pole, które wyświetla wpisy w to hierarchiczna lub struktura drzewa, takich jak co to jest wymagane do wyświetlenia ścieżek obszaru i iterację dla produktu.Aby zdefiniować węzłów podrzędnych, zobacz Dodawanie i modyfikowanie obszaru i ścieżek iteracji.
Uwaga
System.AreaPath i System.IterationPath pola są tylko pola, które używają tego typu danych.Nie można zdefiniować pola niestandardowe przy użyciu tego typu danych.
|
syncnamechanges |
Parametr opcjonalny. Określa, czy pole elementu pracy jest używany do przechowywania nazw, które można zaktualizować zmiany w usłudze Active Directory lub grupy roboczej. Ta opcja jest prawidłowa tylko podczas type="String". Typ atrybutu xs:boolean. Określ true Włącz synchronizację dla pola danych, ustaw false Aby wyłączyć synchronizację dla pola danych. |
reportable |
Parametr opcjonalny. Określa, czy dane z pola są dostępne do włączenia w raportach. Pola z wartością domyślną None nie są eksportowane w magazynie danych relacyjnych ani przetwarzania dla SQL Server modułu usług Analysis Services. Aby uzyskać więcej informacji na temat zgłoszeniu pól, zobacz Dodawanie i modyfikowanie pól elementów roboczych w celu obsługi raportowania. Uwaga
Kolekcje, które mają tę samą wartość dla projektu pola w różnych reportingrefname musi zostać przypisane taką samą wartość reportable.Jeśli są różne wartości, konflikty danych może wystąpić, gdy są przetwarzane w magazynie 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 pola typu Data/Godzina, Podwójna, liczba całkowita lub ciąg. Dane w tym polu zostanie przeniesiona do magazynu relacyjnej bazy danych w tabelach elementu roboczego i bieżącego elementu roboczego, ale nie do modułu usług Analysis Services.Ten typ jest to dobry wybór w przypadku pól tekstowych bez ograniczeń, ponieważ używane w raportach bez wprowadzania modułu znacznie większej.
Dimension Można określić dla pola typu Data/Godzina, liczba całkowita, ciąg lub TreePath. Dane w tym polu przechodzi magazynu relacyjnej bazy danych i modułu usług Analysis Services, tak aby danych może być używana do filtrowania raportów atrybut wymiaru elementu roboczego.Użyj tego typu dla pola, które zawierają listę prawidłowych wartości.Typu elementu roboczego i stanu są dobre przykłady wymiaru.
Measure Typ miary służy tylko w przypadku liczb całkowitych i podwójne pól.Środki są wartości numeryczne w raportach.Podczas przetwarzania modułu usług Analysis Services, dane są wstępnie obliczane na pola którego reportable atrybuty są ustawione do pomiaru.Na przykład grup miar elementu roboczego i bieżący element pracy zawiera dane w następujących polach: pierwotne oszacowanie, pozostałe godziny i ukończyć godzin.Po określeniu miary, należy określić formula atrybutu.
None Określ None Jeśli nie chcesz użyć pole do włączenia w raportach.Jest to przypisanie domyślnego.
|
formula |
Parametr opcjonalny. Typ agregacji dla measure zgłoszeniu typu. Jedyne prawidłowe wartości to sum, która zwraca sumę wszystkich wartości w zestawie. |
reportingname |
Parametr opcjonalny. Określa nazwę, która jest wyświetlany w raportach. Jeśli nie określisz wartość wartość, która jest przypisana do name zostanie użyty atrybut. Uwaga
Pola w różnych projektu kolekcje, które mają taki sam reportingrefname musi zostać przypisane taką samą wartość reportingname.Jeśli są różne wartości, konflikty danych może wystąpić, gdy są przetwarzane w magazynie danych.Aby uzyskać więcej informacji, zobacz Rozwiązywanie konfliktów dotyczących schematów, które pojawiają się w magazynie danych.
Typ atrybutu typelib:FieldName. Minimalna długość: 1; Maksymalna długość: 128. Wartość do wzorca: ^ [^ \. \[\]]+$ Przykład wartość wzorzec: przypisane do |
reportingrefname |
Parametr opcjonalny. Określa nazwę odwołania, która jest używany podczas przetwarzania zgłoszeniu pola. Jeśli nie określisz wartość wartość, która jest przypisana do refname zostanie użyty atrybut. Ten atrybut służy do scalania albo różni się pola, które są przetwarzane w magazynie danych. Można scalić dwa pola, w tym odwołania unikatowych nazw, które zostały zdefiniowane w kolekcjach innego projektu, przypisać taki sam reportingrefname obu tych dokumentów. Aby między dwa pola, które mają taką samą nazwę odwołania, ale które zostały zdefiniowane w kolekcjach innego projektu, można przypisać inną reportingrefname do każdego pola. Należy scalić pola, o ile to możliwe, aby ograniczyć liczbę pól w magazynie i dokonywanie maksymalny limit 1024 zgłoszeniu pól. Można generować raporty cross grupy z scalonych pól. Typ atrybutu typelib:ReferenceFieldName. Minimalna długość: 1; Maksymalna długość: 70. Wartość do wzorca: ^[a-zA-Z_][a-zA-Z0-9_]* (\. [ a-zA-Z0-9_] +) + $ Wzorzec wartość przykład: Company.IssueType |
Elementy podrzędne
Element |
Opis |
|---|---|
Parametr opcjonalny. Definiuje listę dozwolonych wartości dla pola. Dozwolone wartości to wartości, które są dostępne do wybrania listy pól w formularzach elementów roboczych i w Konstruktorze kwerend. Należy wybrać jeden z tych wartości. |
|
Parametr opcjonalny. Określa to pole, aby umożliwić istniejące wartości. Ten element umożliwia wartości pola, które już istnieją mają być używane, nawet jeśli nie są prawidłowe. Wszystkie nowe wartości pól muszą być prawidłowe. |
|
Parametr opcjonalny. Określa pola nie może utracić wartość. Ten element przechowuje bieżącą wartość pola i nie można wyczyścić ani wprowadzone puste. |
|
Parametr opcjonalny. Określa innego pola, które zawiera wartość można skopiować do bieżącego pola. |
|
Parametr opcjonalny. Definiuje wartości domyślnej dla pola. |
|
Parametr opcjonalny. Definiuje pole puste. |
|
Parametr opcjonalny. Określa to pole jako zablokowany. Nie można zmienić pola zablokowane niepustej wartości, po zmian. Można jednak ręcznie wyczyść pole, Zapisz element roboczy, a następnie określ inną wartość. |
|
Parametr opcjonalny. Określa tekst wyświetlany w etykietkę narzędzia dla pola. |
|
Parametr opcjonalny. Definiuje wzorzec pola, którego wartość pola muszą być zgodne. |
|
Parametr opcjonalny. Określa inne pole, którego wartość nie może być taka sama, jak wartość bieżącego pola. |
|
Parametr opcjonalny. Definiuje listę wartości zabronione dla pola. |
|
Parametr opcjonalny. Określa to pole jako tylko do odczytu. |
|
Parametr opcjonalny. Definiuje pole zgodnie z potrzebami. |
|
Parametr opcjonalny. Określa, które będą wartość dla pola składnika serwera. |
|
Parametr opcjonalny. Definiuje listę sugerowanych wartości dla pola. Sugerowane wartości to wartości, które są dostępne do wybrania listy pól w formularzach elementów roboczych i w Konstruktorze kwerend. Ponadto inne wartości można wprowadzić te na liście. |
|
Parametr opcjonalny. Określa, że na liście dozwolonych wartości musi składać się tylko z prawidłowym użytkowników systemu. |
|
Parametr opcjonalny. Określa co najmniej jedną regułę do zastosowany do bieżącego pola inne pole ma określoną wartość. |
|
Parametr opcjonalny. Stosuje co najmniej jedną regułę do bieżącego pola, gdy wartość określonego pola zostanie zmieniona. |
|
Parametr opcjonalny. Stosuje co najmniej jedną regułę do bieżącego pola, gdy inne pole nie ma określonej wartości. |
|
Parametr opcjonalny. Stosuje co najmniej jedną regułę do bieżącego pola, gdy wartość określonego pola pozostają niezmienione. |
Elementy nadrzędne
Element |
Opis |
|---|---|
Parametr wymagany. Zawiera definicje pola typu elementu roboczego. |
Uwagi
FIELD (Definicja) jest wymagany element podrzędny elementu FIELDS (definicja).
Aby zapoznać się z omówieniem wszystkich pól wstępnie zdefiniowanych, zdefiniowane dla TFS szablony procesów i systemu, zobacz Odwołania pola elementu pracy dla Visual Studio ALM.
Nie można zdefiniować pole niestandardowe, który rozpoczyna się od System. prefiksu. Pola można zdefiniować przy użyciu Microsoft. prefiksu, jednak ta praktyki jest zalecane, ponieważ może ona utrudniać Team Foundation Server funkcji.
Dodatkowe wymagania i ograniczenia pola przyjaznych nazw i odwołania, zobacz Konwencje nazewnictwa dla elementu pracy śledzenia obiektów.
Gdy można zmienić przyjazną nazwę pola, nie można zmienić nazwy pola nazwy odwołania. Można wyświetlić listę pól i zmienić za pomocą kilku atrybuty pól witadmin wiersza polecenia toolSee Zarządzanie polami elementów pracy [witadmin].
W tej samej kolekcji projektów zespołowych można zdefiniować pola elementów roboczych nie więcej niż 1024, a nie więcej niż 1024 pola można ustawić na zgłoszeniu w wszystkich zbiorów projektu zespołowego.
Wszystkie pola zdefiniowane w obrębie wszystkich elementów typów prac (WITs) dla wszystkich projektów zespołowych zdefiniowane dla kolekcji projektów są dla kolekcji projektów zespołowych. W związku z tym atrybuty, które można przypisać do pola, które są definiowane w jednym ZEZWÓ musi być zgodny we wszystkich WITs dla wszystkich projektów zespołowych w kolekcji. Ponadto wszystkie pola zgłoszeniu ze wszystkich kolekcji zostaną wyeksportowane do bazy danych magazynu danych.
Informacje na temat do pól etykiety na potrzeby raportowania, zobacz Dodawanie i modyfikowanie pól elementów roboczych w celu obsługi raportowania.
Po dodaniu istniejącego pola do różnych ZEZWÓ, albo jawnie ustaw atrybuty raportowania jest taki sam, jak bieżący definicji pola lub będą oni mogli domyślne te wartości.
Konflikty schematu może wystąpić, jeśli odmienne atrybuty raportowania są przypisane do tego samego pola w różnych WITs lub tej samej WITs w projektów zespołowych różnych. Aby rozwiązać te konflikty, zobacz Rozwiązywanie konfliktów dotyczących schematów, które pojawiają się w magazynie danych.
Aby dowiedzieć się, jak pola są używane do obsługi kwerend, raportów i śledzenie elementów pracy, zobacz Modyfikowanie lub dodawanie pola do obsługi zapytań, raportów i przepływu pracy.
Omówienie sposobu stosowania ograniczenia lub warunki na FIELD przy użyciu elementów podrzędnych, zobacz Zastosowanie reguły do pola elementu roboczego.
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
Dostosowywanie obiektów śledzenia elementów pracy, aby wspierać procesy zespołu
Definiowanie i modyfikowanie pól elementu roboczego