Freigeben über

Definieren der Aufgaben zum Verarbeiten eines Plug-Ins

  • Artikel

Mit dem tasks-Element und seinen untergeordneten Elementen können die hochzuladenden Artefakte oder bestimmte für ein Plug-In zu erstellende Elemente definiert werden. Mit einer Aufgabe werden die Arbeitsschritte angegeben, die zur Konfiguration eines bestimmten Prozesselements in einem neuen Teamprojekt ausgeführt werden müssen. Einige Aufgaben, die Sie Upload die Arbeitsaufgabentypen definieren, Arbeitsaufgabe fragt ab, - Dokumente und Berichte für ein Teamprojekt. Mit anderen Aufgaben, die Sie definieren können, werden andere Bereiche von Visual Studio Application Lifecycle Management definiert, z. B. Team Foundation Build, Visual Studio Lab Management, Test Manager und Team Foundation-Versionskontrolle.

In diesem Thema

  • Syntaxstruktur für Aufgaben

  • Elementverweis für Aufgaben

  • Index für taskXML-Elemente nach Funktion

  • Beispiel: Definieren von Arbeitsaufgabentypen

Syntaxstruktur für Aufgaben

Sie können mehrere Aufgaben in einem Plug-In angeben, und diese Aufgaben weisen möglicherweise gegenseitige Abhängigkeiten auf. Die Aufgaben, die Sie für jedes Plug-In definieren, müssen der Schemadefinition für tasks entsprechen (definiert in der Datei "Tasks.xsd") und in einer eigenen Datei mithilfe des tasks-Containerelements angegeben werden.

Die folgende Syntax zeigt die Struktur auf hoher Ebene des tasks-Elements und der untergeordneten Elemente.

<tasks>
   <task>
      <dependencies>
        <dependency />
        . . .    
      </dependencies />
      <taskXml>
        . . .    
      </taskXml>
   <task/>
</tasks>

Zurück nach oben

Elementverweis für Aufgaben

In der folgenden Tabelle wird jedes Element beschrieben, mit dem die Aufgaben für ein Plug-In definiert werden können.

Element

Syntax

Description

dependencies

 
<dependencies>
<dependency>. . . </dependency>
</dependencies>

Optionales untergeordnetes Element von task.

Gibt andere Gruppen an, von denen eine Gruppe abhängig ist.

dependency

 
<dependency taskId="taskId" />

Optionales untergeordnetes Element von dependencies.

Gibt die ID einer anderen Aufgabe an, von der diese Aufgabe abhängig ist. Die andere Aufgabe muss bereits abgeschlossen sein, bevor diese Aufgabe gestartet werden kann.

ProcessTemplate

 
<ProcessTemplate Type="FileType" Filename="LocalPathAndFileName" 
   Description="FileDescription" 
   ServerPath="UploadLocation" />

Dabei ist jedes Attribut folgendermaßen definiert:

  • Type: Der Typ der Datei, die hochgeladen wird. Folgende Werte sind gültig: Default und Upgrade für Buildvorlagendateien und Custom für Lab-Vorlagendateien.

  • Filename: Der lokale Verzeichnispfad und der Name der hochzuladenden Datei.

  • Description: Eine kurze Textzeichenfolge, die die hochzuladende Datei beschreibt.

  • ServerPath: Der Pfad des Servers, auf dem Team Foundation Server ausgeführt wird, wo die Datei hochgeladen werden soll. Der einzige gültige Uploadort ist $/$$PROJECTNAME$$/BuildProcessTemplates.

Optionales untergeordnetes Element des taskXml-Elements für die Build- und Lab-Plug-Ins.

Gibt Name, Speicherort und Ziel einer hochzuladenden Datei an, um Buildprozesse für ein Teamprojekt zu unterstützen.

task

 
<task id="task id" name="name of task" 
   plugin="Microsoft.ProjectCreationWizard.<PluginName>" 
   completionMessage="SuccessfulCompletionMessage" 
   completionDescription="InProcessMessage">
    <dependencies>. . . </dependencies>
    <taskXml>. . . </taskXml>
</task>

Erforderliches untergeordnetes Element von tasks.

Gibt die Arbeitsschritte an, die zur Konfiguration eines bestimmten Prozesselements in einem neuen Teamprojekt ausgeführt werden müssen.

  • id: Gibt einen Namen an, der die Aufgabe bezeichnet. Wenn eine andere Aufgabe von dieser Aufgabe abhängig ist, verweist sie auf diese ID. Sie müssen einen eindeutigen Wert für die ID innerhalb der Plug-In-Datei zuweisen.

  • name: Beschreibt die Funktion der Aufgabe.

  • plugin: Gibt das Plug-In an, von dem diese Aufgabe ausgeführt werden muss.

  • completionMessage: Gibt die Meldung an, die während der Erstellung des Teamprojekts angezeigt wird und die den Benutzer darüber informiert, dass die Aufgabengruppe erfolgreich abgeschlossen wurde. Die maximale Länge beträgt 256 Zeichen.

  • completionDescription: Gibt die Meldung an, die während der Erstellung des Teamprojekts angezeigt wird und die den Benutzer darüber informiert, dass die Aufgabe gerade verarbeitet wird. Die minimale Länge beträgt 1 Zeichen.

tasks

 
<tasks>
    <task>. . . </task>
</tasks>

Erforderliches untergeordnetes Element von taskXml.

Enthält eine Auflistung von task-Elementen, in denen jeweils die erforderlichen Schritte zum Konfigurieren einer bestimmten Prozesseinstellung eines neuen Teamprojekts angegeben werden.

taskXml

 
<taskXml> . . . </taskXml>

Erforderliches Stammelement für eine Plug-In-Datei.

Beschreibt die Arbeitsschritte, die zur Ausführung dieser Aufgabe erforderlich sind. Die XML in diesem Elementblock variiert abhängig vom jeweiligen Plug-In.

Hinweis

Der Inhalt im Element wird vom XML-Prozessor nicht überprüft.

Zurück nach oben

Index für taskXML-Elemente nach Funktion

Weitere Informationen zu den Merkmalen der XML-Markupelemente, die für jedes Plug-In angegeben werden können, finden Sie in einem der folgenden Themen:

Zurück nach oben

Beispiel: Definieren von Arbeitsaufgabentypen

Im folgenden Beispiel wird eine Aufgabe veranschaulicht, mit der sechs Arbeitsaufgabentypen erstellt werden, indem auf die Definitionsdateien für jeden Typ verwiesen wird.

<task
   id="WITs"
   name="WorkItemType definitions"
   plugin="Microsoft.ProjectCreationWizard.WorkItemTracking"
   completionMessage="WorkItemTypes created"         
   completionDescription = "Processing work item types used by work item tracking">
   <taskXml>
   <WORKITEMTYPES>
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Bug.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\SharedStep.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Task.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestCase.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\UserStory.xml" />
        <WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Issue.xml" />
   </WORKITEMTYPES>
   </taskXml>
</task>

Zurück nach oben

Siehe auch

Konzepte

Definieren der Abhängigkeiten für Aufgabengruppen und Aufgaben in Plug-In-Dateien

Übersicht über Prozessvorlagendateien