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 należy określić sposób wyświetlania w postaci elementów roboczych i czy jest dostępny do włączenia w raportach.Można zarządzać zestaw pól przydziałów dla kolekcji projektów zespołowych.W związku z tym atrybuty, które można przypisać do pola, które są definiowane w jeden typ elementu roboczego musi być zgodny we wszystkich typów elementów roboczych dla wszystkich projektów zespołowych w kolekcji.Ponadto wszystkie pola zgłoszeniu ze wszystkich kolekcji zostaną wyeksportowane do bazy danych magazynu danych.
[!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 Element FIELD (Workflow).
Można zmienić przypisania atrybutu, wprowadzane w istniejących pól dla kolekcji przy użyciu witadmin narzędzia polecenia.Aby uzyskać więcej informacji, zobacz Zarządzanie polami elementów pracy [witadmin].
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.
Poniższa tabela zawiera listę prawidłowych wartości dla tego atrybutu:
|
||||||||||||||||||||
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.
Poniższa tabela zawiera listę prawidłowych wartości dla tego atrybutu:
|
||||||||||||||||||||
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 jest używany atrybut.
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 jest używany 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 wymaganego elementu podrzędnego z FIELDS (definicja).
minOccurs = "1"
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.Aby uzyskać więcej informacji, zobacz Dodawanie i modyfikowanie pól elementów roboczych w celu obsługi raportowania.
[!UWAGA]
Po dodaniu istniejącego pola do innego typu elementu roboczego, są używane bieżące wartości atrybutów zgłoszeniu.
Dodatkowe wymagania i ograniczenia pola przyjaznych nazw i odwołania, zobacz Konwencje nazewnictwa dla elementu pracy śledzenia obiektów.Informacje na temat etykietę pola do raportowania, zobacz Dodawanie i modyfikowanie pól elementów roboczych w celu obsługi raportowania.
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.
Przegląd obiektu śledzenia elementów pracy pole, można znaleźć Definiowanie i modyfikowanie pól elementu roboczego.
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 zmienić nazwy odwołania pól.Pola listy, Zmień nazwę pola przyjazną nazwę i zmienić atrybuty pól przy użyciu witadmin narzędzia wiersza polecenia.Aby uzyskać więcej informacji, zobacz Zarządzanie polami elementów pracy [witadmin].
Dla informacji na temat używania pól w kolekcjach projektu zespołowego, zobacz Rozwiązywanie konfliktów dotyczących schematów, które pojawiają się w magazynie danych i Dodawanie i modyfikowanie pól elementów roboczych 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
Dostosowywanie obiektów śledzenia elementów pracy, aby wspierać procesy zespołu
Definiowanie i modyfikowanie pól elementu roboczego