Spécifier des critères de filtre de requête

  • Article

Vous pouvez spécifier des critères de filtre pour votre requête afin de rechercher des éléments de travail et de sélectionner plus facilement les données filtrées que vous souhaitez utiliser. L'utilisation de critères de filtre différents vous permet de vérifier les éléments qui vous sont assignés, 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 ; chaque clause inclut un champ, un opérateur et une valeur. Vous pouvez ajouter, modifier et regrouper les clauses et les champs dans les requêtes que vous créez en filtrant le jeu d'éléments de travail qui répond à vos besoins.

Dans cette rubrique

Pour spécifier vos critères de filtre, effectuez les procédures suivantes jusqu'à ce que vous ayez le jeu d'éléments de travail répertorié dans la vue Résultats de la requête :

  1. Sélectionner le type de requête

  2. Spécifier des critères de filtre de requête de niveau supérieur

  3. Ajouter, supprimer, grouper ou dissocier des clauses de requête

  4. Exécuter ou annuler une requête et vérifier des résultats de requête

  5. Régler vos critères de filtre de requête

    Notes

    Les procédures suivantes sont écrites pour Team Explorer. Les procédures pour Team Web Access sont semblables mais peuvent varier légèrement.

Pour filtrer vos critères selon une valeur de date ou une valeur qui appartient à un groupe, consultez les procédures suivantes :

  • Spécifier un filtre selon une valeur date et heure

  • Spécifier un filtre selon l'appartenance à un groupe

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 en tant que requête d'équipe, vous devez être membre du groupe Project Administrators. Pour plus d'informations, consultez Autorisations de Team Foundation Server.

Sélectionner le type de requête

Pour sélectionner votre type de requête dans Team Explorer

  1. Ouvrez votre projet d'équipe, développez le nœud Éléments de travail, puis sélectionnez Requêtes d'équipe ou Mes requêtes.

  2. Dans le menu Équipe, cliquez sur Ajouter une requête Ajouter une requête. Sinon, cliquez avec le bouton droit sur le nœud Éléments de travail, Mes requêtes ou Requêtes d'équipe, puis cliquez sur Ajouter une requête.

    Une nouvelle requête Liste plate des éléments de travail (Par défaut) s'ouvre.

  3. Sur la barre d'outils de requête, sélectionnez Type de requête selon le type de vue ou des éléments de travail que vous recherchez :

    • Liste plate des éléments de travail (Par défaut) : retourne un niveau unique (liste plate Requête en deux dimensions) des éléments de travail qui correspondent à vos critères de filtre. Utilisez ce type de requête pour rechercher des éléments de travail que vous souhaitez lier à d'autres éléments de travail, pour exporter des éléments de travail vers Office Excel et Office Project pour les mises à jour en bloc dans les champs de colonne, ou créer un rapport portant sur un jeu d'éléments de travail. Pour plus d'informations, consultez Dresser une liste d'éléments de travail (liste plate par défaut).

    • Éléments de travail et liens directs : retourne un jeu d'éléments de travail à deux niveaux (Requête de liens directs) qui correspond à vos critères de filtre et tous les éléments de travail liés à ces derniers basés sur les critères de filtre secondaires. Cette vue affiche les éléments de travail dans une vue développable/réductible. Pour plus d'informations, consultez Afficher et modifier des éléments de travail dans une vue de liens directs.

    • Arborescence des éléments de travail : retourne un jeu d'éléments de travail à plusieurs niveaux (Requête d'arborescence) qui correspondent à vos critères de filtre et incluent tous les éléments de travail liés aux éléments de travail de niveau supérieur selon les liens parent-enfant. Cette vue affiche les éléments de travail dans une vue hiérarchique développable et réductible. Pour plus d'informations, consultez Afficher et modifier des éléments de travail dans une arborescence.

Retour au début

Spécifier les critères de filtre de requête de niveau supérieur

Les critères de filtre de niveau supérieur limitent les résultats de requête à un projet d'équipe et un type d'élément de travail.

Notes

