Arbeiten mit Arbeitsaufgabenfeldern

Mit Arbeitsaufgabenfeldern können Sie Daten für einen Arbeitsaufgabentyp verfolgen, die Filterkriterien für Abfragen definieren und Berichte generieren.Jedes Datenelement, Mit Ausnahme von Datenfeldern des Kernsystems in Team Foundation Server (TFS), das Sie nachverfolgen, verwenden, um den Workflow zu definieren, oder auf dem Formular für einen Arbeitsaufgabentyp angezeigt werden soll, muss als Arbeitsaufgabenfeld definiert werden.Sie können Arbeitsaufgabenfelder innerhalb der Definition eines Arbeitsaufgabentyps oder globalen Workflows definieren.

Arbeitsaufgabenfelder werden für eine Teamprojektsammlung verwaltet.Sie fügen Felder hinzu, wenn Sie eine der folgenden Aufgaben ausführen:

• Erstellen eines Teamprojekts.Alle innerhalb der Definition eines Arbeitsaufgabentyps oder globalen Workflows definierten Felder, die für die ausgewählte Prozessvorlage definiert sind, werden erstellt.Die Kernsystemfelder werden automatisch für jeden Arbeitsaufgabentyp definiert, der für ein Teamprojekt definiert ist.Eine Liste dieser Felder finden Sie unter Arbeitsaufgabenfeldverweis für Visual Studio ALM.

• Importieren Sie eine Definition für einen Arbeitsaufgabentyp.Alle neuen Felder, die innerhalb der Definition eines Arbeitsaufgabentyps definiert sind, werden der Auflistung hinzugefügt.Weitere Informationen finden Sie unter XML-Elementreferenz für WITD.

• Importieren Sie eine globale Workflowdefinition.Der Auflistung werden alle neuen Felder, die innerhalb des globalen Workflows definiert sind, hinzugefügt.Ein globaler Workflow wird definiert, um einen Satz von Arbeitsaufgabenfeldern zu verwalten, der von mehreren Arbeitsaufgabentypen genutzt wird.Weitere Informationen finden Sie unter Anpassen des globalen Workflows.

• Zuordnen einer Projektauflistung zu einer Instanz von Project Web App zu (PWA).Nachdem Sie die Team Foundation Server Erweiterungen für Project Server installieren, konfigurieren Sie die Integration, indem Sie verschiedene Komponenten von Team Foundation zuordnen.Beim Zuordnen einer Auflistung wird eine globale Workflowdefinition importiert, die mehrere Felder in Project Server-Feldern unterstützt.Weitere Informationen finden Sie unter Für die Unterstützung der Datensynchronisierung hinzugefügte Project Server-Felder.

Alle Felder, die in allen Arbeitsaufgabentypen und allen globalen Workflows für alle Teamprojekte definiert sind, bilden zusammen den vollständigen Satz von Feldern, die für die Auflistung definiert sind.Sie können deren Attribut ändern, sie umbenennen und vorhandene Felder löschen.Durch diese Art von Änderungen werden jedoch bestimmte Kosten verursacht.Weitere Informationen finden Sie unter Anpassen von Projektnachverfolgungsdaten, Formularen, Workflow und anderen Objekten.

Um ein Feld für eine Auflistung hinzuzufügen oder anzupassen, ändern Sie den XML-Inhalt für die Definition des Arbeitsaufgabentyps oder globalen Workflows.Definieren Sie jedes Feld durch ein FIELD-Element innerhalb des FIELDS-Abschnitt der Definition des Arbeitsaufgabentyps oder globalen Workflows.Informationen zur Struktur und zum Speicherort dieser Dateien finden Sie unter XML-Elementreferenz für WITD und Anpassen des globalen Workflows.

In diesem Thema

• FIELD (Definition)-Syntaxstruktur

• Felddatentypen

• Feldern zugewiesene Reportable-Attribute

• Indizierte Felder

• Untergeordnete FIELD (Definition)-Elemente

• Systemfelder und vordefinierte Felder

FIELD (Definition)-Syntaxstruktur

Jedes FIELD (Definition)-Element verfügt über einen Anzeigenamen, der optional ist, und einen Verweisnamen, der erforderlich ist.Der Verweisname muss innerhalb der Auflistung eindeutig sein.Weitere Informationen finden Sie unter Benennungskonventionen für Arbeitsaufgabenverfolgungs-Objekte.

