Definieren und Anpassen von Arbeitsaufgabenfeldern

Artikel
05/16/2015

Mit Arbeitsaufgabenfeldern können Sie Daten für einen Arbeitsaufgabentyp verfolgen, die Filterkriterien für Abfragen definieren und Berichte generieren. Mit Ausnahme von Datenfeldern des Kernsystems in Team Foundation Server (TFS) muss jedes Datenelement als Arbeitsaufgabenfeld definiert sein, wenn Sie es nachverfolgen oder damit einen Workflow definieren möchten oder es im Formular für einen Arbeitsaufgabentyp angezeigt werden soll. 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 Arbeitsaufgabenfeld-Verweis für Visual Studio ALM.
Importieren einer 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 Verweis für alle WIDT-XML-Elemente.
Importieren einer globalen 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 (PWA). Nachdem Sie die Team Foundation Server-Erweiterungen für Project Server installiert haben, 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 Zu TFS hinzugefügte Project Server-Felder für die Unterstützung der Datensynchronisierung.

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 der Objekte für die Arbeitsnachverfolgung als Unterstützung der Prozesse des Teams.

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. Sie definieren jedes Feld durch ein FIELD-Element im FIELDS-Abschnitt der Definition des Arbeitsaufgabentyps oder globalen Workflows. Informationen zur Struktur und zum Speicherort dieser Dateien finden Sie unter Verweis für alle WIDT-XML-Elemente und Anpassen des globalen Workflows.

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.

Sie definieren ein Feld, indem Sie in der Definitionsdatei für den Arbeitsaufgabentyp die folgende XML-Syntax verwenden.

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

Datentypen

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 in einer Teamprojektauflistung definierten Typ aufweisen. 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 einem Arbeitsaufgabenformular ein DateTime-Feld mit dem FieldControl-Attribut oder dem DateTimeControl type-Attribut hinzu.
Double	Gibt einen Gleitkommawert an. Double-Felder werden häufig in Abfragefiltern und Ergebnislisten verwendet. Fügen Sie einem Arbeitsaufgabenformular mit dem Double FieldControl-Attribut ein type-Feld hinzu.
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 einem Arbeitsaufgabenformular das System.History-Feld mit dem WorkItemLogControl type-Attribut, das Rich-Text-Format-Steuerelemente unterstützt, hinzu.
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 einem Arbeitsaufgabenformular ein HTML-Feld mit dem HTMLControl type-Attribut, das Rich-Text-Format-Steuerelemente unterstützt, hinzu.
Integer	Gibt einen systemeigenen 32-Bit-Ganzzahlwert mit Vorzeichen an. Integer-Felder werden häufig in Abfragefiltern und Ergebnislisten verwendet. Fügen Sie einem Arbeitsaufgabenformular mit dem Integer FieldControl-Attribut ein type-Feld hinzu.
PlainText	Unterstützt die Eingabe einer Textzeichenfolge, die mehr als 255 Unicode-Zeichen enthalten kann. Fügen Sie einem Arbeitsaufgabenformular ein PlainText-Feld hinzu. Mit dem FieldControl-Typattribut kann lediglich Text im Nur-Text-Format hinzugefügt werden, das HTMLControl type-Typattribut unterstützt jedoch auch Rich-Text-Format-Steuerelemente.
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 einem Arbeitsaufgabenformular mit dem String FieldControl-Attribut ein type-Feld hinzu.
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 einem Arbeitsaufgabenformular das System.AreaPath-Feld und das System.IterationPath-Feld mithilfe des WorkItemClassificationControl type-Attributs hinzu.

Reportable-Attribute

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 auf None, Detail, Dimension oder Measure fest, abhängig davon, ob 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 einem Feld, das zur Anzeige von Daten in Berichten verwendet wird, eine andere Bezeichnung zu. Wenn Sie keinen Wert angeben, wird der Anzeigename verwendet, der dem name-Attribut zugewiesen ist.
reportingrefname. Weisen Sie einem Feld, das zum Export von Daten in das relationale Data Warehouse verwendet wird, einen anderen Verweisnamen zu. Wenn Sie keinen Wert angeben, wird der Wert verwendet, der dem refname-Attribut zugewiesen ist.

Verwenden Sie dieses Attribut, um in Berichten enthaltene Felder 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 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.

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.

Attributwert	Beschreibung
Detail	Verwenden Sie den Detail-Typ nur für Integer-, Double-, String- oder DateTime-Felder. Die Daten in diesem Feld werden in die Tabellen "Arbeitsaufgabe" und "Aktuelle Arbeitsaufgabe" in der relationalen Warehouse-Datenbank übertragen, jedoch nicht in den SQL Server Analysis Services-Cube. Durch Verwendung dieses Typs für uneingeschränkte Textfelder können die Daten in Berichten eingesetzt werden, ohne den Cube dabei erheblich zu vergrößern.
Dimension	Verwenden Sie den Dimension-Typ nur für Integer-, String- oder DateTime-Felder. 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 Measure-Typ nur für Integer- und Double-Felder. Measures sind die numerischen Werte in den Berichten. Während der Verarbeitung des Analysis Services-Cubes werden Daten in Feldern vorausberechnet, die 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. Weitere Informationen zu Measuregruppen finden Sie unter Im Analysis Services-Cube für Visual Studio verfügbare Perspektiven und Measuregruppen. Wenn Sie Measure angeben, müssen Sie sum für das formula-Attribut angeben. Dieses gibt die Summe jedes Measures zurück, auf das in der Abfrage verwiesen wird.
None	Geben Sie None an, wenn Sie das Feld nicht in Berichte einschließen möchten. Dieser Wert ist die Standardzuweisung.

Beispiele für Angaben bei der Berichterstellung

Beispiel für Detail

Beispiel für Dimension

Beispiel für Measure

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

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 Verweis für alle FIELD-XML-Elemente.

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.

Von den TFS-Standardprozessvorlagen vordefinierte Felder beginnen mit Microsoft.VSTS 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 vordefinierten Felder, die für die TFS-Standardprozessvorlagen definiert werden, finden Sie unter Arbeitsaufgabenfeld-Verweis für Visual Studio ALM. Weitere Informationen zum Angeben von Feldnamen finden Sie unter Benennungskonventionen für Arbeitsaufgabenverfolgungs-Objekte.

Ausgeblendete und unveränderliche Attribute und der Feld-Explorer für Arbeitsaufgaben

Neben den Attributen, die Sie für ein Arbeitsaufgabenfeld ändern können, gibt es eine Reihe von unveränderlichen und praktisch ausgeblendeten Attributen für jedes Feld. Sie können die Zuweisungen dieser Felder mit dem Feld-Explorer-Tool für Arbeitsaufgaben überprüfen. Über das Powertool Prozess-Editor greifen Sie auf das Feld-Explorer-Tool für Arbeitsaufgaben zu.

Feld-Explorer für Arbeitsaufgaben

Arbeitsaufgabenfeld-Explorer

Hinweis

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

Siehe auch