Freigeben über


XML-Elementreferenz für WITD

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.

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

Siehe auch

Konzepte

Entwerfen und Anpassen eines Arbeitsaufgabenformulars

Anpassen von Projektnachverfolgungsdaten, Formularen, Workflow und anderen Objekten

Weitere Ressourcen

Definieren von Arbeitsaufgabenfeldern

Definieren und Anpassen des Workflows für Arbeitsaufgaben

witAdmin: Verwalten von Objekten für das Nachverfolgen von Arbeitsaufgaben

Änderungsprotokoll

Datum

Versionsgeschichte

Grund

Januar 2011

Informationen zum globalen Workflow hinzugefügt und Abschnitt zur Schemadefinition entfernt.

Informationsergänzung.