FIELD (Definition)-Elementverweis
Sie verwenden das FIELD (Definition)-Element, um ein Arbeitsaufgabenfeld zu definieren und die dafür geltenden Regeln und Bedingungen anzugeben. Die Attribute, die Sie einem Feld zuweisen, bestimmen dessen Datentyp und ob es für die Aufnahme in Berichte verfügbar ist.
Hinweis
Informationen zum FIELD (Workflow)-Element, mit dem Sie Regeln und Bedingungen für Felder während einer Zustandsänderung oder eines Workflowübergangs angeben, finden Sie unter FIELD (Workflow)-Element.
Schemahierarchie
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>
Attribute und Elemente
In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.
Attribute
Attribut |
Beschreibung |
||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
name |
Erforderlich. Der Anzeigename des Felds, der in den Dropdownmenüs von Arbeitsaufgabenabfragen angezeigt wird. Der Anzeigename muss über alle in einem Teamprojekt definierten Felder hinweg eindeutig sein. Auch unterscheidet sich der Anzeigename möglicherweise von der Bezeichnung, die neben dem Feld im Arbeitsaufgabenformular angezeigt wird. Weitere Informationen finden Sie unter Steuern des XML-Elementverweises. Der Attributtyp ist typelib:FieldName. Mindestlänge: 1; maximale Länge: 128. Musterwert: ^[^\. \[\]]+$ Musterwertbeispiel: Zugewiesen zu |
||||||||||||||||||||
refname |
Erforderlich. Die eindeutige Bezeichnung, die ein Feld von allen anderen Feldern unterscheidet, die in der Teamprojektauflistung definiert sind. Informationen zu zusätzlichen Anforderungen und Einschränkungen bei Anzeigenamen und Verweisnamen finden Sie unter Benennungskonventionen für Arbeitsaufgabenverfolgungs-Objekte. Der Attributtyp ist typelib:ReferenceFieldName. Mindestlänge: 1; maximale Länge: 70. Musterwert: ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ Musterwertbeispiel: Company.IssueType |
||||||||||||||||||||
type |
Erforderlich. Gibt den Datentyp an, der vom Feld akzeptiert wird. Hinweis Feldern in verschiedenen Projektauflistungen, die den gleichen reportingrefname haben, muss der gleiche Wert für type zugewiesen werden.Wenn sich die Werte unterscheiden, können Datenkonflikte auftreten, wenn das Data Warehouse verarbeitet wird.Weitere Informationen finden Sie unter Lösen von Schemakonflikten, die im Data Warehouse auftreten. In der folgenden Tabelle sind gültige Werte für dieses Attribut aufgeführt:
|
||||||||||||||||||||
syncnamechanges |
Dies ist optional. Gibt an, ob das Arbeitsaufgabenfeld zum Speichern von Namen dient, die Sie aktualisieren möchten, wenn Änderungen in Active Directory oder in einer Arbeitsgruppe vorgenommen werden. Diese Option ist nur gültig, wenn type="String" ist. Der Attributtyp ist xs:boolean. Geben Sie true an, um die Synchronisierung für das Datenfeld zu aktivieren. Geben Sie false an, um die Synchronisierung für das Datenfeld zu deaktivieren. |
||||||||||||||||||||
reportable |
Dies ist optional. Gibt an, ob Daten aus dem Feld für die Aufnahme in Berichte verfügbar sind. Felder mit dem Standardwert None werden weder in das relationale Data Warehouse exportiert noch werden sie für den SQL Server Analysis Services-Cube verarbeitet. Weitere Informationen zu für Berichte verfügbaren Feldern finden Sie unter Hinzufügen und Ändern von Arbeitsaufgabenfeldern zum Unterstützen von Berichten. Hinweis Feldern in verschiedenen Projektauflistungen, die den gleichen Wert für den reportingrefname haben, muss der gleiche Wert für reportable zugewiesen werden.Wenn sich die Werte unterscheiden, können Datenkonflikte auftreten, wenn das Data Warehouse verarbeitet wird.Weitere Informationen finden Sie unter Lösen von Schemakonflikten, die im Data Warehouse auftreten. In der folgenden Tabelle sind gültige Werte für dieses Attribut aufgeführt:
|
||||||||||||||||||||
formula |
Dies ist optional. Der Aggregationstyp für den berichtsfähigen Typ measure. Der einzige gültige Wert ist sum; er gibt die Summe aller Werte im Satz zurück. |
||||||||||||||||||||
reportingname |
Dies ist optional. Gibt den Namen an, der in Berichten angezeigt wird. Wenn Sie keinen Wert angeben, wird der Wert verwendet, der dem name-Attribut zugewiesen ist. Hinweis Feldern in verschiedenen Projektauflistungen, die den gleichen reportingrefname haben, muss der gleiche Wert für reportingname zugewiesen werden.Wenn sich die Werte unterscheiden, können Datenkonflikte auftreten, wenn das Data Warehouse verarbeitet wird.Weitere Informationen finden Sie unter Lösen von Schemakonflikten, die im Data Warehouse auftreten. Der Attributtyp ist typelib:FieldName. Mindestlänge: 1; maximale Länge: 128. Musterwert: ^[^\. \[\]]+$ Musterwertbeispiel: Zugewiesen zu |
||||||||||||||||||||
reportingrefname |
Dies ist optional. Gibt den Verweisnamen an, der verwendet wird, wenn ein für Berichte verfügbares Feld verarbeitet wird. Wenn Sie keinen Wert angeben, wird der Wert verwendet, der dem refname-Attribut zugewiesen ist. Sie können dieses Attribut verwenden, um Felder, die für das Data Warehouse verarbeitet werden, zusammenzuführen oder zu trennen. Um zwei Felder zusammenzuführen, die über unterschiedliche Verweisnamen verfügen und in verschiedenen Projektauflistungen definiert sind, weisen Sie beiden Feldern den gleichen reportingrefname zu. Um zwei Felder zu trennen, die über den gleichen Verweisnamen verfügen, jedoch in verschiedenen Projektauflistungen definiert sind, weisen Sie jedem Feld einen anderen reportingrefname zu. Sie sollten Felder nach Möglichkeit immer zusammenführen, um die Anzahl von Feldern im Warehouse zu minimieren und die maximale Grenze von 1024 berichtsfähigen Feldern nicht zu überschreiten. Sie können gruppenübergreifende Berichte mit zusammengeführten Feldern generieren. Der Attributtyp ist typelib:ReferenceFieldName. Mindestlänge: 1; maximale Länge: 70. Musterwert: ^[a-zA-Z_][a-zA-Z0-9_]*(\.[a-zA-Z0-9_]+)+$ Musterwertbeispiel: Company.IssueType |
Untergeordnete Elemente
Element |
Beschreibung |
|---|---|
Dies ist optional. Definiert eine Liste zulässiger Werte für das Feld. Zulässige Werte sind Werte, die in einer Feldliste in Arbeitsaufgabenformularen und im Abfrage-Generator zur Auswahl stehen. Sie müssen einen dieser Werte auswählen. |
|
Dies ist optional. Definiert, dass das Feld bereits vorhandene Werte beibehalten kann. Das Element ermöglicht die Verwendung von bereits vorhandenen Feldwerten, selbst wenn sie ungültig sind. Alle neuen Feldwerte müssen gültig sein. |
|
Dies ist optional. Definiert, dass das Feld immer einen Wert ungleich NULL enthalten muss. Dieses Element behält den aktuellen Feldwert bei, und es kann nicht gelöscht oder geleert werden. |
|
Dies ist optional. Gibt ein anderes Feld mit einem Wert an, der in das aktuelle Feld kopiert werden soll. |
|
Dies ist optional. Definiert einen Standardwert für das Feld. |
|
Dies ist optional. Definiert das Feld als leer. |
|
Dies ist optional. Definiert das Feld als fixiert. Ein fixiertes Feld kann nach der Übernahme von Änderungen nicht in einen beliebigen, nicht leeren Wert geändert werden. Sie können das Feld jedoch manuell löschen, die Arbeitsaufgabe speichern und anschließend einen anderen Wert angeben. |
|
Dies ist optional. Definiert den in der QuickInfo des Felds angezeigten Text. |
|
Dies ist optional. Definiert ein Muster für das Feld, mit dem der Feldwert übereinstimmen muss. |
|
Dies ist optional. Gibt ein anderes Feld an, dessen Wert nicht dem Wert des aktuellen Felds entsprechen darf. |
|
Dies ist optional. Definiert eine Liste unzulässiger Werte für das Feld. |
|
Dies ist optional. Definiert das Feld als schreibgeschützt. |
|
Dies ist optional. Definiert das Feld als erforderlich. |
|
Dies ist optional. Gibt eine Serverkomponente an, die den Feldwert bereitstellt. |
|
Dies ist optional. Definiert eine Liste mit vorgeschlagenen Werten für das Feld. Vorgeschlagene Werte sind Werte, die in einer Feldliste in Arbeitsaufgabenformularen und im Abfrage-Generator zur Auswahl stehen. Neben den Werten in der Liste können Sie zusätzliche Werte eingeben. |
|
Dies ist optional. Legt fest, dass die Liste zulässiger Werte nur gültige Systembenutzer enthalten darf. |
|
Dies ist optional. Legt mindestens eine Regel fest, die auf das aktuelle Feld angewendet wird, wenn ein anderes Feld einen bestimmten Wert enthält. |
|
Dies ist optional. Wendet mindestens eine Regel auf das aktuelle Feld an, wenn der Wert eines bestimmten Felds geändert wird. |
|
Dies ist optional. Wendet mindestens eine Regel auf das aktuelle Feld an, wenn ein anderes Feld nicht einen bestimmten Wert enthält. |
|
Dies ist optional. Wendet mindestens eine Regel auf das aktuelle Feld an, wenn der Wert eines bestimmten Felds nicht geändert wird. |
Übergeordnete Elemente
Element |
Beschreibung |
|---|---|
Erforderlich. Enthält die Felddefinitionen für den Arbeitsaufgabentyp. |
Hinweise
FIELD (Definition) ist ein erforderliches untergeordnetes Element von FIELDS (Definition).
Eine Übersicht über alle Systemfelder und vordefinierten Felder, die für die TFS-Prozessvorlagen definiert werden, finden Sie unter Arbeitsaufgabenfeld-Verweis für Visual Studio ALM.
Sie können kein benutzerdefiniertes Feld definieren, das mit dem System.-Präfix beginnt. Sie können ein Feld mit dem Microsoft.-Präfix definieren. Von dieser Vorgehensweise wird jedoch dringend abgeraten, da dadurch die Team Foundation Server-Funktionen beeinträchtigt werden können.
Informationen zu zusätzlichen Anforderungen und Einschränkungen bei Feldanzeigenamen und Verweisnamen finden Sie unter Benennungskonventionen für Arbeitsaufgabenverfolgungs-Objekte.
Sie können den Anzeigenamen eines Felds ändern, nicht jedoch dessen Verweisnamen. Mit dem witadmin-Befehlszeilentool können Sie Felder auflisten und verschiedene Feldattribute ändern. Siehe Verwalten von Arbeitsaufgabenfeldern [witadmin].
Sie können maximal 1.024 Arbeitsaufgabenfelder in einer Teamprojektauflistung definieren, und Sie können in allen Teamprojektauflistungen maximal 1.024 Felder als für Berichte verfügbare Felder festlegen.
Alle Felder, die in allen Arbeitsaufgabentypen (WITs) für alle Teamprojekte einer Projektauflistung definiert wurden, beziehen sich auf die Teamprojektauflistung. Daher müssen Attribute, die Sie Feldern zuweisen, die in einem WIT definiert sind, in allen WITs für alle Teamprojekte in einer Auflistung übereinstimmen. Darüber hinaus werden alle berichtsfähigen Felder aus allen Auflistungen in die Data Warehouse-Datenbanken exportiert.
Informationen zum Beschriften von Feldern zu Berichtszwecken finden Sie unter Hinzufügen und Ändern von Arbeitsaufgabenfeldern zum Unterstützen von Berichten.
Wenn Sie ein vorhandenes Feld zu einem neuen WIT hinzufügen, setzen Sie für die berichtsbezogenen Attribut entweder dieselben Werte wie in der aktuellen Felddefinition oder verwenden die Standardwerte.
Schemakonflikte können auftreten, wenn verschiedene berichtsbezogene Attribute demselben Feld in unterschiedlichen WITs oder denselben WITs in unterschiedlichen Teamprojekten zugewiesen werden. Hinweise zum Lösen dieser Konflikte finden Sie unter Lösen von Schemakonflikten, die im Data Warehouse auftreten.
Weitere Informationen zum Verwenden von Feldern für Abfragen, Berichte und die Nachverfolgung von Arbeitsaufgaben finden Sie unter Ändern oder Hinzufügen eines Felds zur Unterstützung von Abfragen, Berichten und Workflow.
Eine Übersicht zum Anwenden von Einschränkungen oder Bedingungen auf ein FIELD mithilfe von untergeordneten Elementen finden Sie unter Anwenden einer Regel auf ein Arbeitsaufgabenfeld.
Beispiel
<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>
Siehe auch
Referenz
Verwalten von Arbeitsaufgabenfeldern [witadmin]
Konzepte
Benennungskonventionen für Arbeitsaufgabenverfolgungs-Objekte
Arbeitsaufgabenfeld-Verweis für Visual Studio ALM
Anpassen der Objekte für die Arbeitsnachverfolgung als Unterstützung der Prozesse des Teams
Definieren und Anpassen von Arbeitsaufgabenfeldern
Weitere Ressourcen
Arbeitsaufgabennachverfolgung: Index für XML-Elementdefinitionen