Référence des éléments XML du modèle de processus

Article
06/09/2015

Vous pouvez personnaliser le fichier racine d'un modèle de processus pour ajouter ou supprimer des fichiers de plug-in. Le fichier racine définit tous les plug-ins et toutes les tâches qui seront traités par l'Assistant Nouveau projet d'équipe. Pour les modèles de processus Microsoft Solutions Framework (MSF), le fichier racine s'appelle ProcessTemplate et se trouve dans le dossier conteneur des fichiers de modèles de processus. Pour plus d'informations, consultez Vue d'ensemble des fichiers de modèle de processus.

L'élément parent du fichier de plug-in racine est l'élément ProcessTemplate, pour lequel un seul élément metadata et un seul élément groups doivent être définis. Vous devez assigner un nom unique à chaque modèle de processus dans une collection de projets d'équipe, et ce nom ne peut pas comporter plus de 124 caractères Unicode.

Avertissement

Si vous téléchargez un modèle avec le même nom qu'un modèle existant, ce dernier est remplacé.

Dans cette rubrique

Structure de la syntaxe ProcessTemplate
Référence des éléments de métadonnées
Référence des éléments de groupes

Structure de la syntaxe ProcessTemplate

Le plug-in racine des modèles de processus doit être spécifié dans son propre fichier dans l'élément conteneur ProcessTemplate et être conforme au schéma des modèles de processus, lequel est défini dans les fichiers ProcessTemplate.xsd et ProcessTemplateItem.xsd. Vous pouvez télécharger les fichiers de schéma de modèles de processus à partir de la page suivante du site Web Microsoft : Schémas de modèles de processus et d'éléments de travail pour Visual Studio Team Foundation.

L'exemple suivant illustre la structure de l'élément racine ProcessTemplate. Pour obtenir un exemple plus complet, consultez Définir les tâches racines à l'aide du ficher de plug-in de modèle de processus.

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

Référence des éléments de métadonnées

La syntaxe suivante illustre la structure de l'élément metadata et de ses éléments enfants.

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

Élément	Syntaxe	Description
description	`<description>ProcessTemplateDescription</description>`	Élément enfant obligatoire de metadata. Définit le texte descriptif qui s'affiche dans l'Assistant Nouveau projet d'équipe pour le modèle de processus.
metadata	`<metadata> <name> . . . </name> <description> . . . </description> <plugins> . . . </plugins> </metadata>`	Élément enfant obligatoire de ProcessTemplate. Élément conteneur permettant de spécifier les informations nécessaires au traitement du plug-in par l'Assistant Nouveau projet d'équipe.
name	`<name>ProcessTemplateName</name>`	Élément enfant obligatoire de metadata. Définit le nom du modèle de processus, qui doit être unique dans la collection de projets d'équipe. La longueur maximale du nom est de 124 caractères.
plugin	`<plugin name="Microsoft.ProjectCreationWizard.PluginName wizardPage="true \| false" />`	Élément enfant obligatoire de plugins. Spécifie le nom d'un fichier de plug-in à inclure dans la création du modèle du processus et indique si le plug-in doit avoir une page visible dans l'Assistant Nouveau projet d'équipe.
plugins	`<plugins> <plugin> . . . </plugin> </plugins>`	Élément enfant obligatoire de metadata. Élément conteneur qui définit les plug-ins pour le modèle de processus.
version	`<version type="ID" major="Number1" minor="Number2 " />`	Élément enfant facultatif de metadata. Spécifie un identificateur unique et des nombres de révision majeure et mineure pour identifier la version du modèle de processus.

Référence des éléments de groupes

La syntaxe suivante illustre la structure de l'élément groups et de ses éléments enfants.

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

Élément	Syntaxe	Description
dependencies	`<dependencies> <dependency>. . . </dependency> </dependencies>`	Élément enfant obligatoire de group. Spécifie les dépendances du groupe vis-à-vis d'autres groupes.
dependency	`<dependency groupId="groupId" />`	Élément enfant facultatif de dependencies. Spécifie l'ID d'un autre groupe de tâches dont ce groupe dépend. L'autre groupe doit exécuter ses tâches pour que ce groupe de tâches puisse démarrer.
group	`<group id="TaskGroupId" description="TaskGroupDescription" completionMessage="SuccessMessage" failureMessage="FailureMessage"> <dependencies> . . . <dependencies> <taskList> . . . </taskList> </group>`	Élément enfant obligatoire de groups. Identifie un jeu de tâches pour un plug-in à exécuter lors de la création du projet. Les valeurs suivantes sont valides pour chaque attribut : ID : spécifie un nom qui identifie le groupe de tâches. Si une autre groupe de tâches dépend de ce groupe, il fait référence à cet ID. Vous devez assigner une valeur unique à l'ID dans le fichier de plug-in. description : spécifie le message permettant d'indiquer, lors de la création du projet d'équipe, que le groupe de tâches est en cours de traitement. completionMessage : spécifie le message permettant d'indiquer, lors de la création du projet d'équipe, que le traitement du groupe de tâches s'est terminé correctement. La longueur maximale est de 256 caractères. failureMessage : spécifie le message permettant d'indiquer, lors de la création du projet d'équipe, que le traitement du groupe de tâches a échoué.
groups	`<groups> <group> . . . </group> </groups>`	Élément enfant obligatoire de ProcessTemplate. Élément conteneur qui définit l'ensemble des groupes de tâches qui s'exécuteront pendant la création du projet.
tasklist	`<taskList filename="filePath" />`	Spécifie un fichier XML qui contient la liste des tâches à exécuter. La liste de tâches d'un groupe doit toujours être dans un fichier XML séparé. Pour plus d'informations sur la spécification de ces fichiers, consultez Définir les tâches pour traiter un plug-in.

Voir aussi

Concepts

Vue d'ensemble des fichiers de modèle de processus

Définir les tâches pour traiter un plug-in

Définir les dépendances pour les groupes de tâches et les tâches dans les fichiers de plug-in

Personnaliser un modèle de processus

Définir les tâches racines à l'aide du ficher de plug-in de modèle de processus

Partager via