Freigeben über


Definieren von Objekten zum Nachverfolgen von Arbeitsaufgaben mit dem Plug-In für die Arbeitsaufgabenverfolgung

Mit dem Plug-In für die Nachverfolgung von Arbeitsaufgaben definieren Sie die ursprünglichen Objekte eines Teamprojekts zur Nachverfolgung der Arbeit. Zu diesen Objekten gehören Arbeitsaufgabentypen, Arbeitsaufgabenabfragen, Kategorien, Linktypen und Instanzen von Arbeitsaufgaben. Nachdem Sie ein Teamprojekt erstellt haben, können Sie diese Objekte mit dem witadmin-Befehlszeilentool ändern.

In der Plug-In-Datei werden mindestens eine Aufgabe und die zugehörigen Abhängigkeiten angegeben. Im Allgemeinen geben Sie eine Aufgabe für jede wichtige Uploadaktivität an, z. B. Linktypen, Arbeitsaufgabentypen, Abfragen und Kategorien.

Wichtig

Sie müssen die Aufgaben angeben, um Dateien hochzuladen und Abfragen in einer bestimmten Reihenfolge zu definieren: Linktypen zuerst, dann Arbeitsaufgabentypen und dann Abfragen.Jede Definitionsdatei für diese Objekte ist von den Definitionen abhängig, die in den Aufgaben angegeben werden, die ihnen vorausgehen.Im Allgemeinen sollten Sie die Reihenfolge der Aufgaben beibehalten, die in der anzupassenden Prozessvorlage definiert ist.Weitere Informationen finden Sie unter Definieren der Abhängigkeiten für Aufgabengruppen und Aufgaben in Plug-In-Dateien.

Name und Speicherort des Plug-Ins

In der folgenden Tabelle werden der Name und Speicherort der Datei für die Prozessvorlagen für Microsoft Solutions Framework (MSF) sowie der Name des Plug-Ins angegeben.

Dateiname:

WorkItems.xml

Dateispeicherort:

Ordner "WorkItem Tracking"

Plug-In-Name:

Microsoft.ProjectCreationWizard.WorkItemTracking

Hinweis

Sie können den Namen und Speicherort der XML-Datei, jedoch nicht den Namen des Plug-Ins ändern.Visual Studio Team Foundation Server enthält keinen Mechanismus für die Bereitstellung clientseitiger Plug-Ins, Richtlinien oder anderer Änderungen.Wenn Sie diese Art von Funktion bereitstellen möchten, verwenden Sie Ihr eigenes Verteilungs- und Installationsprogramm.

Spezielle Informationen zu jedem Objekttyp, den Sie definieren können, finden Sie in einem der folgenden Themen:

Syntaxstruktur des Arbeitsaufgabenverfolgungs-Plug-Ins

Die Plug-In-Datei für die Arbeitsaufgabenverfolgung muss der Schemadefinition entsprechen, die in der Datei "WorkItemMethodology.xsd" enthalten ist, und das Plug-In muss in einer eigenen Datei angegeben werden. Die Schemadateien für Prozessvorlagen stehen auf der folgenden Seite der Microsoft-Website zum Download bereit: Prozessvorlagen- und Arbeitsaufgabenschemas für Visual Studio Team Foundation.

Die folgende Syntax zeigt die Struktur des Arbeitsaufgabenverfolgungs-Plug-Ins auf hoher Ebene an. Vier Aufgaben werden angegeben, wobei jeweils die Definitionen für Linktypen, Arbeitsaufgabentypen, Abfragen und Kategorien angegeben werden. Wenn Sie Definitionen für Arbeitsaufgabeninstanzen hinzufügen möchten, würden Sie jeweils eine zusätzliche Aufgabe angeben.

Eine Beschreibung der einzelnen Elemente finden Sie im weiteren Verlauf des Themas unter Elementreferenz.

<?xml version="1.0" encoding="utf-8"?>
<tasks>
  <task id="LinkTypes" name="LinkType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item link types created">
    <taskXml>
      <LINKTYPES>
        <LINKTYPE />
   . . . 
      </LINKTYPES>
    </taskXml>
  </task>
  <task id="WITs" name="WorkItemType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item types created">
    <dependencies>
      <dependency taskId="LinkTypes" />
    </dependencies>
    <taskXml>
      <WORKITEMTYPES>
        <WORKITEMTYPE />
   . . . 
      </WORKITEMTYPES>
    </taskXml>
  </task>
  <task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item queries uploaded">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <QUERIES>
        <Permission />
   . . . 
        <QueryFolder >
          <Query />
   . . . 
        </QueryFolder>
   . . . 
      </QUERIES>
    </taskXml>
  </task>
  <task id="Categories" name="Categories definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item type categories created">
    <dependencies>
      <dependency taskId="WITs" />
    </dependencies>
    <taskXml>
      <CATEGORIES fileName="WorkItem Tracking\Categories.xml" />
    </taskXml>
  </task>
