Share via

FIELD (Definition)-Elementverweis

  • Artikel

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

WITD

   WORKITEMTYPE

      FIELDS

            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:

Wert

Verwendung

DateTime

Gibt ein Datum nach einem Zeitpunkt laut koordinierter Weltzeit (UTC) an.

Double

Gibt einen Gleitkommawert an.

GUID

Gibt ein Feld an, das einen eindeutigen Bezeichner enthält.

History

Unterstützt Diskussionsthemen und verfolgt andere historische Informationen nach.

Hinweis

Das System.History-Feld ist das einzige Feld, das diesen Datentyp verwendet.Sie können kein benutzerdefiniertes Feld mithilfe dieses Datentyps definieren.

HTML

Unterstützt die Erfassung von Rich-Text-Daten und wird für längere Textbeschreibungen, z. B. eine Arbeitsaufgabenbeschreibung, verwendet.

Integer

Gibt einen systemeigenen 32-Bit-Ganzzahlwert mit Vorzeichen an.

PlainText

Unterstützt die Eingabe einer Textzeichenfolge, die mehr als 255 Unicode-Zeichen enthalten kann.

String

Unterstützt die Eingabe einer Textzeichenfolge, die bis zu 255 Unicode-Zeichen enthalten kann. Verwenden Sie eine Zeichenfolgenfeld für eine Bezeichnung oder eine andere kurze Textzeichenfolge bis zu einer Länge von einer Zeile.

TreePath

Gibt ein Feld an, in dem Einträge in einer hierarchischen Struktur oder in einer Baumstruktur angezeigt werden. Dazu gehört z. B., was erforderlich ist, um die Bereichs- und Iterationspfade für ein Produkt anzuzeigen. Informationen zur Definition von untergeordneten Knoten finden Sie unter Hinzufügen und Ändern von Bereichs- und Iterationspfaden.

Hinweis

Das System.AreaPath-Feld und das System.IterationPath-Feld sind die einzigen Felder, die diesen Datentyp verwenden.Sie können kein benutzerdefiniertes Feld mithilfe dieses Datentyps definieren.

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:

Value

Verwendung

Detail

Kann für Felder vom Typ "DateTime", "Double", "Ganze Zahl" oder "Zeichenfolge" angegeben werden.

Die Daten in diesem Feld werden in die Tabellen "Arbeitsaufgabe" und "Aktuelle Arbeitsaufgabe" in der relationalen Warehouse-Datenbank übertragen, jedoch nicht in den Analysis Services-Cube. Dieser Typ ist eine gute Wahl für uneingeschränkte Textfelder, da Sie sie in Berichten verwenden können, ohne den Cube wesentlich zu vergrößern.

Dimension

Kann für Felder vom Typ "DateTime", "Ganze Zahl", "Zeichenfolge" oder "TreePath" angegeben werden.

Die Daten in diesem Feld werden in die relationale Warehouse-Datenbank sowie in den Analysis Services-Cube als Attribut der Dimension "Arbeitsaufgabe" übertragen, sodass diese Daten zum Filtern von Berichten verwendet werden können. Verwenden Sie diesen Typ für Felder, die über Listen von gültigen Werten verfügen. Arbeitsaufgabentyp und Zustand sind gute Beispiele für eine Dimension.

Measure

Verwenden Sie den Typ "Measure" nur für Integer- und Double-Felder. Measures sind die numerischen Werte in den Berichten.

Wenn der Analysis Services-Cube verarbeitet wird, werden Daten in Feldern vorausberechnet, deren reportable-Attribute auf "Measure" festgelegt sind. So enthalten z. B. die Measuregruppen "Arbeitsaufgabe" und "Aktuelle Arbeitsaufgabe" kumulierte Daten für die Felder Original Estimate, Remaining Hours und Completed Hours.

Wenn Sie "Measure" angeben, muss das formula-Attribut angegeben werden.

None

Geben Sie None an, wann Sie das Feld nicht für die Aufnahme in Berichte verwenden möchten. Dies ist die Standardzuweisung.

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

ALLOWEDVALUES

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.

ALLOWEXISTINGVALUE

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.

CANNOTLOSEVALUE

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.

COPY

Dies ist optional. Gibt ein anderes Feld mit einem Wert an, der in das aktuelle Feld kopiert werden soll.

DEFAULT

Dies ist optional. Definiert einen Standardwert für das Feld.

EMPTY

Dies ist optional. Definiert das Feld als leer.

FROZEN

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.

HELPTEXT

Dies ist optional. Definiert den in der QuickInfo des Felds angezeigten Text.

MATCH

Dies ist optional. Definiert ein Muster für das Feld, mit dem der Feldwert übereinstimmen muss.

NOTSAMEAS

Dies ist optional. Gibt ein anderes Feld an, dessen Wert nicht dem Wert des aktuellen Felds entsprechen darf.

PROHIBITEDVALUES

Dies ist optional. Definiert eine Liste unzulässiger Werte für das Feld.

READONLY

Dies ist optional. Definiert das Feld als schreibgeschützt.

REQUIRED

Dies ist optional. Definiert das Feld als erforderlich.

SERVERDEFAULT

Dies ist optional. Gibt eine Serverkomponente an, die den Feldwert bereitstellt.

SUGGESTEDVALUES

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.

VALIDUSER

Dies ist optional. Legt fest, dass die Liste zulässiger Werte nur gültige Systembenutzer enthalten darf.

WHEN

Dies ist optional. Legt mindestens eine Regel fest, die auf das aktuelle Feld angewendet wird, wenn ein anderes Feld einen bestimmten Wert enthält.

WHENCHANGED

Dies ist optional. Wendet mindestens eine Regel auf das aktuelle Feld an, wenn der Wert eines bestimmten Felds geändert wird.

WHENNOT

Dies ist optional. Wendet mindestens eine Regel auf das aktuelle Feld an, wenn ein anderes Feld nicht einen bestimmten Wert enthält.

WHENNOTCHANGED

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

FIELDS

Erforderlich. Enthält die Felddefinitionen für den Arbeitsaufgabentyp.

Hinweise

  1. FIELD (Definition) ist ein erforderliches untergeordnetes Element von FIELDS (Definition).

  2. 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.

  3. 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.

  4. 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].

  5. 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.

  6. Informationen zum Beschriften von Feldern zu Berichtszwecken finden Sie unter Hinzufügen und Ändern von Arbeitsaufgabenfeldern zum Unterstützen von Berichten.

  7. 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.

  8. 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.

  9. 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