Les critères de filtre par défaut définis pour une nouvelle requête retournent tous les éléments de travail (Type d'élément de travail=[Any] et État=[Any]) qui vous sont assignés (Assigné à=@Me) pour le projet d'équipe actuel (Projet d'équipe=@ProjectXUIX).

Si vous travaillez sur plusieurs projets d'équipe, vous pouvez effectuer des recherches sur l'ensemble de ces projets à l'aide d'une seule requête.

Pour spécifier les critères de filtre de niveau supérieur

  1. Spécifiez le ou les projets d'équipe qui contiennent les éléments de travail que vous recherchez. Si vous souhaitez renvoyer des éléments de travail pour :

    • Le projet d'équipe actuel, gardez Projet d'équipe=@Project.

    • Un autre projet d'équipe, tapez le nom du projet d'équipe dans la colonne Valeur pour le champ Projet d'équipe.

    • Plusieurs projets d'équipe, entrez les valeurs affichées dans le tableau suivant :

      And/Or

      Champ

      Opérateur

      Value

       

      Projet d'équipe

      In

      <nom du premier projet d'équipe>, <nom du deuxième projet d'équipe>,...

      Séparez les noms de projets d'équipe par des virgules.

  2. Spécifiez le type des éléments de travail que vous recherchez. Si vous souhaitez renvoyer des éléments de travail pour :

    • Tous les types, gardez Type d'élément de travail=[Any].

    • Un type unique, cliquez sur la colonne Valeur pour le champ Type d'élément de travail, puis cliquez sur le type d'élément de travail de votre choix.

    • Plusieurs types d'éléments de travail, entrez les valeurs affichées dans le tableau suivant :

      And/Or

      Champ

      Opérateur

      Value

      And

      Type d'élément de travail

      In

      <premier type d'élément de travail>, <deuxième type d'élément de travail>,...

      Séparez les noms de chaque type d'élément de travail par des virgules (,).

    • Tous les types d'éléments de travail qui appartiennent à une catégorie nommée, entrez les valeurs affichées dans le tableau suivant :

      And/Or

      Champ

      Opérateur

      Value

      And

      Type d'élément de travail

      Dans le groupe

      <nom du groupe de type d'élément de travail>

      Pour plus d'informations sur la définition des groupes de type d'élément de travail, consultez Personnalisation des catégories pour les types d'éléments de travail (witadmin).

      Pour les options supplémentaires que vous pouvez utiliser pour filtrer des critères de niveau supérieur, consultez la section « Opérateurs » dans Champs de requête, opérateurs, valeurs et variables.

  3. Dans la barre d'outils de requêtes, cliquez sur Exécuter la requête Exécuter, et confirmez que votre requête a retourné les résultats attendus.

  4. Cliquez sur EnregistrerEnregistrer ou Enregistrer sous. Pour plus d'informations, consultez Enregistrer, copier, renommer et supprimer des requêtes d'élément de travail.

Retour au début

Ajouter, supprimer, grouper ou dissocier des clauses de requête

Vous pouvez ajouter une nouvelle clause pour chaque champ d'élément de travail pour affiner vos critères de recherche et retourner uniquement le jeu des éléments de travail de votre choix. 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 de requête, consultez Champs de requête, opérateurs, valeurs et variables.

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.

Les clauses de requête peuvent être groupées pour fonctionner comme une unité unique distincte du reste de la requête, à l'instar de 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.

Comme l'illustre le tableau suivant, les clauses regroupées sont traduites en l'expression logique correspondante. La première expression retourne des é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
Opérateur OR avec Grouped AND Clause

Priority=1 OR (Work Item Type=Bug AND State=Active)
Opérateur AND avec Grouped OR Clause

Priority=1 AND (Work Item Type=Bug OR State=Active)

Pour ajouter, supprimer, grouper ou dissocier des clauses de requête

  1. Ajoutez une clause de l'une des façons suivantes :

    1. Pour ajouter la clause à la fin de vos critères de filtre, cliquez sur Cliquez ici pour ajouter une nouvelle clause.

    2. Sinon, pour insérer une clause, cliquez avec le bouton droit à l'emplacement où insérer la clause, et cliquez sur Insérer une clause.

      Une nouvelle ligne de clause de requête est ajoutée au-dessus de l'endroit où se trouvait le pointeur.

    3. Si vous souhaitez que la clause soit traitée comme une clause Ou, cliquez sur Et, puis sur Ou.

      Sélectionnez Et si cette clause et la précédente doivent toutes deux avoir la valeur true pour correspondre à un résultat. Sélectionnez Ou si cette clause ou la précédente doivent avoir la valeur true pour correspondre à un résultat.

    4. Spécifiez les valeurs pour Champ, Opérateur et Valeur.

      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 sélectionner.

      Opérateur

      Spécifiez comment la requête compare la valeur trouvée 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é. S'il y a une liste des valeurs dans laquelle sélectionner, cliquez sur la flèche pour sélectionner la valeur de votre choix. Vous pouvez spécifier une variable de requête pour ajouter dynamiquement des valeurs à votre requête.

      S'il y a une liste des valeurs dans laquelle sélectionner, cliquez sur la flèche pour sélectionner la valeur de votre choix. S'il y a plusieurs valeurs que vous souhaitez filtrer, 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.

  2. 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 la clause de requêteSupprimer des clauses.

  3. Regroupez les clauses de requête d'élément de travail en suivant ces étapes :

    1. Dans votre requête, sélectionnez les clauses de requête que vous souhaitez rassembler dans un groupe en cliquant sur la cellule la plus à gauche dans les lignes. Appuyez sur CTRL tout en cliquant pour sélectionner plusieurs lignes.

    2. Cliquez avec le bouton droit sur les clauses sélectionnées, puis cliquez sur Regrouper la clause de requête Regrouper des clauses.

      Un crochet apparaît dans la marge de gauche de la requête, indiquant que les clauses sont groupées.

  4. Dissociez des clauses de requête d'élément de travail en suivant ces étapes :

    1. Dans votre requête, sélectionnez toutes les clauses de requête groupées que vous souhaitez dissocier en cliquant sur la cellule la plus à gauche dans les lignes. Appuyez sur CTRL tout en cliquant pour sélectionner plusieurs lignes.

    2. Cliquez avec le bouton droit sur le groupe, puis cliquez sur Dissocier la clause de requête Dissocier des clauses.

      Le crochet est supprimé de la marge de gauche de la requête et les clauses sont dissociées.

      Notes

      Si Dissocier des clauses n'est pas disponible, cela signifie que vous n'avez pas sélectionné toutes les clauses dans le groupe de requêtes. Sélectionnez toutes les clauses et essayez à nouveau.

Retour au début

Exécuter ou annuler une requête et vérifier des résultats

Vous pouvez exécuter une requête d'élément de travail pour rechercher les éléments de travail, dans votre projet d'équipe, qui répondent aux critères de votre requête. Si vous apportez des changements aux éléments de travail susceptibles de modifier les résultats d'une requête, vous pouvez réexécuter la requête pour mettre à jour vos résultats.

Pour exécuter ou annuler une requête selon les critères de filtre de requête

  1. Dans la barre d'outils de requête, cliquez sur Exécuter la requête Exécuter.

    Notes

    Vous pouvez ajouter un champ défini pour les éléments de travail qui font l'objet d'une recherche pour contrôler le mode d'affichage et de tri des résultats de la requête. Pour plus d'informations, consultez Ajouter, supprimer, réorganiser et trier les colonnes.

  2. Pour annuler votre recherche de requête, cliquez sur Arrêter la requête Arrêter la requête, ou dans le menu Équipe, cliquez sur Arrêter l'actualisation.

  3. Examinez vos résultats de requête. Si la liste d'éléments de travail ne correspond pas à vos critères de recherche attendus, examinez et modifiez les critères de filtre.

Retour au début

Régler vos critères de filtre de requête

Pour régler vos critères de filtre

  • Si vos résultats de requête ne retournent pas le jeu d'éléments de travail que vous attendez, effectuez les vérifications suivantes :

    1. Vérifiez chaque clause pour vous s'assurer qu'elles sont définies comme prévu.

    2. Vérifiez les valeurs Et/Ou affectées à 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.

    3. Vérifiez le regroupement des clauses de requête et les affectations de Et/Ou à chaque clause groupée.

    4. Ajoutez d'autres clauses de requête pour affiner vos critères de filtre de requête.

    5. Examinez les options disponibles pour spécifier des champs, des opérateurs et des valeurs comme décrit dans Champs de requête, opérateurs, valeurs et variables. Déterminez si vous souhaitez modifier une clause de requête pour utiliser un autre champ, opérateur ou valeur.

Retour au début

Spécifier un filtre selon une valeur date et heure

Vous pouvez trier des éléments de travail selon la date de leur modification ou selon une période spécifique. Si vous limitez la portée de votre requête, cela peut améliorer les performances, car elle ne retourne que les résultats qui correspondent à la plage de dates que vous souhaitez inclure.

Pour rechercher des éléments de travail selon des critères de filtre spécifiques à la date

  1. Recherchez des éléments de travail modifiés aujourd'hui en suivant ces étapes :

    1. Sélectionnez un champ de type de données date pour ajouter ou modifier une clause de requête.

      Notes

      La plupart des champs date contiennent le mot « date » dans le nom du champ.

    2. Dans la colonne Opérateur, sélectionnez = (égal).

    3. Dans la colonne Valeur, cliquez sur la flèche et sélectionnez @Aujourd'hui pour la date d'aujourd'hui.

      Notes

      Vous pouvez modifier cette variable pour rechercher la date actuelle moins un nombre de jours. Par exemple, pour rechercher tous les éléments ayant démarré la semaine dernière, affectez à la colonne Champ la valeur Date d'activation, à la colonne Opérateur la valeur >=, et à la colonne Valeur la valeur @Today - 7.

    4. Cliquez sur Exécuter la requêteExécuter, et vérifiez vos résultats de requête.

  2. Recherchez des éléments de travail modifiés à une date spécifique en suivant ces étapes :

    1. Sélectionnez un champ de type de données date pour ajouter ou modifier une clause de requête.

    2. Dans la colonne Opérateur, sélectionnez = (égal).

    3. Dans la colonne Valeur, tapez la date qui suit le format accepté par le système d'exploitation de votre ordinateur.

    4. Cliquez sur Exécuter la requêteExécuter, puis vérifiez les résultats de la requête.

  3. Recherchez des éléments de travail modifiés sur une plage de dates en suivant ces étapes :

    1. Sélectionnez un champ de type de données date pour ajouter ou modifier une clause de requête.

    2. Dans la colonne Opérateur, choisissez soit >(supérieur à), si vous souhaitez uniquement les éléments postérieurs à la date, soit >= (supérieur ou égal à) pour inclure aussi les éléments de la date sélectionnée.

    3. Dans la colonne Valeur, entrez la première date de la plage de dates qui suit le format de date accepté par le système d'exploitation de votre ordinateur.

    4. Insérez directement une autre clause de requête sous la clause de requête précédente.

    5. Dans la colonne d'assignations Et/Ou , sélectionnez Et.

    6. Dans la colonneOpérateur, sélectionnez <(inférieur à) si vous souhaitez seulement les éléments antérieurs à la date, ou < = (inférieur ou égal à) si vous souhaitez des éléments qui incluent la date que vous sélectionnez.

    7. Dans la colonne Valeur, entrez la dernière date de la plage de dates, en respectant le format de date accepté par le système d'exploitation de votre ordinateur.

    8. Dans la colonne Opérateur, sélectionnez = (égal).

    9. Dans la colonne Valeur, tapez la date qui suit le format accepté par le système d'exploitation de votre ordinateur.

    10. Sélectionnez les deux clauses de requête spécifiques à la date et groupez-les.

    11. Cliquez sur Exécuter la requêteExécuter, puis vérifiez les résultats de la requête.

Retour au début

Spécifier un filtre selon l'appartenance à un groupe

Vous pouvez utiliser les opérateurs In Group (Dans le groupe) ou Not In Group (Pas dans le groupe) pour filtrer une requête selon plusieurs valeurs qui sont ou ne sont pas membres d'un groupe. Vous pouvez spécifier des groupes de distribution dans Team Foundation Server ou une ou plusieurs catégories de types d'éléments de travail.

Pour rechercher des éléments de travail selon une valeur qui appartient à un groupe

  1. Spécifiez les types de clauses suivants :

    • Ajoutez la clause suivante pour trouver les éléments de travail assignés à tout utilisateur qui appartient au groupe Project Administrators :

      And/Or

      Champ

      Opérateur

      Value

      And

      Assigné à.

      Dans le groupe

      Project Administrators

    • Ajoutez la clause suivante pour trouver des éléments de travail actifs de tous types dans le groupe Test category :

      And/Or

      Champ

      Opérateur

      Value

      Et

      État

      =

      Active

      And

      Type d'élément de travail

      Dans le groupe

      Test

    Pour plus d'informations sur les groupes de catégorie, consultez Regroupement de types d'éléments de travail en catégories.

  2. Cliquez sur Exécuter la requête, puis vérifiez les résultats de la requête.

Retour au début

Voir aussi

Tâches

Ajouter, supprimer, réorganiser et trier les colonnes

Enregistrer, copier, renommer et supprimer des requêtes d'élément de travail

Dresser une liste d'éléments de travail (liste plate par défaut)

Afficher et modifier des éléments de travail dans une vue de liens directs

Afficher et modifier des éléments de travail dans une arborescence

Concepts

Champs de requête, opérateurs, valeurs et variables

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

Historique des modifications

Date

Historique

Motif

Août 2010

Exemple ajouté sur la façon dont une clause regroupée est évaluée logiquement.

Commentaires client.

Septembre 2010

Exemple corrigé pour l'opérateur In Group (Dans le groupe).

Commentaires client.