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
Dans Team Explorer, cliquez avec le bouton droit sur la requête, puis cliquez sur Afficher la requête.
Dans le menu Fichier, cliquez sur Enregistrer [requête] <nom de la requête> sous.
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.
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.
Ouvrez le fichier .wiq dans un éditeur de texte.
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.
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 |
|
Élément enfant facultatif de WorkItemQuery. .gif "Remarque importante") 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 |
|
É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 |
|
É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
Historique des modifications
Date |
Historique |
Motif |
|---|---|---|
|
Avril 2011 |
Description de chaque élément WorkItemQuery et retrait des liens vers des rubriques supprimées. |
Améliorations apportées aux informations. |