Wichtig
Der Anzeigename eines Felds kann mit dem witadmin changefield-Befehlszeilentool geändert werden.Wenn Sie ein Feld umbenennen, sind allerdings alle Arbeitsaufgabentypen in allen Teamprojekten innerhalb der Auflistung davon betroffen.

Definieren Sie ein Feld durch die folgende XML-Syntax in der Definitionsdatei für den Arbeitsaufgabentyp.

<FIELD name="fieldDisplayName"
   refname="fieldReferenceName" type="String | Integer | Double | DateTime | PlainText | HTML | History | TreePath | GUID"
   syncnamechanges="true | false"
   reportingname="reportingDisplayName"
   reportingrefname="reportingReferenceName"
   reportable="Dimension | Detail | Measure" 
   formula="sum" >
   <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>

Weitere Informationen finden Sie unter FIELD (Definition)-Element.

Zurück nach oben

Felddatentypen

Durch den Feldtyp werden die Art und die Größe der Daten festgelegt, die Sie in dem Feld speichern können.Ein Feld kann nur einen Typ, der innerhalb einer Teamprojektsammlung definiert ist.Diese Einschränkung bietet Unternehmen den Vorteil, dass allgemeine Felder übergreifend über Projekte und Arbeitsaufgabentypen verwendet werden können.

Die folgende Liste enthält die unterstützten Feldtypen:

Datentyp	Beschreibung
DateTime	Gibt ein Datum nach einem Zeitpunkt laut koordinierter Weltzeit (UTC) an. Fügen Sie ein DateTime Feld einem Arbeitsaufgabenformular hinzu, indem Sie entweder die FieldControl oder DateTimeControltype-Attribute verwenden.
Double	Gibt einen Gleitkommawert an.Double-Felder werden häufig in Abfragefiltern und Ergebnislisten verwendet. Fügen Sie ein Double Feld einem Arbeitsaufgabenformular hinzu, indem Sie das - Attribut FieldControltype verwenden.
GUID	Gibt ein Feld an, das einen eindeutigen Bezeichner enthält. Sie können einem Arbeitsaufgabenformular kein GUID-Feld hinzufügen.
History	Unterstützt das Anzeigen von Diskussionsthemen und die Nachverfolgung anderer Verlaufsinformationen. Hinweis Das System.History-Feld ist das einzige Feld, das diesen Datentyp verwendet.Sie können kein benutzerdefiniertes Feld mithilfe dieses Datentyps definieren. Fügen Sie das System.History Feld einem Arbeitsaufgabenformular hinzu, indem Sie das - Attribut WorkItemLogControltype verwenden, das Rich-Text-Format-Steuerelemente unterstützt.
HTML	Unterstützt die Fähigkeit, Rich-Text-Daten aufzuzeichnen und längere Textbeschreibungen wie z. B. Arbeitsaufgabenbeschreibungen zu verwenden.Der Unterschied zwischen HTML- und PlainText-Feldern besteht darin, dass HTML-Felder starke HTML-Typisierung für eine reichhaltigere Informationsanzeige bereitstellen. Fügen Sie ein HTML Feld einem Arbeitsaufgabenformular hinzu, indem Sie das - Attribut HTMLControltype verwenden, das Rich-Text-Format-Steuerelemente unterstützt.
Integer	Gibt einen systemeigenen 32-Bit-Ganzzahlwert mit Vorzeichen an.Integer-Felder werden häufig in Abfragefiltern und Ergebnislisten verwendet. Fügen Sie ein Integer Feld einem Arbeitsaufgabenformular hinzu, indem Sie das - Attribut FieldControltype verwenden.
PlainText	Unterstützt die Eingabe einer Textzeichenfolge, die mehr als 255 Unicode-Zeichen enthalten kann. Fügen Sie ein PlainText Feld einem Arbeitsaufgabenformular hinzu, indem Sie entweder das FieldControl type-Attribut und beschränkt in reinen Text oder das - Attribut HTMLControltype verwenden, das Rich-Text-Format-Steuerelemente unterstützt.
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.Zeichenfolgenfelder werden häufig in Abfragefiltern und Ergebnislisten verwendet. Fügen Sie ein String Feld einem Arbeitsaufgabenformular hinzu, indem Sie das - Attribut FieldControltype verwenden.
TreePath	Gibt ein Feld an, das Einträge in einer hierarchischen oder in einer Baumstruktur anzeigt, z. B. die Anforderungen zum Anzeigebereich und die Iterationspfade für ein Produkt. 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. Fügen Sie die System.AreaPath und System.IterationPath einem Arbeitsaufgabenformular Felder hinzu, indem Sie das - Attribut WorkItemClassificationControl type verwenden.

