Partager via


Ajouter les requêtes d'élément de travail à un modèle de processus

En ajoutant des requêtes d'élément de travail à votre modèle de processus, vous pouvez définir l'ensemble initial des requêtes partagées et la structure de dossier de requête pour un projet d'équipe. Tous les membres de l'équipe utilisent des requêtes pour rechercher les bogues, tâches et autres éléments de travail sur lesquels ils doivent agir.

Les requêtes d'éléments de travail spécifient un ensemble de critères pour générer une liste d'éléments de travail, tels qu'une liste de bogues actifs ou de tâches fermées. Les fichiers des requêtes d'élément de travail portent l'extension .wiq et sont stockés dans le sous-dossier Queries du dossier WorkItem Tracking pour les modèles de processus Microsoft Solutions Framework (MSF).

Important

Modèles de processus Microsoft définissent plusieurs requêtes.Pour plus d'informations, consultez Requêtes partagées (Scrum), Requêtes partagées (Agile) et Requêtes partagées (CMMI).Les définitions de requête dépendent des champs et des types d'éléments de travail spécifiés dans le modèle de processus.En outre, certains classeurs téléchargés dans le plug-in Portail dépendent des définitions de requête.

Vous spécifiez les définitions de requête à télécharger en tant que tâche dans le plug-in Suivi des éléments de travail. Cette tâche peut être obligatoire car plusieurs artefacts d'un modèle de processus peuvent dépendre d'une requête. En outre, la tâche de téléchargement des requêtes dépend de l'achèvement réussi de la tâche de téléchargement des types d'éléments de travail. Vous spécifiez chaque fichier de requête à télécharger dans l'élément taskXml.

Dans cette rubrique

  • Création d'un fichier pour une requête d'élément de travail

  • Spécification de requêtes à télécharger

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

Une fois un projet d'équipe est créé à partir du modèle de processus, vous pouvez ajouter, supprimer et modifier des requêtes à l'aide de l'éditeur de requête. Pour plus d'informations, consultez Rechercher des éléments de travail.

Pour plus d'informations sur l'assignation d'autorisations de requêtes aux groupes, consultez Contrôler l'accès aux domaines fonctionnels. Pour plus d'informations sur la création de dossiers de requêtes, consultez Définir des objets pour le suivi des éléments de travail à l'aide du plug-in de suivi des éléments de travail.

Création d'un fichier pour une requête d'élément de travail

Chaque définition de requête doit être spécifiée dans son propre fichier portant une extension .wiq, à l'aide de l'élément parent WorkItemQuery, et elle doit être conforme au schéma défini dans le fichier wiq.xsd. Vous pouvez télécharger les fichiers de schéma permettant d'effectuer le suivi des éléments de travail à partir de la page suivante du site Web Microsoft : Process Template and Work Item Schemas for Visual Studio Team Foundation.

L'exemple suivant illustre la structure de la syntaxe de niveau supérieur qui définit une requête d'élément de travail :

<WorkItemQuery Version="1">
<TeamFoundationServer>collectionURL</TeamFoundationServer>
<TeamProject>TeamProjectName</TeamProject>
  <Wiql>
      WorkItemQueryLanguage
  </Wiql>
</WorkItemQuery>

Pour plus d'informations sur la création d'une requête d'élément de travail à ajouter à un modèle de processus, consultez Définir une requête d'élément de travail à ajouter à un modèle de processus.

Retour au début

Spécification de requêtes à télécharger

Pour inclure les requêtes d'élément de travail dans le modèle de processus, créez une ou plusieurs tâches dans le fichier workitems.xml, qui se trouve dans le dossier \WorkItem Tracking, situé dans le dossier où vous avez téléchargé votre modèle de processus. Utilisez l'élément Query pour spécifier le fichier de la requête d'élément de travail. Par exemple, le code XML suivant spécifie la requête définie dans le fichier ActiveBugs.wiq qui doit être téléchargée et nommée Active Bugs.

<Query name="Active Bugs" fileName="WorkItem Tracking\Queries\ActiveBugs.wiq" />

Vous ajoutez l'ensemble de requêtes à télécharger en tant que tâche dans le plug-in Suivi des éléments de travail.

L'exemple suivant montre comment spécifier une tâche consistant à créer un dossier de requêtes nommé Product Management et à télécharger une requête nommée All User Stories dans ce dossier.

<task id="Queries" name="Stored Query Definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage=" Work item queries uploaded" />
   <dependencies>
      <dependency taskId="WITs" />
   </dependencies>
   <taskXml>
      <QUERIES>
         <QueryFolder name="Product Management" >
            <Query name="All User Stories" fileName="WorkItem Tracking\Queries\AllUserStories.wiq" />
         </QueryFolder>
         . . .
      </QUERIES>
   </taskXml>
</task>

Pour plus d'informations, consultez Définir des objets pour le suivi des éléments de travail à l'aide du plug-in de suivi des éléments de travail.

Retour au début

Éléments QUERY

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

<QUERIES>
   <Permission />
   <QueryFolder >
      <Query />
   </QueryFolder>
</QUERIES>

Le tableau suivant décrit les éléments que vous utilisez pour spécifier la structure de dossiers de requêtes, les autorisations et les requêtes à télécharger. Vous spécifiez ces éléments dans un élément conteneur taskXml dans le fichier de plug-in Suivi des éléments de travail.

Élément

Syntaxe

Description

Permission

<permission allow="ListOfPermissions" identity="GroupName" />

Élément enfant facultatif de Query.

Spécifie les autorisations par défaut qui sont affectées aux requêtes partagées. Pour plus d'informations, consultez Assigning Permissions for Work Item Queries.

Query

<Query name="QueryName" fileName="QueryFilePathName" />

Comme le montre l'exemple suivant, vous pouvez télécharger la requête qui s'intitule « Active Bugs » et qui est définie dans le fichier ActiveBugs.wiq :

<Query name="Active Bugs" fileName="WorkItem Tracking\Queries\ActiveBugs.wiq" />

Élément enfant obligatoire de QUERIES.

Spécifie le nom et le chemin d'accès du fichier .wiq qui définit une requête à télécharger.

QueryFolder

<QueryFolder name="FolderName">
   <Query />
</QueryFolder>

Élément enfant facultatif de QUERIES.

Spécifie le nom d'un dossier de requêtes.

QUERIES

<QUERIES>
   . . . 
</QUERIES>

Élément enfant facultatif de l'élément taskXml pour le plug-in Suivi des éléments de travail.

Spécifie les fichiers de définition de requête à utiliser pour créer des requêtes par défaut.

Retour au début

Voir aussi

Concepts

Rechercher des éléments de travail

Définir des objets pour le suivi des éléments de travail à l'aide du plug-in de suivi des éléments de travail