Rechercher des éléments de travail
Les requêtes vous aident à trouver des éléments de travail que vous voulez consulter, trier, mettre à jour ou pour lesquels vous voulez générer un rapport.
Utilisez la zone de recherche pour rechercher des éléments de travail. Entrez l'ID ou utilisez des filtres. Si vous souhaitez une liste plate d'éléments de travail, une liste hiérarchique à l'aide d'une requête d'arborescence ou une liste indiquant les dépendances à l'aide d'une requête de liens directs, utilisez l'Éditeur de requêtes afin de choisir le type de requête.
Vous pouvez créer des requêtes dans Visual Studio Online, Team Web Access (TWA) et Team Explorer. Vous pouvez également ouvrir une requête dans Excel ou Projet pour effectuer des modifications en bloc.
Utilisez la zone de recherche pour rechercher un élément de travail d'après son ID
Tapez l'ID dans la zone de recherche d'éléments de travail, puis cliquez sur l'icône de recherche.
.png "Zone de texte Rechercher les éléments de travail")
À l'aide .png "Icône du menu contextuel")
du menu contextuel, vous pouvez ajouter des filtres aux éléments de liste basés sur une assignation, un état, un mot clé ou un type d'élément de travail.
Par exemple, entrez A=@Me T=Task pour répertorier toutes les tâches qui vous sont assignées.
Ouvrir et modifier une requête de liste plate
La façon la plus facile de définir une requête consiste à utiliser une requête partagée existante. L'exemple suivant montre comment rechercher tous les bogues fermés en modifiant la requête partagée Bogues actifs fournie par le modèle de processus Agile. Les exemples sont basés sur l'interface utilisateur fournie par le navigateur web.
Ouvrez une requête partagée. Par exemple, ouvrez la requête Bogues actifs ou une requête de liste plate similaire.
.png "Ouvrir une requête partagée, par exemple Bogues actifs")
Modifiez la requête pour rechercher des bogues fermés puis exécutez la requête. Utilisez
.png "Ajouter une pièce jointe")
(Insérer une nouvelle ligne de filtre) pour insérer une clause au-dessus de la clause actuelle. Utilisez .png "Supprimer la clause")
(Supprimer la ligne de filtre) pour supprimer une clause..png "Vue de l'éditeur d'une requête de liste plate")
Enregistrez la requête dans votre dossier Mes requêtes.
.png "Enregistrer la requête sous, Dossier=Mes requêtes")
Pour enregistrer une requête dans le dossier des requêtes partagées, vous devez être administrateur d'équipe, membre du groupe Project Administrators, ou avoir les autorisations de Collaboration sur ce dossier définies sur Autoriser.
Créer une requête
Partez du menu Nouveau de la page des requêtes dans TWA, ou de la page des éléments de travail dans Team Explorer.
.png "Ouvrir une nouvelle requête")
Grouper les clauses pour affiner votre liste
Les clauses groupées fonctionnent comme une unité distincte du reste de la requête ; cela équivaut à mettre entre parenthèses une équation mathématique ou une expression logique. L'opérateur And ou Or de la première clause du groupe s'applique à l'ensemble du groupe.
Dans l'exemple suivant, la première expression retourne tous les éléments de travail qui sont de priorité 1 et tous les bogues actifs, quelle qu'en soit la priorité. La seconde expression retourne tous les éléments de travail de priorité 1 actifs et tous les bogues de priorité 1, qu'ils soient actifs ou pas.
Clauses regroupées |
Expression logique |
|---|---|
.png "Filtrer à l'aide d'une expression logique ou/et") |
Priority=1 OR (Work Item Type=Bug AND State=Active) |
.png "Filtrer à l'aide d'une expression logique et/ou") |
Priority=1 AND (Work Item Type=Bug OR State=Active) |
Pour grouper plusieurs clauses, sélectionnez-les, puis cliquez sur l'icône de groupe de clauses .png "Regrouper la clause de requête"){kind=icon}
.
.png "Regrouper les clauses de requêtes sélectionnées")
Si vos résultats de requête ne retournent pas le jeu d'éléments de travail que vous attendiez, effectuez les étapes suivantes :
Vérifiez que chaque clause est bien définie comme prévu.
Vérifiez les affectations Et/Ou de chaque clause. Si vos résultats contiennent plus d'éléments de travail que prévu, il arrive souvent qu'une clause Ou soit présente au lieu d'une clause Et.
Déterminez si vous devez regrouper ou modifier le regroupement des clauses de requête, ainsi que les assignations Et/Ou de chaque clause regroupée.
Ajoutez d'autres clauses de requête pour affiner vos critères de filtre de requête.
Examinez les options disponibles pour spécifier des champs, des opérateurs et des valeurs.
Utiliser une requête d'arborescence pour afficher une liste hiérarchique
Utilisez la requête d'arborescence (.png "Requête d'arborescence"){kind=icon}
) pour afficher une liste multicouches et imbriquée d'éléments de travail. Par exemple, vous pouvez afficher tous les éléments de backlog et leurs tâches liées.
.png "Liste de résultats affichant une requête d'arborescence")
Développez (.png "Développer le nœud (Team Web Access)")
) ou réduisez (.png "Réduire le nœud (Team Web Access)")
) les nœuds terminaux pour vous concentrer sur les différentes parties de l'arborescence.
Définissez les critères de filtre pour les éléments de travail parents et enfants.
.png "Filtres de la requête d'arborescence")
Pour rechercher les enfants liés, sélectionnez Trouver d'abord les éléments de travail de niveau supérieur. Pour rechercher les parents liés, sélectionnez Trouver d'abord les éléments de travail liés.
Utiliser une requête de lien direct pour consulter les dépendances
Utilisez la requête de liens directs (.png "Requête de liens directs"){kind=icon}
) pour suivre les éléments de travail qui dépendent d'un autre travail suivi, tel que les tâches, les bogues, les problèmes ou les fonctionnalités. Par exemple, vous pouvez afficher les éléments du backlog qui dépendent d'autres éléments en implémentation ou d'un bogue en cours de résolution.
.png "Résultats de la requête de liens directs")
Utilisez une requête de liens directs pour suivre les dépendances de votre équipe sur lesquelles travaillent d'autres équipes ou gérer les engagements que votre équipe a pris auprès d'autres équipes. Spécifiez les critères de filtre pour les éléments de travail de niveau supérieur et liés, et sélectionnez les types de liens utilisés pour filtrer les dépendances.
.png "Éditeur de la requête de liens directs")
Filtrez votre liste de première couche d'éléments de travail à l'aide de l'une des options suivantes :
Retourner uniquement les éléments ayant les liens spécifiés : les éléments de travail de la première couche sont retournés, mais seulement s'ils ont des liens vers les éléments de travail spécifiés par les critères du filtre des éléments de travail liés.
Retourner tous les éléments de travail de niveau supérieur : tous les éléments de travail de la première couche sont retournés indépendamment des critères de filtre d'éléments de travail liés. Les éléments de travail de la deuxième couche qui sont liés à ceux de la première couche sont retournés s'ils répondent aux critères du filtre des éléments de travail liés.
Retourner uniquement les éléments qui n'ont pas les liens spécifiés : les éléments de travail de la première couche sont retournés, mais seulement s'ils n'ont pas de liens vers les éléments de travail spécifiés par les critères du filtre des éléments de travail liés.
Q et R
Q : quels opérateurs et variables de requête puis-je utiliser ?
R : les opérateurs et les variables disponibles à la sélection dépendent du champ que vous avez sélectionné. Les quatre variables sont @Project pour le champ de nom du projet, @Me pour les champs de noms de personnes, @Today pour les champs date-heure et [Tous]. Consultez Champs de requête, opérateurs, valeurs et variables.
Q : quels sont les autres exemples de requête qui existent ?
R : consultez Exemple de requêtes d'élément de travail et Exemple de requêtes de zone de recherche.
Q : comment établir un graphique des résultats d'une requête ?
R : dans Visual Studio Online et TWA, vous pouvez mettre en graphique les résultats de n'importe quelle requête de liste plate. Vous devez être membre du groupe d'accès avancé dans TWA.
Sinon, vous pouvez ouvrir une requête dans Excel et utiliser les fonctionnalités d'Excel pour générer un graphique.
Q : comment mettre à jour automatiquement des requêtes en fonction de l'itération ou du sprint actuel ?
R : il n'existe aucun moyen automatisé d'effectuer cette opération ; vous devez mettre à jour manuellement les requêtes afin qu'elles pointent vers le sprint actuel. Si vous avez un projet d'équipe Scrum ou Agile, vous trouverez un ensemble de requêtes dans les dossiers Sprint actuel ou Itération actuelle. Pour que chaque requête retourne les éléments définis pour le sprint actuel, vous devez mettre à jour le chemin de l'itération actuelle en fonction de la date.
Vous pouvez modifier plusieurs de vos requêtes en les enregistrant sous forme de fichiers .wiq. Ouvrez la requête dans Team Explorer, choisissez Modifier la requête, puis Fichier, Enregistrer sous pour sauvegarder chaque requête sous forme de fichier .wiq. Voici l'exemple de la requête Travail en cours qui a été mise à jour pour prendre en charge Release 2\Sprint 59.
<?xml version="1.0" encoding="utf-8"?>
<WorkItemQuery Version="1">
<Wiql>
SELECT [System.Id],
[System.WorkItemType],
[System.Title],
[System.AssignedTo],
[System.State],
[Microsoft.VSTS.Scheduling.RemainingWork],
FROM WorkItems
WHERE [System.TeamProject] = @project and
[System.IterationPath] under 'FabrikamPrime\Release 2\Sprint 59' and
[System.WorkItemType] in group 'Microsoft.TaskCategory' and
[System.State] = 'In Progress'
ORDER BY [System.AssignedTo],
[Microsoft.VSTS.Common.BacklogPriority],
[System.Id]
</Wiql>
</WorkItemQuery>
Q : comment ajouter ou modifier des colonnes de la liste des résultats ?
R : ouvrez Options de colonne pour ajouter ou supprimer des colonnes, modifier la séquence des colonnes et modifier l'ordre de tri dans une colonne.
.png "Onglet d'affichage de colonnes dans la boîte de dialogue Options de colonne")
En outre, dans la liste des résultats, vous pouvez faire glisser une colonne vers une nouvelle position et sélectionner l'en-tête de la colonne pour en modifier l'ordre de tri.
Q : puis-je filtrer une requête à l'aide de balises ?
R : oui, si vous utilisez Visual Studio Online ou si votre version locale de TFS contient les mises à jour ajoutées avec TFS 2013 Update 2. Sinon, pas pour les déploiements locaux.
Pour Visual Studio Online et avec Visual Studio 2013 Update 2, vous pouvez filtrer sur le champ Balises. En outre, vous pouvez ouvrir une requête à partir d'Excel et modifier en bloc les balises assignées aux éléments de travail. Vous pouvez aussi ajouter des balises à des éléments de travail à l'aide de Visual Studio.
À partir du plug-in Team Explorer pour Eclipse, vous pouvez filtrer les requêtes par balises, toutefois, vous ne pouvez pas ajouter ou modifier des balises à partir de l'interface utilisateur. Vous devez utiliser le portail web pour ajouter et modifier des balises.
Pour une version locale de TFS sans TFS 2013 Update 2, vous pouvez afficher les balises sous forme de colonne dans les résultats de la requête et filtrer une liste en fonction d'une balise, mais vous ne pouvez pas ajouter des balises en tant que clause aux critères du filtre.
Q : puis-je utiliser les résultats de requêtes pour modifier rapidement les relations liées ?
R : à partir du plug-in Team Explorer pour Visual Studio, vous pouvez appliquer un retrait positif (.png "Retrait"){kind=icon}
), un retrait négatif (.png "Retrait négatif"){kind=icon}
), et faire glisser les éléments de travail pour modifier la hiérarchie.
En outre, vous pouvez ouvrir une requête dans Excel ou Projet pour modifier en bloc les relations parent-enfant et prédécesseur-successeur.
Q : comment empêcher une personne de modifier une requête que je partage avec l'équipe ?
R : définissez les autorisations sur la requête à Lire.
Q : comment ajouter une requête aux requêtes partagées ou en tant que favori d'équipe ?
R : pour enregistrer une requête dans le dossier Requêtes partagées, demandez à être ajouté au groupes Administrateurs de projet ou obtenez des autorisations pour un dossier sous Requêtes partagées.
Pour ajouter une requête en tant que favori d'équipe, ouvrez le menu contextuel de la requête et ajoutez-la comme favori d'équipe. Vous devez être administrateur d'équipe pour ajouter des requêtes aux favoris d'équipe.
Vous pouvez ajouter uniquement des requêtes partagées aux favoris de l'équipe, et seulement si vous disposez des autorisations d'administrateur d'équipe.
Q : puis-je ajouter des dossiers aux favoris de l'équipe ?
R : non. Vous pouvez ajouter des dossiers uniquement sous Mes requêtes et sous Requêtes partagées.
Q : puis-je envoyer une requête par courrier électronique ?
R : oui. Consultez L'URL du message électronique est un lien vers des éléments de travail et des requêtes TFS.
Q : puis-je définir un lien hypertexte qui ouvre une requête ?
R : oui. La façon la plus facile de définir un lien hypertexte consiste à créer une requête selon vos besoins, puis à copier son URL. Le lien hypertexte utilise le langage WIQL (Work Item Query Langage) qui ressemble à Transact-SQL et correspond à la syntaxe suivante :
**http://Nom_Serveur:**Port/ /tfs/Nom_Collection/Nom_Projet_Équipe/**q.aspx?pname=Projet&wiql=**Langage_Requête_Élément_Travail
Par exemple, le lien hypertexte suivant répertorie l'ID, le titre et l'état de tous les bogues portant le numéro de build 9.0.30304 défini pour le projet AdventureWorksProject.
http://AdventureWorks:8080/tfs/ /q.aspx?pname=AdventureWorksProject&wiql==SELECT [System.ID], [System.Title], [System.State] FROM WorkItems WHERE [System.TeamProject]='AdventureWorksProject' AND [System.WorkItemType]='Bug' AND [System.FoundIn]='9.0.30304' http://Server1:8091/tfs/web/wi.aspx?id=9035
Q : puis-je exporter une requête ?
R : oui. Dans l'éditeur de requête de Team Explorer, utilisez le menu Fichier pour enregistrer une requête en tant que fichier .wiq. Lorsque vous créez un projet d'équipe, les requêtes partagées sont créées d'après les fichiers .wiq définis dans le modèle de processus.
Q : Pourquoi le contenu du tableau de taches diffère-t-il de celui indiqué avec la requête créée ?
R : il est possible d'attribuer des tâches à une itération sans les lier à un élément parent du backlog. Ces éléments apparaîtront dans la requête créée, mais pas dans le tableau des tâches proprement dit. TFS exécute la requête, puis applique quelques processus en arrière-plan avant d'afficher les éléments du tableau des tâches.
Ces trois raisons peuvent entraîner l'absence des éléments de travail appartenant à la catégorie de tâche dans un backlog des sprints ou un tableau de tâches :
La tâche n'a pas été liée à un élément parent du backlog. Seuls les bogues et les tâches que vous avez liés à un élément de backlog du produit parent (Scrum), à un récit utilisateur (Agile) ou à une spécification (CMMI) dont le chemin d'accès d'itération est défini sur le sprint apparaîtront dans la page du backlog des sprints.
La tâche est un parent d'une autre tâche. Si vous avez créé une hiérarchie de tâches, seules les tâches de niveau enfant en bas de la hiérarchie s'affichent.
Le parent lié à la tâche correspond à un élément de backlog défini pour une autre équipe, ou le chemin de zone de l'élément parent du backlog de la tâche est différent du chemin de zone de la tâche.
Q : puis-je rechercher des éléments de travail par programmation ?Puis-je créer une requête dynamique ?
R : oui. Consultez Rechercher des bogues, des tâches et d'autres éléments de travail.
Voir aussi
Concepts
Choisir le client Team Foundation pour prendre en charge vos tâches