Zurück nach oben

Reportable-Attribute, die Feldern zugewiesen werden

Einige Feldwerte eignen sich besonders für die Berichterstellung.Mithilfe der Definitionssprache für Arbeitsaufgabentypen können Sie das folgende, optionale Attribut angeben:

• reportable.Legen Sie das reportable-Attribut zu None, zu Detail, zu Dimension oder zu Measure, je nachdem ob fest und wie das Feld in Berichte integriert werden soll.Daten, die aus Feldern mit einem anderen Wert als None für dieses Attribut stammen, werden in das Data Warehouse exportiert und können in Berichte aufgenommen werden.

  Wenn Sie einem Arbeitsaufgabentyp ein vorhandenes Feld hinzufügen, wird der aktuelle Wert für das reportable-Attribut verwendet.Wenn Sie einem Arbeitsaufgabentyp ein Feld hinzufügen, wird die Berichterstellung deaktiviert, wenn Sie sie nicht explizit mit dem reportable-Attribut angeben.

• reportingname.Weisen Sie eine andere Bezeichnung zu einem Feld, das verwendet wird, wenn Daten in Berichten angezeigt werden.Wenn Sie keinen Wert angeben, wird der Anzeigename verwendet, der dem name-Attribut zugewiesen ist.

• reportingrefname.Zuordnen eines anderen Verweisnamen einem Feld, das verwendet wird, wenn Daten in das relationale Data Warehouse werden.Wenn Sie keinen Wert angeben, wird der Wert verwendet, der dem refname-Attribut zugewiesen ist.

  Verwenden Sie dieses Attribut entweder zur Zusammenführung oder durchlaufen Sie Felder ab, die in Berichten enthalten sind.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 und in verschiedenen Projektauflistungen definiert sind, weisen Sie jedem Feld einen anderen reportingrefname zu.

Nach dem Definieren eines Felds können Sie an einer Eingabeaufforderung den Befehl witadmin changefield verwenden, um den Wert aller Attribute mit Ausnahme des refname-Attributs zu ändern.

Informationen zu Best Practices bei der Bezeichnung von Feldern für Berichtszwecke finden Sie unter Hinzufügen und Ändern von Arbeitsaufgabenfeldern zum Unterstützen von Berichten.

Zurück nach oben

Werte des reportable-Attributs

Sie können dem reportable-Attribut einen der Werte none, dimension, detail, und measure zuweisen, wie in folgender Tabelle beschrieben.

Hinweis
Ein Feld kann reportable (berichtspflichtig) gemacht werden, nachdem es für eine Arbeitsaufgabe verwendet wurde.Nach Sie den reportable-Wert festlegen, enthalten neue Revisionen der Arbeitsaufgabe, die in das Warehouse kopiert werden, diesen Feldwert.Revisionen, die sich bereits im Warehouse befinden, werden jedoch nicht mit den vorhandenen Werten aufgefüllt.

Zurück nach oben

Beispiele für Angaben bei der Berichterstellung

Beispiel für Detail

<FIELD refname="MyCorp.Summary" name="Summary" type="String" reportable="detail">

Beispiel für Dimension

<FIELD refname="MyCorp.Category" name="Category" type="String" reportable="dimension">

Beispiel für Measure

<FIELD refname="MyCorp.Cost" name="Cost" type="Integer" reportable="measure" formula="sum">

Indizierte Felder

Mit dem witadmin indexfield-Befehl kann die Indizierung für ein Arbeitsaufgabenfeld aktiviert oder deaktiviert werden.Wenn Sie die Indizierung für ein Feld aktivieren, wird möglicherweise mehr Leistung benötigt, um Arbeitsaufgaben zu finden, in deren Abfragen dieses Feld angegeben wird.Wenn Sie ein benutzerdefiniertes Feld hinzufügen, das Sie in vielen Abfragen von Arbeitsaufgaben verwenden, empfiehlt es sich, die Indizierung für dieses Feld zu aktivieren.Weitere Informationen finden Sie unter Verwalten von Arbeitsaufgabenfeldern [witadmin].

