Spécifier des critères de requête
Vous pouvez spécifier des critères pour votre requête pour rechercher des éléments de travail. L'utilisation de critères de filtre différents vous permet de vérifier les éléments qui vous sont assignés, d'identifier quelles sont vos tâches actives ou de consulter une liste des fonctionnalités assignées à vous même ou à votre équipe.
Toutes les requêtes d'élément de travail se composent d'une ou plusieurs clauses de requête et chaque clause inclut un champ, un opérateur et une valeur. Vous pouvez filtrer le jeu d'éléments de travail qui répond à vos besoins en ajoutant, modifiant et regroupant les clauses et les champs dans les requêtes que vous créez.
Contenu de la rubrique
Pour spécifier les critères d'une requête, exécutez les procédures suivantes jusqu'à ce qu'une liste d'éléments de travail s'affiche dans la zone Résultats de la requête :
Pour plus d'informations sur le filtrage de vos critères selon une valeur de date ou une appartenance à un groupe, consultez les procédures suivantes :
Autorisations requises
Pour exécuter ces procédures, 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 d'équipe, vous devez être membre du groupe Project Administrators. Pour plus d'informations, consultez la page suivante : Autorisations Team Foundation Server.
Sélectionner le type de requête
Pour sélectionner votre type de requête
Ouvrez votre projet d'équipe, cliquez avec le bouton droit sur le nœud Éléments de travail, Mes requêtes ou Requêtes d'équipe, puis cliquez sur Nouvelle requête.
Une nouvelle requête s'ouvre.
Notes
Le Plug-in Team Foundation Server pour Eclipse ne prend en charge que des requêtes de liste plate. Vous devez utiliser un autre client pour Team Foundation si vous souhaitez créer ou modifier une requête multicouche.
Spécifier des critères de niveau supérieur
Les critères de filtre de niveau supérieur limitent les résultats de requête par projet d'équipe et type d'élément de travail.
Notes
Par défaut, une requête retourne tous les éléments de travail (Type d'élément de travail=[Any] et État=[Any]) qui vous sont assignés (Assigné à=@Me) dans le projet d'équipe actuel (Projet d'équipe=@Project).
Si vous utilisez plusieurs projets d'équipe, vous pouvez effectuer une recherche dans l'ensemble de ces projets à l'aide d'une seule requête.
Pour spécifier les critères de filtre de niveau supérieur
Spécifiez le ou les projets d'équipe qui contiennent les éléments de travail que vous recherchez.
Si vous souhaitez rechercher des éléments de travail dans le projet d'équipe actuel, conservez Projet d'équipe=@Project.
Si vous souhaitez rechercher des éléments de travail dans un autre projet d'équipe, tapez le nom du projet dans la colonne Valeur du champ Projet d'équipe.
Si vous souhaitez rechercher des éléments de travail dans plusieurs projets d'équipe, spécifiez les valeurs du tableau suivant :
Et/ou
Champ
Opérateur
Valeur
Projet d'équipe
Dans
FirstTeamProjectName, SecondTeamProjectName, ...
Séparez les noms de projets d'équipe à l'aide de virgules ().
Spécifiez le type des éléments de travail que vous recherchez.
Si vous souhaitez rechercher tous les types d'éléments de travail, conservez Type d'élément de travail=[Any].
Si vous souhaitez rechercher un seul type d'élément de travail, cliquez sur la colonne Valeur du champ Type d'élément de travail, puis cliquez sur le type d'élément de travail à rechercher.
Si vous souhaitez rechercher plusieurs types d'éléments de travail, spécifiez les valeurs du tableau suivant :
Et/ou
Champ
Opérateur
Valeur
Et
Type d'élément de travail
Dans
FirstWorkItemType, SecondWorkItemType,...
Séparez les noms des types d'éléments de travail par des virgules (,).
Si vous souhaitez rechercher tous les types d'éléments de travail qui appartiennent à une catégorie nommée, spécifiez les valeurs affichées dans le tableau suivant :
Et/ou
Champ
Opérateur
Valeur
Et
Type d'élément de travail
Dans le groupe
NameOfWorkItemTypeCategory
Pour plus d'informations sur la définition de catégories de types d'éléments de travail, consultez la page suivante : Personnalisation des catégories pour les types d'éléments de travail (page éventuellement en anglais).
Pour plus d'informations sur les moyens de spécifier des critères de niveau supérieur, consultez Query Operators.
Dans la barre d'outils, cliquez sur Exécuter la requête, puis confirmez que votre requête a retourné les résultats attendus.
Vous pouvez également cliquer avec le bouton droit sur la fenêtre de requête et cliquer sur Exécuter la requête.
Dans le menu Fichier, cliquez sur Enregistrer ou sur Enregistrer sous.
Vous pouvez également appuyer sur Ctrl+S pour enregistrer.
Ajouter, supprimer, grouper ou dissocier des clauses de requête
Vous pouvez ajouter une clause pour chaque champ d'élément de travail afin d'affiner les résultats de la requête. Si vous ne recevez pas les résultats attendus de votre requête, vous pouvez ajouter, supprimer, grouper ou dissocier des clauses de requête pour affiner vos résultats de la requête. Pour plus d'informations sur les éléments dans une clause, consultez Champs de requête, opérateurs, valeurs et variables (Team Explorer Everywhere).
Chaque clause de requête inclut un nom de champ, un opérateur de requête et une valeur. Utilisez autant de clauses que nécessaire pour obtenir des résultats utiles.
Vous pouvez grouper des clauses de requête pour qu'elles fonctionnent comme une unité unique qui est distincte du reste de la requête. Cette approche ressemble à la mise entre parenthèses d'une expression dans une équation mathématique ou une instruction logique. Lorsque vous groupez des clauses, l'opérateur AND ou OR de la première clause du groupe s'applique à l'ensemble du groupe.
Pour ajouter, supprimer, grouper ou dissocier des clauses de requête
Ajoutez une clause de l'une des façons suivantes :
Pour ajouter la clause après la dernière clause pour votre requête, cliquez sur * dans la colonne la plus à gauche.
Pour insérer une clause entre deux clauses, cliquez avec le bouton droit sous l'emplacement où insérer la clause, puis cliquez sur Insérer une clause.
Une ligne de clause s'affiche au-dessus de l'emplacement du pointeur.
Pour spécifier que la clause doit être traitée comme une clause Ou, cliquez dans la colonne Et/ou, puis cliquez sur Ou dans la liste.
Cliquez sur Et si les résultats doivent correspondre à la fois à cette clause et à la clause précédente. Cliquez sur Ou si les résultats doivent correspondre à cette clause ou à la clause précédente, mais pas aux deux.
Spécifiez les valeurs de Champ, Opérateur et Valeur, comme le montre le tableau :
Colonne de requête
Utilisation
Champ
Spécifiez un champ pour le type des éléments de travail que vous recherchez. Le jeu d'éléments de travail est filtré selon l'Opérateur et les Valeurs définis pour le champ.
Appuyez sur Alt+Bas ou tapez le nom du champ que vous souhaitez spécifier.
Opérateur
Spécifiez comment la requête compare la valeur dans le champ spécifié d'un enregistrement. Les opérateurs suivants peuvent être choisis : = (égal), <> (différent de), > (supérieur à), < (inférieur à), >= (supérieur ou égal à), <= (inférieur ou égal à), Contient, Ne contient pas, Dans et Toujours.
Valeur
Spécifiez la valeur que vous recherchez dans le champ sélectionné.
Si vous pouvez spécifier une valeur à partir d'une liste, cliquez sur la flèche pour sélectionner celle de votre choix. Si vous souhaitez filtrer plusieurs valeurs, utilisez l'opérateur Dans pour spécifier une liste de valeurs délimitées par des virgules. Pour spécifier une valeur dynamique, spécifiez une variable de requête valide.
Pour plus d'informations, consultez Champs de requête, opérateurs, valeurs et variables (Team Explorer Everywhere).
Supprimez une clause de requête en cliquant avec le bouton droit à gauche de la ligne de clause que vous souhaitez supprimer, puis cliquez sur Supprimer les clauses.
Pour grouper des clauses, suivez ces étapes :
Dans votre requête, spécifiez les clauses de requête que vous souhaitez grouper en maintenant enfoncée la touche Ctrl et en cliquant sur la cellule située le plus à gauche dans chaque ligne.
Cliquez avec le bouton droit sur les clauses en surbrillance, puis cliquez sur Regrouper les clauses.
Un crochet apparaît dans la marge de gauche de la colonne Et/ou pour indiquer que les clauses sont groupées.
Pour dissocier des clauses, suivez ces étapes :
Dans votre requête, mettez en surbrillance toutes les clauses dans le groupe en maintenant enfoncée la touche Ctrl et en cliquant sur la cellule située le plus à gauche dans chaque ligne.
Cliquez avec le bouton droit sur le groupe, puis cliquez sur Dissocier les clauses.
Le crochet est supprimé de la marge de gauche de la requête et les clauses sont dissociées.
Notes
Si Dissocier les clauses n'est pas disponible, cela signifie que vous n'avez pas mis en surbrillance toutes les clauses dans le groupe de requêtes. Mettez en surbrillance toutes les clauses et essayez à nouveau.
Exécuter une requête
Si un élément de travail change afin qu'il corresponde ou ne corresponde plus aux critères, vous pouvez réexécuter la requête pour mettre à jour vos résultats.
Pour exécuter une requête
Dans la barre d'outils, cliquez sur Exécuter la requête.
Vous pouvez également cliquer avec le bouton droit sur la requête et cliquer sur Exécuter la requête.
Notes
Vous pouvez changer les colonnes qui s'affichent dans vos résultats et leur mode de tri en ajoutant un champ qui été défini pour les éléments de travail dans lesquels vous effectuez une opération de recherche. Pour plus d'informations, consultez Ajouter, supprimer, réorganiser et trier les colonnes (Team Explorer Everywhere).
Examinez vos résultats de requête. S'ils ne correspondent pas à vos critères de recherche, vérifiez et modifiez les critères.
Notes
Vous ne pouvez pas annuler une requête en cours d'exécution dans cette version finale du Plug-in Team Foundation Server pour Eclipse.
Ajuster les critères
Si les résultats de votre requête ne correspondent pas à vos attentes, suivez les étapes de cette procédure.
Pour ajuster vos critères de filtre
Vérifiez si chaque clause est définie comme vous le voulez.
Vérifiez les valeurs Et/Ou affectées à chaque clause.
Si vos résultats contiennent plus d'éléments de travail que prévu, une clause Ou peut être présente au lieu d'une clause Et.
Vérifiez le regroupement des clauses.
Si la requête retourne trop de résultats, ajoutez des clauses pour affiner vos critères.
Spécifier des critères de date-heure
Vous pouvez rechercher des éléments de travail qui ont été modifiés à une date particulière ou au cours d'une plage particulière de dates. Si vous limitez la portée de votre requête, vous pouvez améliorer les performances en ne retournant que les résultats qui correspondent à la plage de dates que vous souhaitez inclure.
Pour rechercher des éléments de travail modifiés aujourd'hui
Sélectionnez une valeur dans la colonne Champ qui est un type de données Date.
Notes
La plupart des champs Date contiennent le mot « date » dans le nom du champ.
Dans la colonne Opérateur, cliquez sur = (égal).
Dans la colonne Valeur, cliquez sur la flèche, puis sur @Today pour la date d'aujourd'hui.
Notes
Vous pouvez modifier cette variable pour rechercher des éléments de travail qui ont été modifiés un nombre de jours particulier avant aujourd'hui. Par exemple, vous pouvez rechercher tous les éléments créés la semaine dernière en affectant à la colonne Champ la valeur Date d'activation, à la colonne Opérateur la valeur >= et à la colonne Valeur la valeur @Today - 7.
Dans la barre d'outils, cliquez sur Exécuter la requête et examinez les résultats de la requête.
Vous pouvez également cliquer avec le bouton droit sur la définition de requête et cliquer sur Exécuter la requête.
Pour rechercher les éléments de travail modifiés à une date spécifique
Sélectionnez une valeur dans la colonne Champ de type de données Date pour ajouter ou modifier une clause de requête.
Dans la colonne Opérateur, cliquez sur = (égal).
Dans la colonne Valeur, tapez la date à laquelle les éléments ont dû être modifiés.
Dans la barre d'outils, cliquez sur Exécuter la requête et examinez les résultats de la requête.
Vous pouvez également cliquer avec le bouton droit sur la définition de requête et cliquer sur Exécuter la requête.
Pour rechercher des éléments de travail modifiés pendant une plage de dates
Sélectionnez une valeur dans la colonne Champ de type de données Date pour ajouter ou modifier une clause de requête.
Dans la colonne Opérateur, cliquez sur > (Supérieur à) ou cliquez sur > = (Supérieur ou égal à) pour spécifier la première date dans la plage.
Spécifiez > = (Supérieur ou égal à) si vous souhaitez rechercher des éléments modifiés à la première date dans la plage.
Dans la colonne Valeur, tapez la première date dans la plage.
Insérez directement une autre clause de requête sous la clause de requête précédente.
Dans la colonne d'assignations Et/Ou , cliquez sur Et.
Dans la colonne Opérateur, cliquez sur < (Inférieur à) ou cliquez sur < = (Inférieur ou égal à) pour spécifier la date la plus récente dans la plage.
Spécifiez <= (Inférieur ou égal à) si vous souhaitez rechercher des éléments modifiés à la date la plus récente dans la plage.
Dans la colonne Valeur, spécifiez la date la plus récente dans la plage.
Groupez les deux clauses que vous venez de créer.
Dans la barre d'outils, cliquez sur Exécuter la requête et examinez les résultats de la requête.
Vous pouvez également cliquer avec le bouton droit sur la définition de requête et cliquer sur Exécuter la requête.
Spécifier un filtre selon l'appartenance à un groupe
Vous pouvez utiliser les opérateurs Dans le groupe ou Pas dans le groupe pour spécifier des critères selon plusieurs valeurs qui appartiennent à un groupe, ou qui n'appartiennent pas à un groupe. Les exemples de groupes sont les groupes de distribution définis dans Team Foundation Server, une catégorie de types d'éléments de travail, ou tous les bogues actifs assignés à vos rapports.
Pour rechercher des éléments de travail selon une valeur qui appartient à un groupe
Vous pouvez rechercher des éléments de travail qui répondent aux critères suivants :
Pour trouver les éléments de travail assignés à une personne qui appartient au groupe Project Administrators, ajoutez la clause du tableau suivant :
Et/ou
Champ
Opérateur
Valeur
Et
Assigné à.
Dans le groupe
Project Administrators
Pour rechercher les éléments de travail qui sont actifs et assignés à une personne dont vous êtes responsable, ajoutez les clauses que le tableau suivant affiche :
Et/ou
Champ
Opérateur
Valeur
Et
État
=
Active
Et
Assigné à.
Dans le groupe
MyDirectReportsDistributionGroup
Dans la barre d'outils, cliquez sur Exécuter la requête et examinez les résultats de la requête.
Vous pouvez également cliquer avec le bouton droit sur la définition de requête et cliquer sur Exécuter la requête.
Voir aussi
Autres ressources
Champs de requête, opérateurs, valeurs et variables (Team Explorer Everywhere)
Ajouter, supprimer, réorganiser et trier les colonnes (Team Explorer Everywhere)
Dresser une liste d'éléments de travail (liste plate par défaut) (Team Explorer Everywhere)
Recherche de bogues, de tâches et d'autres éléments de travail (Team Explorer Everywhere)