Définir une requête d'élément de travail à ajouter à un modèle de processus

Vous pouvez plus facilement créer un fichier de requête d'élément de travail (.wiq) dans Team Explorer. Dans un projet d'équipe existant, vous pouvez utiliser Team Explorer pour créer toutes les requêtes d'élément de travail que vous souhaitez ajouter à votre modèle de processus, puis suivre les étapes de cette rubrique pour enregistrer chaque requête en tant que fichier .wiq. Pour plus d'informations sur la création de requêtes d'éléments de travail, consultez Spécifier des critères de filtre de requête.

Dans cette rubrique

• Enregistrement d'une requête d'élément de travail en tant que fichier .Wiq

• Création d'une requête d'élément de travail qui fait référence à un chemin d'itération

• Exemple de requête d'élément de travail spécifique à une itération

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

Autorisations requises

Pour créer une requête, vous devez être membre du groupe Readers ou disposer de l'autorisation Afficher les éléments de travail dans ce nœud avec la valeur Autoriser pour chaque projet d'équipe dans la requête. Pour enregistrer une requête en tant que requête d'équipe, vous devez disposer des autorisations appropriées. Pour plus d'informations, consultez Organiser les requêtes d'élément de travail et définir les autorisations associées.

Enregistrement d'une requête d'élément de travail en tant que fichier .Wiq

Pour enregistrer une requête d'élément de travail dans un fichier .wiq

1. Dans Team Explorer, cliquez avec le bouton droit sur la requête, puis cliquez sur Afficher la requête.

2. Dans le menu Fichier, cliquez sur Enregistrer [requête] <nom de la requête> sous.

3. Dans la boîte de dialogue Enregistrer la requête sous, cliquez sur Fichier et spécifiez un emplacement et un nom de fichier pour le fichier .wiq. Vous pouvez également cliquer sur Parcourir, spécifier un nom de fichier, accéder à l'emplacement pour enregistrer le fichier, puis cliquer sur Enregistrer.

4. Copiez le fichier dans le dossier \WorkItem Tracking\Queries, qui est situé dans le dossier où vous avez téléchargé votre modèle de processus.

5. Ouvrez le fichier .wiq dans un éditeur de texte.

6. Supprimez les éléments <TeamFoundationServer> et <TeamProject> qui associent la requête à un serveur spécifique qui exécute Visual Studio Team Foundation Server et un projet d'équipe spécifique, comme le montre l'exemple suivant :

   <TeamFoundationServer>CollectionURL</TeamFoundationServer>
   <TeamProject>ProjectName</TeamProject>
   

   Notes

   Vous devez modifier le fichier .wiq dans un éditeur de texte et supprimer les éléments <TeamFoundationServer> et <TeamProject> qui associent la requête à un serveur et un projet d'équipe spécifiques. Sinon, la requête ne fonctionnera pas correctement si le modèle de processus est téléchargé vers un serveur différent. Vous pouvez également utiliser des macros chaque fois que possible afin que votre requête ne contienne pas le nom explicite du projet d'équipe actuel ni d'autres valeurs spécifiques à un environnement précis.

7. Supprimez tout élément supplémentaire spécifique à un utilisateur.

Retour au début

Création d'une requête d'élément de travail qui fait référence à un chemin d'itération

Vous pouvez définir une requête qui fait référence à un chemin d'itération spécifique en incluant la macro pour le projet d'équipe, $$PROJECTNAME$$, et le nom d'un chemin d'itération défini dans le fichier de plug-in Classification. Par exemple, la syntaxe suivante spécifie une requête qui inclut uniquement les éléments de travail dont le chemin d'itération se trouve sous Itération 1.

AND  [Source].[System.IterationPath] UNDER '$$PROJECTNAME$$\Iteration 1'

Lorsque le projet d'équipe est créé, la macro est remplacée par le nom du projet d'équipe.

En utilisant cette macro, vous pouvez définir des classeurs qui font référence à des chemins d'itération spécifiques. Le modèle de processus pour MSF Agile Software Development contient une requête spécifique à l'itération, Iteration1Backlog.wiq, qui prend en charge le classeur spécifique à l'itération, Iteration Backlog.xlsm.

