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

Vous pouvez spécifier les critères de filtre pour que votre requête recherche des éléments de travail d'intérêt pour vous ou de votre équipe.Vous pouvez utiliser des macros de votre requête afin de vérifier ce qui vous est assigné, ce qui sont les tâches actives, ou pour rechercher ces éléments mis à jour récemment.

toutes les requêtes d'élément de travail sont constituées d'une ou de plusieurs clauses de requête.Chaque clause inclut un champ, un opérateur, et une valeur.Vous ajoutez, modifiez et regroupez des clauses et de champs dans les requêtes pour rechercher l'ensemble d'éléments de travail d'intérêt pour vous.Définir une requête est souvent un processus itératif, où vous affinez les critères de filtre jusqu'à ce que vous obteniez les résultats souhaités.

Dans cette rubrique

1. Sélectionnez le type de requête

2. Spécifiez les critères de niveau supérieur de filtre de requête

3. (Facultatif) spécifiez les critères de filtre pour les éléments de travail liés

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

5. Exécuter ou annuler une requête et les résultats de contrôle

6. Ajustez vos critères de filtre de requête

[!REMARQUE]

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

Configuration requise

• Vous devez être membre du groupe Readers ou disposer de l'autorisation Afficher les éléments de travail dans ce nœud à Autoriser.Pour plus d'informations sur les autorisations de requête, consultez Rechercher des bogues, des tâches et d'autres éléments de travail.

1.Sélectionnez le type de requête

1. Ouvrez votre projet d'équipe, choisissez la page Éléments de travail , puis choisissez Nouvelle requête.

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

2. 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 (valeur par défaut): Retourne une couche unique, liste plate d'é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 Utiliser une requête de liste plate (par défaut).

   • Éléments de travail et liens directs: Retourne un ensemble à deux couches d'éléments de travail qui correspondent à vos critères de filtre et tous les éléments de travail liés à ces derniers en fonction de 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 Utilisation des dépendances liées (Liens directs).

   •  Arborescence des éléments de travail: Retourne un ensemble d'éléments de travail à plusieurs niveaux qui correspondent à vos critères de filtre et inclut tous les éléments de travail liés aux éléments de travail de niveau supérieur sur des 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 Utilisation des hiérarchies liées (Arborescence des éléments de travail).

   Pour obtenir un résumé des tâches prises en charge par chaque type de requête, consultez Sélectionnez l'outil approprié de requête pour la tâche.

Retour au début

2.Spécifiez les critères de niveau supérieur de filtre de requête

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.

[!REMARQUE]

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.

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 :

     Et/ou	Champ	Opérateur	Valeur
     	Projet d'équipe	Dans	<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, choisissez la colonne Valeur pour le champ Type d'élément de travail , puis sélectionnez le type d'élément de travail que vous souhaitez.

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

     Et/ou	Champ	Opérateur	Valeur
     Et	Type d'élément de travail	Dans	<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 :

     Et/ou	Champ	Opérateur	Valeur
     Et	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 types d'éléments de travail, consultez Personnaliser les 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ête, choisissez Exécuter, et confirmez que votre requête a retourné les résultats attendus.

4. Choisissez Enregistrer la requête.Pour plus d'informations, consultez Enregistrer, copier, renommer et supprimer des requêtes d'élément de travail.

Retour au début

3.(Facultatif) spécifiez les critères de filtre pour les éléments de travail liés

Si vous avez sélectionnéÉléments de travail et liens directs ou Arborescence des éléments de travail, vous pouvez spécifier les critères de filtre pour les éléments de travail liés ainsi que les éléments de travail de TOP- couche sont trouvé.

Pour spécifier des critères de filtre de requête d'éléments de travail et liens directs

1. Et éléments de travail liés qui correspondent à la requête ci-dessousSélectionnez.Ajoutez et regroupez les clauses de la même façon que vous les avez définies pour les critères de niveau supérieur.

   Critères de filtre pour les éléments de travail liés

   

