Prozessvorlagen-XML-Elementverweis

Artikel
05/16/2015

Sie können die Stammdatei für eine Prozessvorlage anpassen, um Plug-In-Dateien hinzuzufügen oder zu entfernen. Die Stammdatei definiert alle Plug-Ins und Aufgaben, die der Assistent für neue Teamprojekte verarbeitet. Für die Prozessvorlagen für Microsoft Solutions Framework (MSF) wird die Stammdatei "ProcessTemplate" genannt. Sie befindet sich im Containerordner für die Prozessvorlagendateien. Weitere Informationen finden Sie unter Übersicht über Prozessvorlagendateien.

Das übergeordnete Element der Stamm-Plug-In-Datei ist das ProcessTemplate-Element, für das nur ein groups-Element und metadata-Element definiert sein muss. Sie müssen jeder Prozessvorlage einen eindeutigen Namen innerhalb einer Teamprojektsammlung zuweisen, und der Name darf maximal 124 Unicode-Zeichen enthalten.

Warnung

Wenn Sie eine Vorlage hochladen, die den gleichen Namen wie eine bereits vorhandene Vorlage hat, wird die vorhandene überschrieben.

In diesem Thema

ProcessTemplate-Syntaxstruktur
Metadaten-Elementverweis
Gruppenelementverweis

ProcessTemplate-Syntaxstruktur

Das Stamm-Plug-In für Prozessvorlagen muss in einer eigenen Datei im ProcessTemplate-Containerelement angegeben werden und dem Schema für Prozessvorlagen entsprechen, das in den Dateien "ProcessTemplate.xsd" und "ProcessTemplateItem.xsd" definiert ist. 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.

Im folgenden Beispiel wird die Struktur des ProcessTemplate-Stammelements veranschaulicht. Ein ausführlicheres Beispiel finden Sie unter Definieren der Stammaufgaben mit der Plug-In-Datei für Prozessvorlagen.

<?xml version="1.0" encoding="utf-8"?>
<ProcessTemplate>
   <metadata> . . . </metadata>
   <groups> . . .</groups>
</ProcessTemplate>

Metadaten-Elementverweis

Die folgende Syntax zeigt die Struktur des metadata-Elements und der untergeordneten Elemente.

<metadata>
    <name>ProcessTemplateName</name>
    <description>ProcessTemplateDescription </description>
    <plugins>
      <plugin name="Microsoft.ProjectCreationWizard.pluginID" wizardPage="true | false" />
. . .
    </plugins>
</metadata>

Element	Syntax	Beschreibung
description	`<description>ProcessTemplateDescription</description>`	Erforderliches untergeordnetes Element von metadata. Definiert den Text der Beschreibung, die im Assistenten für neue Teamprojekte für die Prozessvorlage angezeigt wird.
metadata	`<metadata> <name> . . . </name> <description> . . . </description> <plugins> . . . </plugins> </metadata>`	Erforderliches untergeordnetes Element von ProcessTemplate. Containerelement zur Angabe der erforderlichen Informationen für das Plug-In, das vom Assistenten für neue Teamprojekte verarbeitet wird.
name	`<name>ProcessTemplateName</name>`	Erforderliches untergeordnetes Element von metadata. Definiert den Namen der Prozessvorlage, die in der Teamprojektsammlung eindeutig sein muss. Die maximale Länge des Namens beträgt 124 Zeichen.
plugin	`<plugin name="Microsoft.ProjectCreationWizard.PluginName wizardPage="true \| false" />`	Erforderliches untergeordnetes Element von plugins. Gibt den Namen einer Plug-In-Datei an, die in die Erstellung der Prozessvorlage eingebunden werden soll, und legt fest, ob im Assistenten für neue Teamprojekte eine Seite für das Plug-In angezeigt werden soll.
plugins	`<plugins> <plugin> . . . </plugin> </plugins>`	Erforderliches untergeordnetes Element von metadata. Containerelement, mit dem die Plug-Ins für die Prozessvorlage definiert werden.
version	`<version type="ID" major="Number1" minor="Number2 " />`	Optionales untergeordnetes Element von metadata. Gibt eine eindeutige ID und Haupt- und Nebenrevisionsnummern an, um die Version der Prozessvorlage zu identifizieren.

Gruppenelementverweis

Die folgende Syntax zeigt die Struktur des groups-Elements und der untergeordneten Elemente.

<groups>
   <group id="groupId" description="GroupDescription" completionMessage="SuccessMessage">
      <dependencies> 
         <dependency groupId="dependentGroupId" />
. . .
      </dependencies>
      <taskList filename="RelativePathAndFileName" />
   </group>
. . .
</groups>

Element	Syntax	Beschreibung
dependencies	`<dependencies> <dependency>. . . </dependency> </dependencies>`	Erforderliches untergeordnetes Element von group. Legt die Abhängigkeiten dieser Gruppe von anderen Gruppen fest.
dependency	`<dependency groupId="groupId" />`	Optionales untergeordnetes Element von dependencies. Gibt die ID einer anderen Aufgabengruppe an, von der diese Gruppe abhängig ist. Die andere Gruppe muss ihre Aufgaben abschließen, bevor diese Aufgabengruppe gestartet werden kann.
group	`<group id="TaskGroupId" description="TaskGroupDescription" completionMessage="SuccessMessage" failureMessage="FailureMessage"> <dependencies> . . . <dependencies> <taskList> . . . </taskList> </group>`	Erforderliches untergeordnetes Element von groups. Definiert eine Reihe von Aufgaben für ein Plug-In, die während der Projekterstellung ausgeführt werden. Die folgenden Werte sind für jedes Attribut gültig: id: Gibt einen Namen an, durch den die Aufgabengruppe bezeichnet wird. Wenn eine andere Aufgabengruppe 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. description: Gibt eine Meldung an, um den Benutzer während der Erstellung des Teamprojekts zu informieren, dass die Aufgabengruppe verarbeitet wird. completionMessage: Gibt eine Meldung an, um den Benutzer während der Erstellung des Teamprojekts zu informieren, dass die Aufgabengruppe erfolgreich abgeschlossen wurde. Die maximale Länge beträgt 256 Zeichen. failureMessage: Gibt eine Meldung an, um den Benutzer während der Erstellung des Teamprojekts zu informieren, dass die Aufgabengruppe nicht erfolgreich abgeschlossen werden konnte.
groups	`<groups> <group> . . . </group> </groups>`	Erforderliches untergeordnetes Element von ProcessTemplate. Containerelement, das den Satz der Aufgabengruppen definiert, die während der Projekterstellung ausgeführt werden.
tasklist	`<taskList filename="filePath" />`	Gibt eine XML-Datei an, die die Liste der auszuführenden Aufgaben enthält. Die Liste der Aufgaben für eine Gruppe muss immer in einer separaten XML-Datei enthalten sein. Weitere Informationen zur Angabe dieser Dateien finden Sie unter Definieren der Aufgaben zum Verarbeiten eines Plug-Ins.

Siehe auch

Konzepte

Übersicht über Prozessvorlagendateien

Definieren der Aufgaben zum Verarbeiten eines Plug-Ins

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

Anpassen einer Prozessvorlage

Definieren der Stammaufgaben mit der Plug-In-Datei für Prozessvorlagen

Freigeben über