Freigeben über


Verweis für alle WIDT-XML-Elemente

Sie können einen vorhandenen Arbeitsaufgabentyp (WIT) anpassen oder einen Typ erstellen, um die Anforderungen für die Projektnachverfolgung zu erfüllen. Durch einen WIT werden die Regeln, Felder, Workflowzustände und Übergänge für eine Arbeitsaufgabe definiert, die in einem Teamprojekt nachverfolgt wird (beispielsweise ein Fehler, eine Anforderung oder ein Risiko). Sie erstellen ein Teamprojekt entweder in Visual Studio Online oder auf einem lokalen Team Foundation Server (TFS).

Das WITD-Element, das lediglich über ein definiertes WORKITEMTYPE-Element verfügen muss, ist das Stammelement in der Definition eines jeden WIT. Der Name eines WIT muss in einem Teamprojekt eindeutig sein, und jeder Typname darf höchstens 128 Unicodezeichen umfassen.

Um eine WIT-Definition anzupassen oder zu erstellen, ändern Sie die Typdefinition der XML-Datei. Arbeitsaufgabentypen werden für ein Teamprojekt in einer Projektauflistung begrenzt.

WITD-Syntaxstruktur

Im folgenden Beispiel wird die Struktur einer WIT-Definition auf oberster Ebene veranschaulicht.

<witd:WITD application="Work item type editor" version="1.0" xmlns:witd="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef">
    <WORKITEMTYPE name="bug" refname="Microsoft.VSTS.WorkItemTypes.Bug">
        <DESCRIPTION> Describes a divergence between required and actual behavior, and tracks the work done to correct the defect and verify the correction.</DESCRIPTION>
        <GLOBALLISTS> . . . </GLOBALLISTS>
        <FIELDS> . . . </FIELDS>
        <WORKFLOW> . . . </WORKFLOW>
        <FORM> . . . </FORM>
    </WORKITEMTYPE>
</witd:WITD>

Untergeordnete WITD-Elemente

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

Element

Beschreibung

WITD

Die vollständige WIT-Definition wird mit dem WITD-Tag umschlossen. Sie können einen beliebigen Namen als Anwendungsnamen verwenden. Die Version identifiziert das WIT-Schema, das sich von einer Version zur nächsten ändern kann. Verwenden Sie "1.0".

<witd:WITD application="Work item type editor" version="1.0" xmlns:witd="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef">
   <WORKITEMTYPE> . . .</WORKITEMTYPE>
</witd:WITD>

WORKITEMTYPE

Die Namen von WITs 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 die Option Fehler wählen.

<WORKITEMTYPE name="WorkItemTypeName" refname="WITReferenceName" >
    <DESCRIPTION>Text</DESCRIPTION>
    <GLOBALLISTS> . . .</</GLOBALLISTS>
    <FIELDS> . . . </FIELDS>
    <WORKFLOW> . . . </WORKFLOW>
    <FORM> . . .</</FORM>
</WORKITEMTYPE>

Anzeigename: Dieser Name wird in den Dropdownmenüs von Arbeitsaufgabenabfragen angezeigt. Der Anzeigename muss über alle in einem Teamprojekt definierten WIT-Namen hinweg eindeutig sein. Geben Sie einen Namen mit nicht mehr als 128 Unicode-Zeichen an, in dem alphanumerische Zeichen, Unterstriche und Bindestriche vorkommen.

Verweisname : Geben Sie einen Namen mit nicht mehr als 70 Unicode-Zeichen an, in dem alphanumerische Zeichen, Unterstriche und Bindestriche vorkommen. Der Verweisname muss mindestens einen Punkt (.) enthalten, am Anfang oder Ende eines Namens darf jedoch kein Punkt stehen. Der Verweisname darf auch nicht mit einer Zahl oder einem Unterstrich beginnen, und er darf keine aufeinander folgenden Bindestriche (--) enthalten.

Geben Sie keinen Namen an, der mit dem reservierten System überlappt. XXX und Microsoft. XXX-Namespaces. Siehe Benennungskonventionen für Arbeitsaufgabenverfolgungs-Objekte.

BESCHREIBUNG

Dient zum Angeben einer Zeichenfolge, mit der die Art der definierten Arbeitsaufgabe beschrieben wird. Die Beschreibung sollte für die Benutzer, die den WIT 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 Auswahllisten für mehrere Arbeitsaufgabentypen für eine Teamprojektsammlung freigeben. Die Verwendung von globalen Listen unterstützt eine problemlose Verwaltung und gruppenübergeifende Zusammenarbeit.

<GLOBALLIST name="globalListName">
    <LISTITEM> . . . </LISTITEM>
</GLOBALLIST>

FIELDS

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>

WORKFLOW

Definiert die Workflowelemente, mit denen der Arbeitsaufgabenstatus verfolgt werden kann, wenn sich die Arbeitsaufgabe von einem neuen Zustand in einen geschlossen oder abgeschlossenen Zustand bewegt. Dieses Element enthält den Satz von STATE-Elementen und TRANSITION-Elementen, die den Workflow definieren. 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>

FORM

Gibt den Entwurf des Arbeitsaufgabenformulars an, indem die Felder und Steuerelemente, die in dem Formular angezeigt werden, und deren Reihenfolge definiert werden. Es enthält LAYOUT, CONTROL, GROUP, TAB, TABGROUP, SPLITTER und andere Elemente.

<FORM>
   <Layout> . . . </Layout>
</FORM>

Prozessvorlagen für Arbeitsaufgabentypen

Beim Installieren oder Aktualisieren einer Instanz von TFS, werden die Standardprozessvorlagen in das folgende Verzeichnis heruntergeladen:

%programfiles%/Microsoft Team Foundation Server 14.0/Tools/Deploy/ProcessTemplateManagerFiles/1033

WIT-Definitionsdateien werden im Ordner „WorkItem Tracking\TypeDefinitions“ gespeichert.

Weitere Informationen zum Erstellen oder Anpassen eines Arbeitsaufgabentyps finden Sie unter Anpassen der Objekte für die Arbeitsnachverfolgung als Unterstützung der Prozesse des Teams. Informationen zum Hinzufügen eines neuen Arbeitsaufgabentyps zu Ihrer Prozessvorlage finden Sie unter Hinzufügen von Typdefinitionen für Arbeitsaufgaben zu einer Prozessvorlage.

Siehe auch

Konzepte

Anpassen der Objekte für die Arbeitsnachverfolgung als Unterstützung der Prozesse des Teams

Weitere Ressourcen

witAdmin: Anpassen und Verwalten von Objekten für die Arbeitsnachverfolgung