XML-Elementreferenz für WITD

Artikel
07/20/2011

Sie können einen vorhandenen Arbeitsaufgabentyp anpassen oder einen Arbeitsaufgabentyp erstellen, um die Anforderungen der Nachverfolgung von Projekten zu erfüllen. Durch einen Arbeitsaufgabentyp werden die Regeln, Felder, Zustände und Übergänge für eine Arbeitsaufgabe definiert, die in einem Teamprojekt nachverfolgt wird (beispielsweise ein Fehler, eine Anforderung oder ein Risiko).

Ein Arbeitsaufgabentyp kann nicht leer sein. Das WITD-Element, das lediglich über ein definiertes WORKITEMTYPE-Element verfügen muss, ist das Stammelement in der Definition eines jeden Arbeitsaufgabentyps. Der Name eines Arbeitsaufgabentyps muss in einem Teamprojekt eindeutig sein, und jeder Typname muss mindestens 254 Unicodezeichen umfassen. Weitere Informationen finden Sie unter Benennungskonventionen für Arbeitsaufgabenverfolgungs-Objekte.

Um eine Arbeitsaufgaben-Typdefinition anzupassen oder zu erstellen, ändern Sie die Typdefinition der XML-Datei, die mit dem Arbeitsaufgabentyp verknüpft ist. Die Definitionen der Arbeitsaufgabentypen werden für die einzelnen Teamprojekte verwaltet.

In diesem Thema

WITD-Syntaxstruktur
Untergeordnete WITD-Elemente
Verarbeiten von Arbeitsaufgabentypen von Vorlagen

WITD-Syntaxstruktur

Im folgenden Beispiel wird die Struktur eines Arbeitsaufgabentyps auf oberster Ebene veranschaulicht.

<WITD application="work item type editor" version="1.0">
    <WORKITEMTYPE name="bug">
        <DESCRIPTION>Bug work item types are used to track defects in the code.</DESCRIPTION>
        <GLOBALLISTS> . . . </GLOBALLISTS>
        <FIELDS> . . . </FIELDS>
        <WORKFLOW> . . . </WORKFLOW>
        <FORM> . . . </FORM>
    </WORKITEMTYPE>
</WITD>

Eine kleine Anzahl von XML-Elementen wird auf der obersten Ebene der Arbeitsaufgaben-Typdefinition zwischen WORKITEMTYPE-Tags angezeigt. Sie beginnen mit der Definition eines Arbeitsaufgabentyps, indem Sie einen Namen und eine Beschreibung angeben. Außerdem verwenden Sie bestimmte XML-Standardtags, um die Arbeitsaufgaben-Typdefinition zu umschließen.

Untergeordnete WITD-Elemente

Die im vorherigen Beispiel verwendeten strukturellen Elemente werden in der folgenden Tabelle beschrieben:

