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

Vous utilisez l'élément tasks et ses éléments enfants pour définir les artefacts à télécharger ou des éléments spécifiques à créer pour un plug-in. Une tâche spécifie le travail à effectuer pour configurer un élément spécifique au processus d'un nouveau projet d'équipe. Un grand nombre des tâches que vous définissez consistent à configurer la structure par défaut d'un projet d'équipe, comme le montre l'illustration suivante. D'autres tâches que vous pouvez définir permettent de configurer d'autres domaines de Visual Studio Application Lifecycle Management, tels que Team Foundation Build, Visual Studio Lab Management, Gestionnaire de tests et contrôle de version Team Foundation.

Dans cette rubrique

• Structure de la syntaxe Tasks

• Référence des éléments Tasks

• Index des éléments taskXML par fonction

• Exemple : Définition de types d'éléments de travail

Structure de la syntaxe Tasks

Vous pouvez spécifier plusieurs tâches dans un plug-in, et ces tâches peuvent avoir des relations de dépendance entre elles. Les tâches que vous définissez pour chaque plug-in doivent être conformes à la définition de schéma pour tasks, définie dans le fichier Tasks.xsd, et être spécifiées dans leur propre fichier à l'aide de l'élément conteneur tasks. Vous pouvez télécharger les fichiers de schéma de modèles de processus à partir de la page suivante du site Web Microsoft : Process Template and Work Item Schemas for Visual Studio Team Foundation.

La syntaxe suivante illustre la structure de niveau supérieur de l'élément tasks et de ses éléments enfants.

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

Retour au début

Référence des éléments Tasks

Le tableau suivant décrit chaque élément qui peut définir les tâches d'un plug-in.

Élément	Syntaxe	Description
dependencies	<dependencies> <dependency>. . . </dependency> </dependencies>	Élément enfant facultatif de task. Spécifie d'autres groupes dont un groupe dépend.
dependency	<dependency taskId="taskId" />	Élément enfant facultatif de dependencies. Spécifie l'ID d'une autre tâche dont dépend cette tâche. L'autre tâche doit s'exécuter pour que cette tâche puisse démarrer.
ProcessTemplate	<ProcessTemplate Type="FileType" Filename="LocalPathAndFileName"    Description="FileDescription"    ServerPath="UploadLocation" /> Chacun des attributs est défini comme suit : Type : type de fichier en cours de téléchargement. Les valeurs valides sont les suivantes : Default et Upgrade pour les fichiers de modèle de build et Custom pour les fichiers de modèle lab. Filename : nom et chemin d'accès au répertoire local du fichier à télécharger. Description : brève chaîne de texte qui décrit le fichier à télécharger. ServerPath : chemin du serveur qui exécute Team Foundation Server où le fichier doit être téléchargé. Le seul emplacement valide pour le téléchargement est $/$$PROJECTNAME$$/BuildProcessTemplates.	Élément enfant facultatif de l'élément taskXml pour les plug-ins Build et Lab. Spécifie le nom, l'emplacement et la destination d'un fichier à télécharger pour prendre en charge les processus de génération d'un projet d'équipe.
task	<task id="task id" name="name of task"    plugin="Microsoft.ProjectCreationWizard.<PluginName>"    completionMessage="SuccessfulCompletionMessage"    completionDescription="InProcessMessage"> <dependencies>. . . </dependencies> <taskXml>. . . </taskXml> </task>	Élément enfant obligatoire de tasks. Spécifie le travail à effectuer pour configurer un élément spécifique au processus d'un nouveau projet d'équipe. id spécifie un nom qui identifie la tâche. Si une autre tâche dépend de cette tâche, elle référence cet ID. Vous devez assigner une valeur unique à l'ID dans le fichier de plug-in. name : décrit l'action de la tâche. plugin : identifie le plug-in qui doit exécuter cette tâche. completionMessage : spécifie le message à afficher lors de la création du projet d'équipe, pour indiquer que le traitement de la tâche s'est terminé correctement. La longueur maximale est de 256 caractères. completionDescription : spécifie le message à afficher lors de la création du projet d'équipe, pour indiquer que la tâche est en cours de traitement. Longueur minimale est de 1 caractère.
tasks	<tasks> <task>. . . </task> </tasks>	Élément enfant obligatoire de taskXml. Contient une collection d'éléments task qui spécifient chacun le travail à effectuer pour configurer un élément spécifique au processus d'un nouveau projet d'équipe.
taskXml	<taskXml> . . . </taskXml>	Élément racine obligatoire pour un fichier de plug-in. Décrit le travail requis pour effectuer cette tâche. L'élément XML contenu dans ce bloc d'éléments varie et est spécifique à chaque plug-in. Remarque Le processeur XML n'essaie pas de valider le contenu dans l'élément.

Retour au début

Index des éléments taskXML par fonction

Pour plus d'informations sur les caractéristiques des éléments de balisage XML que vous pouvez spécifier pour chaque plug-in, consultez l'une des rubriques suivantes :

• Build : Définition de la configuration initiale de Team Foundation Build

• Classifications : Définir les zones et les itérations initiales dans le plug-in Classification

• Groupes et autorisations : Configuration des groupes, des membres et des autorisations initiaux

• Lab : Définir la configuration initiale de Lab Management

• Portail : Définir le plug-in de portail du projet pour un modèle de processus

• Rapports : Ajouter des rapports au modèle de processus

• Gestion des tests : Définition de la configuration initiale du Gestionnaire de tests

• Contrôle de version : Définition de la configuration initiale du contrôle de version Team Foundation

• Suivi des éléments de travail : Définir et personnaliser des objets pour le suivi des éléments de travail en utilisant le plug-in de suivi d'élément de travail

Retour au début

Exemple : Définition de types d'éléments de travail

L'exemple suivant illustre une tâche qui consiste à créer six types d'éléments de travail en référençant les fichiers de définition de chaque type.

<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>

Retour au début

Voir aussi

Concepts

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

Autres ressources

Plug-ins de modèles de processus

Historique des modifications

Date	Historique	Motif
Avril 2011	Texte révisé pour fournir plus d'informations et la structure relatives à la définition des tâches pour un plug-in et à l'utilisation des éléments tasks.	Améliorations apportées aux informations.