2. Sélectionnez un élément dans joindre des filtres pour filtrer la liste de la première couche d'éléments de travail :

   • 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 deuxième couche liés à la première couche sont retournés s'ils correspondent aux critères de filtre d'éléments de travail.

   • Seuls éléments de travail de retour ayant des liens spécifiés: les éléments de travail de la première couche sont retournés, mais uniquement s'ils ont des liens vers des éléments de travail spécifiés par les critères de filtre d'éléments de travail.

   • Seuls éléments de travail de retour n'ayant pas de liens spécifiés: les éléments de travail de la première couche sont retournés, mais uniquement s'ils n'ont pas de liens vers les éléments de travail spécifiés par les critères de filtre d'éléments de travail.

3. (Facultatif) sélectionnez Types de liens sélectionnés par retour, puis sélectionnez un ou plusieurs des cases à cocher disponibles pour les types de liens à inclure dans vos critères de filtre.

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

5. Modifiez les critères de filtre et réexécutez la requête jusqu'à ce que vous obteniez la première et la deuxième couches des éléments de travail souhaités.

Pour spécifier le critera de filtre pour une arborescence d'éléments de travail

1. Sous Filtres pour les éléments de travail liés, ajoutez et regroupez les clauses de la même façon que vous les avez définies pour les critères de niveau supérieur.

2. Sélectionnez joindre des filtres qui filtrera supplémentaire votre liste de la première couche d'éléments de travail comme suit :

   1. Mettre en correspondance les éléments de travail de niveau supérieur d'abord: Exécute une recherche hiérarchique.Tous les éléments de travail de la première couche sont retournés.Tous les éléments de travail liés à la première couche sont retournés s'ils correspondent aux critères de filtre d'éléments de travail.

   2. Éléments de travail liés par correspondance d'abord: Exécute une recherche descendante.Recherche tous les éléments de travail liés, puis retourne les éléments de travail de la première couche qui sont liés aux éléments trouvés.

3. (Facultatif) sélectionnez type d'arborescence.Si vous avez ajouté des types de liens personnalisés de topologie d'arborescence, vous pouvez choisir les valeurs énumérées à un groupe personnalisé de types de liens hiérarchiques.Consultez Référence d'élément Type de lien.

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

5. Modifiez les critères de filtre et réexécutez la requête jusqu'à ce que vous obteniez la première et la deuxième couches des éléments de travail souhaités.

Retour au début

4.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.

Vous pouvez regrouper les clauses de requête pour fonctionner comme une seule unité distincte du reste de la requête, semblable à mettre les parenthèses autour d'une expression dans une équation mathématique d'instruction ou de logique.Lorsque vous regroupez des clauses, et ou ou de la première clause au groupe s'applique au groupe entière.

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
	Priority=1 OR (Work Item Type=Bug AND State=Active)
	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, choisissez Cliquez ici pour ajouter une nouvelle clause.

   2. Ou, insérer une clause, choisissez la cellule de la première colonne où vous souhaitez insérer la clause pour mettre en surbrillance la ligne, ouvrez le menu contextuel, puis cliquez 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 à traiter comme une clause d' ou , cliquez sur le bouton fléché bas en regard et, puis choisissez ou.

      Choisissez et si la clause et la précédente doivent toutes les deux être true pour correspondre à un résultat.Choisissez ou si cette clause ou la précédente doivent être 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. Pour supprimer une clause de requête, ouvrez le menu contextuel pour la clause, puis choisissez Supprimer 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 associer à un groupe en sélectionnant la cellule la plus à gauche dans les lignes.Appuyez sur CTRL tout en cliquant pour sélectionner plusieurs lignes.

   2. Ouvrez le menu contextuel pour les clauses sélectionnées, puis choisissez 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. Ouvrez le menu contextuel du groupe, puis choisissez Dissocier des clauses.

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

      [!REMARQUE]

      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

5.Exécuter ou annuler une requête et les résultats de contrôle

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.

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

   [!REMARQUE]

   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, choisissez Arrêter la requête, ou, dans le menu Équipe , choisissez 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

6.Ajustez vos critères de filtre de requête

• 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 :

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

  • Vérifiez les assignations et/ou à 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.

  • Vérifiez le regroupement des clauses de requête et les affectations de Et/Ou à chaque clause groupé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 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

Voir aussi

Tâches

Utiliser une requête de liste plate (par défaut)

Utilisation des hiérarchies liées (Arborescence des éléments de travail)

Concepts

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

Exemple de requêtes d'élément de travail

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

Autres ressources

Utilisation des dépendances liées (Liens directs)