</tasks>

Elementreferenz

In der folgenden Tabelle werden die Elemente beschrieben, mit denen Objekte für die Arbeitsaufgabenverfolgung hochgeladen werden. Diese Elemente werden innerhalb eines taskXml-Containerelements in der Arbeitsaufgabenverfolgungs-Plug-In-Datei angegeben. Weitere Informationen zu Aufgaben-, Abhängigkeits- und taskXml-Elementen finden Sie unter Definieren der Aufgaben zum Verarbeiten eines Plug-Ins.

Element

Syntax

Beschreibung 

CATEGORIES

<CATEGORIES fileName="CategoriesFilePathName" />

Optionales untergeordnetes Element des taskXml-Elements für das Arbeitsaufgabenverfolgungs-Plug-In.

Gibt den Pfad und den Namen der Datei an, die die Kategoriedefinitionen enthält, die bei der Verarbeitung der Arbeitsaufgabenverfolgungs-Plug-In-Aufgabe hochgeladen werden muss.

FIELD

<FIELD refname="FieldReferenceName" value="Value" />

Erforderliches untergeordnetes Element von WI.

Definiert einen Wert für ein Feld in der Arbeitsaufgabeninstanz.

HYPERLINK

<HYPERLINK URL="URL" relativePath="false" />

Optionales untergeordnetes Element von WI.

Definiert einen Link für die Arbeitsaufgabeninstanz.

LINKTYPE

<LINKTYPE fileName="LinkTypeFilePathName" />

Erforderliches untergeordnetes Element von LINKTYPES.

Gibt den Pfad und den Namen einer Datei an, die eine hochzuladende Definition des Linktyps beinhaltet.

LINKTYPES

<LINKTYPES>
     <LINKTYPE />
 . . .
</LINKTYPES>

Optionales untergeordnetes Element des taskXml-Elements für das Arbeitsaufgabenverfolgungs-Plug-In.

Enthält eine Sammlung von LINKTYPE-Elementen, die jeweils eine hochzuladende Definitionsdatei angeben.

Permission

<permission allow="ListOfPermissions" identity="GroupName" />

Optionales untergeordnetes Element von Query.

Gibt die Standardberechtigungen an, die Teamabfragen zugewiesen werden. Weitere Informationen finden Sie unter Zuweisen von Berechtigungen für Arbeitsaufgabenabfragen.

Query

<Query name="QueryName" fileName="QueryFilePathName" />

Erforderliches untergeordnetes Element von QUERIES.

Gibt den Namen und den Pfad der WIQ-Datei an, die eine hochzuladende Abfrage definiert.

QueryFolder

<QueryFolder name="
FolderName
">

Optionales untergeordnetes Element von QUERIES.

Gibt den Namen eines Abfrageordners an.

QUERIES

<QUERIES>
   . . . 
</QUERIES>

Optionales untergeordnetes Element des taskXml-Elements für das Arbeitsaufgabenverfolgungs-Plug-In.

Gibt an, welche Abfragedefinitionsdateien zum Erstellen von Standardabfragen verwendet werden sollen.

WI

<WI type="WorkItemType">
   <FIELD> . . .</FIELD>
   <HYPERLINK> . . .</HYPERLINK>
</WI>

Erforderliches untergeordnetes Element von WORKITEMS.

Definiert einen zu erstellenden Arbeitsaufgabentyp sowie die Werte, die bestimmten Feldern zugewiesen werden sollen.

WORKITEMS

WORKITEMS>
   <WI>
      <FIELD> . . .</FIELD>
      <HYPERLINK> . . .</HYPERLINK>
   </WI>
</WORKITEMS >

Optionales untergeordnetes Element des taskXml-Elements für das Arbeitsaufgabenverfolgungs-Plug-In.

Enthält eine Sammlung von WI-Elementen, die jeweils eine Arbeitsaufgabeninstanz definieren.

WORKITEMTYPE

<WORKITEMTYPE fileName="WITFilePathName" />

Erforderliches untergeordnetes Element von WORKITEMTYPES.

Gibt den Pfad und den Namen der Datei an, die eine hochzuladende Typdefinition beinhaltet.

WORKITEMTYPES

<WORKITEMTYPES> 
    <WORKITEMTYPE />
 . . .
</WORKITEMTYPES>

Erforderliches untergeordnetes Element des Arbeitsaufgabenverfolgungs-Plug-Ins.

Enthält eine Sammlung von WORKITEMTYPE-Elementen, die jeweils eine hochzuladende Definitionsdatei angeben.

Siehe auch

Konzepte

Anpassen einer Prozessvorlage

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

Übersicht über Prozessvorlagendateien