Prozessvorlagen-XML-Elementverweis

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Wichtig

Dieser Artikel bezieht sich auf die Projektanpassung für lokale XML-Prozessmodelle. Eine Übersicht über Prozessmodelle finden Sie unter Anpassen ihrer Arbeitsnachverfolgungserfahrung.

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 zum Erstellen eines Projekts in Azure DevOps Services oder einem lokalen Team Foundation Server (TFS) verwendet werden. Die Stammdatei "ProcessTemplate" genannt, befindet sich im Ordner "Container" 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 Metadaten- und ein Gruppenelement definiert sein müssen. Sie müssen jeder Prozessvorlage innerhalb einer Projektsammlung einen eindeutigen Namen zuweisen, und der Name darf nicht länger als 124 Unicode-Zeichen sein.

Hinweis

Für das Gehostete XML-Prozessmodell: Wenn Sie eine Prozessvorlage mit dem gleichen Namen und der gleichen GUID wie ein vorhandener Prozess importieren, wird der vorhandene Prozess zusammen mit allen Projekten aktualisiert, die auf diesen Prozess verweisen.

Für lokales XML-Prozessmodell: Wenn Sie eine Prozessvorlage mit dem gleichen Namen wie eine vorhandene Vorlage hochladen, wird die vorhandene Vorlage überschrieben.

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 folgende Beispiel zeigt die Struktur des ProcessTemplate-Stammelements. Ein ausführlicheres Beispiel finden Sie unter Definieren der Stammaufgaben.

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

Metadaten-Elementverweis

Die folgende Syntax zeigt die Struktur des Metadatenelements und seiner untergeordneten Elemente.

<metadata>  
    <name>ProcessTemplateName</name>  
    <description>ProcessTemplateDescription </description>  
    <version type="ID" major="Number1" minor="Number2" />  
    <plugins>  
      <plugin name="Microsoft.ProjectCreationWizard.pluginID" wizardPage="true | false" />  
. . .  
    </plugins>  
</metadata>  
Element Beschreibung und Syntax
description Erforderliches untergeordnetes Element der Metadaten. Definiert den Text der Beschreibung, die im Assistenten für neue Teamprojekte für die Prozessvorlage angezeigt wird.
<description>ProcessTemplateDescription</description>
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.
<metadata>
<name> . . . </name>
<description> . . . </description>
<version type="ID" major="Number1" minor="Number2/>
<plugins> . . . </plugins>
</metadata>
name Erforderliches untergeordnetes Element der Metadaten. Definiert den Namen der Prozessvorlage, die in der gesamten Projektsammlung eindeutig sein muss. Die maximale Länge des Namens beträgt 124 Zeichen.
<name>ProcessTemplateName</name>
Plugin Erforderliches untergeordnetes Element der Plug-Ins. 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.
<plugin name="Microsoft.ProjectCreationWizard.PluginName wizardPage="true &#124; false" />
Plugins Erforderliches untergeordnetes Element der Metadaten. Containerelement, mit dem die Plug-Ins für die Prozessvorlage definiert werden.
<plugins>
<plugin> . . . </plugin>
</plugins>
version Erforderliches untergeordnetes Element der Metadaten. Gibt eine eindeutige ID sowie Haupt- und Nebenrevisionsnummern an, um die Version der Prozessvorlage zu identifizieren.
<version type="ID" major="Number1" minor="Number2 " />

Gruppenelementverweis

Die folgende Syntax zeigt die Struktur des Groups-Elements und seiner untergeordneten Elemente.

<groups>  
      <group id="groupId" description="GroupDescription" completionMessage="SuccessMessage">  
      <dependencies>   
         <dependency groupId="dependentGroupId" />  
. . .  
      </dependencies>  
      <taskList filename="RelativePathAndFileName" />  
      </group>  
. . .  
</groups>  
Element Beschreibung und Syntax
dependencies Erforderliches untergeordnetes Element der Gruppe. Legt die Abhängigkeiten dieser Gruppe von anderen Gruppen fest.
<dependencies>
<dependency>. . . </dependency>
</dependencies>
Abhängigkeit Optionales untergeordnetes Element von Abhängigkeiten. 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.
<dependency groupId="groupId" />
group Erforderliches untergeordnetes Element von Gruppen. 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:
- - Gibt einen Namen an, der die Aufgabengruppe identifiziert. 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.
- - Gibt die Meldung an, die während der Projekterstellung angibt, dass die Aufgabengruppe verarbeitet wird.
- - Gibt die Meldung an, die während der Projekterstellung angibt, dass die Aufgabengruppe erfolgreich abgeschlossen wurde. Die maximale Länge beträgt 256 Zeichen.
- - Gibt die Meldung an, die während der Projekterstellung angibt, dass die Aufgabengruppe nicht erfolgreich abgeschlossen werden konnte.

<group id="TaskGroupId" description="TaskGroupDescription" completionMessage="SuccessMessage" failureMessage="FailureMessage">
<dependencies> . . . <dependencies>
<taskList> . . . </taskList>
</group>
Gruppen Erforderliches untergeordnetes Element von ProcessTemplate. Containerelement, das den Satz der Aufgabengruppen definiert, die während der Projekterstellung ausgeführt werden.
<groups>
<group> . . . </group>
</groups>
tasklist 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 zum Angeben dieser Dateien finden Sie unter Definieren der Aufgaben zum Verarbeiten eines Plug-Ins.
<taskList filename="filePath" />