Lorsque vous téléchargez des requêtes spécifiques à des itérations, la tâche consistant à traiter le fichier Classification.xml doit être terminée avant la tâche visant à traiter les fichiers de requêtes. Pour plus d'informations, consultez Définir les zones et les itérations initiales dans le plug-in Classification et Définition des tâches racines à l'aide du ficher de plug-in de modèle de processus.

Retour au début

Exemple de requête d'élément de travail spécifique à une itération

L'exemple suivant présente la requête d'élément de travail Iteration1Backlog qui prend en charge le classeur du journal des itérations en souffrance.

<?xml version="1.0" encoding="utf-8"?>
<WorkItemQuery Version="1">
  <Wiql>
    SELECT [System.Id],
           [System.WorkItemType],
           [System.Title],
           [System.State],
           [System.AssignedTo],
           [Microsoft.VSTS.Scheduling.RemainingWork],
           [Microsoft.VSTS.Scheduling.CompletedWork],
           [Microsoft.VSTS.Scheduling.StoryPoints],
           [Microsoft.VSTS.Common.StackRank],
           [Microsoft.VSTS.Common.Priority],
           [Microsoft.VSTS.Common.Activity],
           [System.IterationPath],
           [System.AreaPath]
      FROM WorkItemLinks
     WHERE (Source.[System.TeamProject] = @project 
       AND  [Source].[System.AreaPath] UNDER @project
       AND  [Source].[System.IterationPath] UNDER '$$PROJECTNAME$$\Iteration 1'
       AND (
               Source.[System.WorkItemType] = 'User Story' 
            OR Source.[System.WorkItemType] = 'Task'
           )
           )
       AND [System.Links.LinkType] = 'System.LinkTypes.Hierarchy-Forward'
       AND [Target].[System.WorkItemType] = 'Task'
       ORDER BY [Microsoft.VSTS.Common.StackRank], [Microsoft.VSTS.Common.Priority]
       mode(Recursive)
  </Wiql>
</WorkItemQuery>

Retour au début

Référence des éléments WorkItemQuery

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

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

Élément	Syntaxe	Description
TeamFoundationServer	<TeamFoundationServer>collectionURL </TeamFoundatonServer>	Élément enfant facultatif de WorkItemQuery. Important En général, vous supprimez cet élément des requêtes que vous ajoutez aux modèles de processus. Spécifie l'URI de la collection de projets d'équipe au format suivant : http://NomServeur:Port/NomRépertoireVirtuel/NomCollection En l'absence de répertoire virtuel, utilisez le format suivant pour l'URI : http://NomServeur:Port/NomCollection L'attribut est de type ServerNameType et ne doit pas comporter plus de 2047 caractères.
TeamProject	<TeamProject>TeamProjectName</TeamProject>	Élément enfant facultatif de WorkItemQuery. Important En général, vous supprimez cet élément des requêtes que vous ajoutez aux modèles de processus. Spécifie le projet d'équipe sur lequel exécuter la requête. L'attribut est de type ProjectNameType et ne doit pas comporter plus de 255 caractères.
Wiql	<Wiql>WorkItemQueryLanguage</Wiql>	Élément enfant obligatoire de WorkItemQuery. Spécifie une séquence de commandes SQL ( Structured Query Language) qui agissent comme des critères de filtre pour rechercher un ensemble d'éléments de travail dans un projet d'équipe et retourner les valeurs qui sont assignées à un nombre défini de champs. Les modèles de processus MSF fournissent plusieurs exemples de commandes SQL prises en charge par l'élément Wiql. Ces fichiers se trouvent dans le sous-dossier Queries du dossier WorkItem Tracking. Pour plus d'informations sur la définition des requêtes, consultez Recherche de bogues, de tâches et d'autres éléments de travail.

Retour au début

Voir aussi

Concepts

Recherche de bogues, de tâches et d'autres éléments de travail

Autres ressources

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

Historique des modifications