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 Rechercher des éléments de travail.
Spécifications
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 décrites dans Définir des autorisations pour les requêtes.
Enregistrer une requête d'élément de travail en tant que fichier .Wiq
Dans Team Explorer, ouvrez la requête que vous voulez enregistrer.
Dans le menu Fichier, choisissez Enregistrer <nom de la requête> [Requête] sous.
Dans la boîte de dialogue Enregistrer la requête sous, choisissez Fichier et spécifiez un emplacement et un nom de fichier pour le fichier .wiq. Vous pouvez également choisir 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.
Créer 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éfinir les tâches racines à l'aide du ficher de plug-in de modèle de processus.
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>
Référence d'é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. 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 renvoyer 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. |