Element	Beschreibung
WITD	Die vollständige Arbeitsaufgaben-Typdefinition wird mit dem WITD-Tag umschlossen. Sie können einen beliebigen Namen als Anwendungsnamen verwenden. Durch die Version wird das Schema des Arbeitsaufgabentyps gekennzeichnet, die sich mit jeder weiteren Version ändert. Verwenden Sie "1.0". `<WITD application="Work item type editor" version="1.0 [1]"> <WORKITEMTYPE> . . .</WORKITEMTYPE> </WITD>`
WORKITEMTYPE	Die Namen von Arbeitsaufgabentypen müssen im jeweiligen Teamprojekt eindeutig sein. Zur Laufzeit verwenden Sie den von diesem Element angegebenen Namen. Beispielsweise kann der Name als Menüoption angezeigt werden. In diesem Fall könnte ein Benutzer im Menü Neue Arbeitsaufgabe auf Fehler klicken. `<WORKITEMTYPE name="WorkItemTypeName"> <DESCRIPTION>Text</DESCRIPTION> <GLOBALLISTS> . . .</</GLOBALLISTS> <FIELDS> . . . </FIELDS> <WORKFLOW> . . . </WORKFLOW> <FORM> . . .</</FORM> </WORKITEMTYPE>`
DESCRIPTION	Dient zum Angeben einer Zeichenfolge, mit der die Art der definierten Arbeitsaufgabe beschrieben wird. Die Beschreibung sollte für die Benutzer, die den Typ der Arbeitsaufgabe anpassen, hilfreich sein. Hinweis Die Beschreibung kann ausschließlich in der XML-Definition angezeigt werden.Sie können die Beschreibung nicht auf der Benutzeroberfläche anzeigen, und sie steht in keiner Beziehung zum Feld System.Definition. `<DESCRIPTION> DescriptionOfWorkItemType</DESCRIPTION>` Dient zum Angeben einer Textzeichenfolge, mit der die Art der definierten Arbeitsaufgabe beschrieben wird.
GLOBALLISTS	Enthält die globalen Listendefinitionen, die vom Arbeitsaufgabentyp verwendet werden. Mit globalen Listen können Sie Listenelemente für mehrere Arbeitsaufgabentypen einer Teamprojektsammlung freigeben. Die Verwendung von globalen Listen unterstützt eine problemlose Verwaltung und gruppenübergeifende Zusammenarbeit. `<GLOBALLIST name="globalListName"> <LISTITEM> . . . </LISTITEM> </GLOBALLIST>` Weitere Informationen finden Sie unter Definieren von globalen Listen.
FIELDS	Enthält den Satz von Felddefinitionen, der vom Arbeitsaufgabentyp verwendet werden. Innerhalb des FIELDS-Elements definieren Sie alle Felder, die Sie zum Nachverfolgen von Daten für den Arbeitsaufgabentyp verwenden möchten. Dies umfasst auch Felder, mit denen Sie Abfragen ausführen und Berichte generieren können. `<FIELDS> <FIELD> . . . </FIELD> </FIELDS>` Weitere Informationen finden Sie unter Arbeiten mit Arbeitsaufgabenfeldern.
WORKFLOW	Enthält den Satz von STATE-Elementen und TRANSITION-Elementen, der den Workflow des Arbeitsaufgabentyps definiert. Der Workflow besteht aus einem Satz gültiger Übergänge von einem Zustand in einen anderen und den speziellen Bedingungen, die den einzelnen Übergängen zugewiesen sind. `<WORKFLOW> <STATES> . . . </STATES> <TRANSITIONS> . . . </TRANSITIONS> </WORKFLOW>` Weitere Informationen finden Sie unter Definieren und Anpassen des Workflows für Arbeitsaufgaben.
FORM	Enthält LAYOUT, CONTROL, GROUP, TAB, TABGROUP, SPLITTER sowie weitere Elemente, mit denen definiert wird, welche Felder und Steuerelemente im Formular angezeigt werden und wie diese Elemente im Formular für den Arbeitsaufgabentyp angezeigt werden. `<FORM> <Layout> . . . </Layout> </FORM>` Weitere Informationen finden Sie unter Entwerfen und Anpassen eines Arbeitsaufgabenformulars.

Verarbeiten von Arbeitsaufgabentypen von Vorlagen

Für Arbeitsaufgaben-Typdefinitionen von Prozessvorlagen stehen Ihnen zwei Sätze zur Verfügung, die denjenigen für das Microsoft Solutions Framework for Agile Software Development v5.0 (MSF) und das MSF zur Capability Maturity Model Integration (CMMI) Software Development v5.0 entsprechen. Diese Dateien befinden sich im Installationsverzeichnis an den folgenden Speicherorten:

Laufwerk:\Programme\Microsoft Visual Studio-v10.0-Team Foundation Server\Application Tier\Web Services\Deploy\ProcessTemplateManagerFiles\MsfAgile\Template.zip
Laufwerk:\Programme\Microsoft Visual Studio-v10.0-Team Foundation Server\Application Tier\Web Services\Deploy\ProcessTemplateManagerFiles\MsfFormal\Template.zip

Sie können die Arbeitsaufgaben-Typdefinitionen im Ordner "WorkItem Tracking\TypeDefinitions" in der Datei "Template.zip" suchen. MSF for Agile Software Development v5.0 definiert z. B. jeweils eine XML-Datei für die folgenden Arbeitsaufgabentypen: Fehler, Problem, Freigegebene Schritte, Aufgabe, Testfall und Benutzertextabschnitt. Weitere Informationen zu den einzelnen Arbeitsaufgabentypen finden Sie unter MSF for Agile Software Development, Version 5.0.

Im Ordner "TypeDefinitions" können Typdefinitionsdateien angepasst oder neu erstellt werden. Sie können dann Ihren neuen Arbeitsaufgabentyp in ein einzelnes Projekt importieren oder Ihrer Prozessvorlage hinzufügen und die geänderte Vorlage auf den Team Foundation Server hochladen. Weitere Informationen finden Sie unter Hinzufügen von Typdefinitionen für Arbeitsaufgaben zu einer Prozessvorlage.