Zurück nach oben

Untergeordnete FIELD (Definition)-Elemente

Es gibt eine Reihe von optionalen untergeordneten Elementen, die Sie für ein Arbeitsaufgabenfeld angeben können, z. B.:

• Hilfetext.Definiert die QuickInfo oder die Hilfeinformationen, die für ein Feld auf dem Arbeitsaufgabenformular (HELPTEXT) angezeigt wird.

• Feldeinschränkungen.Gibt ggf. ein Feld als schreibgeschützt, leer, fixiert oder in Übereinstimmung mit einem bestimmten Muster (REQUIRED, READONLY, EMPTY, FROZEN, MATCH) an.

• Automatische Auffüllung des Feldwerts.Gibt einen Wert für das Feld an (DEFAULT, COPY, SERVERDEFAULT).

• Feldlisten.Gibt zulässige, vorgeschlagene oder unzulässige Werte an.(ALLOWEDVALUES, SUGGESTEDVALUES, PROHIBITEDVALUES)

• Feldbedingungen.Wendet eine oder mehrere Regeln auf ein Feld an, wenn ein anderes Feld geändert oder nicht geändert wird, oder ein anderes Feld hat oder verfügt nicht über einen bestimmten Wert oder andere Bedingung (WHEN, WHENNOT, WHENCHANGED, WHENNOTCHANGED, CANNOTLOSEVALUE, NOTSAMEAS).

Weitere Informationen finden Sie unter XML-Elementreferenz für FIELD.

Zurück nach oben

System und vordefinierte Felder

Alle im System definierten Felder verfügen über Verweisnamen, die mit System beginnen, z. B. System.AreaPath, System.AssignedTo, und die dieses Muster fortsetzen.

Die vordefinierten Felder, die von der Standardprozessvorlagen definiert werden, die TFS beginnen mit Microsoft.VSTS bereitstellt und unterscheiden sich dann auf Grundlage ihrer Verwendung.Beispiele für vordefinierte Felder, die gemeinsam aus Planungs- und Integrationszwecken mit Microsoft Project, zur Integration in Team Foundation Build und zur Integration in Team Foundation verwendet werden, sind:

• Microsoft.VSTS.Common.Priority

• Microsoft.VSTS.Scheduling.DueDate

• Microsoft.VSTS.Build.FoundIn

• Microsoft.VSTS.TCM.Steps

Eine Übersicht über alle Systemfelder und vordefinierte Felder, die für die Standardprozessvorlagen definiert werden, die TFS bereitstellt, finden Sie unter Arbeitsaufgabenfeldverweis für Visual Studio ALM.Weitere Informationen zum Angeben von Feldnamen finden Sie unter Benennungskonventionen für Arbeitsaufgabenverfolgungs-Objekte.

Zurück nach oben

Ausgeblendete und nicht-veränderbare Attribute und der Arbeitsaufgaben-Feld-Explorer

Zusätzlich zu den Attributen, die Sie für ein Arbeitsaufgabenfeld ändern können, gibt es einige nicht-veränderbare und virtuell ausgeblendete Attribute für jedes Feld.Sie können die Zuweisungen dieser Felder mithilfe des Arbeitsaufgaben-Feld-Explorertools gesucht wird.Greifen Sie auf das Arbeitsaufgaben-Feld-Explorertool vom Prozesseditorpowertool zu.

Arbeitsaufgaben-Feld-Explorer

Hinweis

Der Prozesseditorpowertool stellt eine grafische Benutzeroberfläche zum Anpassen von Team Foundation Server-Prozessvorlagen bereit.Sie können dieses Tool verwenden, um Arbeitsaufgabentypen importieren und exportieren, den Inhalt der Prozessvorlage ändern, und von den Feldern zu untersuchen, die für eine Teamprojektsammlung definiert sind.Weitere Informationen finden Sie auf der folgenden Seite der Microsoft-Website: Team Foundation Server-Toole.

Siehe auch

Referenz

Verwalten von Arbeitsaufgabenfeldern [witadmin]

Konzepte

Anpassen der Nachverfolgung von Arbeitsaufgaben und Ihres Teamprojekts

Hinzufügen und Ändern von Arbeitsaufgabenfeldern zum Unterstützen von Berichten

XML-Elementreferenz für FIELD

Weitere Ressourcen

Definieren von Arbeitsaufgabenfeldern