Définir une requête

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2013

Les requêtes d’élément de travail génèrent des listes d’éléments de travail en fonction des critères de filtre que vous fournissez. Vous pouvez ensuite enregistrer et partager ces requêtes managées avec d’autres utilisateurs. En revanche, les recherches sémantiques répertorient les éléments de travail, mais elles ne peuvent pas être enregistrées ou partagées.

Vous pouvez créer des requêtes à partir du portail Web ou d’un client pris en charge, par exemple Visual Studio Team Explorer et Team Explorer Everywhere. En outre, vous pouvez ouvrir une requête dans Excel pour effectuer des ajouts et des modifications en bloc.

Notes

Pour définir des requêtes dans Visual Studio 2019, vous devez définir l’expérience des éléments de travail sur l’option hérité.

Si vous constatez que vos requêtes prennent trop de temps pour retourner des résultats, consultez les conseils pour créer des requêtes à hautes performances.

Dans cet article, vous apprendrez ce qui suit :

  • Ajout ou création d’une requête
  • Comment interroger des projets
  • Comment grouper et dissocier des clauses de requête
  • Comment créer une arborescence d’éléments de travail ou une requête de liens directs

Pour un accès rapide à toutes les tâches de requête, les opérateurs pris en charge — tels que, Contains ,, In In Group , et <> (opérateur NOT) — basés sur le type de données de champ et les exemples de requêtes, consultez aide-mémoiresur les requêtes.

Filtres de requête

Dans l’éditeur de requête, vous pouvez exercer les fonctions de filtre suivantes. Choisissez le filtre pour accéder à un article avec des exemples de requêtes. Outre les filtres de requête, vous pouvez appliquer de manière interactive des filtres aux résultats de la requête.

Notes

Les requêtes managées ne prennent pas en charge les recherches de proximité, mais les recherches sémantiques. En outre, les recherches sémantiques prennent en charge à la fois * et ? en tant que caractères génériques et vous pouvez utiliser plusieurs caractères génériques pour faire correspondre plusieurs caractères. Pour plus d’informations, consultez recherche d’éléments de travail fonctionnels.


Filtrer les fonctionnalités

Macros



Outre les filtres que vous utilisez à partir de l’éditeur de requête, vous pouvez filtrer de manière interactive un résultat de requête à l’aide de la fonction Filter . Pour savoir comment procéder, consultez filtrage interactif des journaux des travaux en souffrance, des tableaux, des requêtes et des plans.

Prérequis

  • Par défaut, tous les membres du projet et les utilisateurs disposant d’un accès partie prenante peuvent afficher et exécuter toutes les requêtes partagées. Vous pouvez modifier les autorisations définies pour un dossier de requête partagé ou une requête partagée. Pour plus d’informations, consultez définir les autorisations de requête.
  • Pour ajouter et enregistrer une requête sous requêtes partagées, vous devez disposer d’un accès de base ou supérieur. En outre, votre autorisation collaboration doit être définie sur autoriser pour le dossier auquel vous souhaitez ajouter la requête. Par défaut, le groupe Contributors n’a pas cette autorisation.

Notes

Les utilisateurs disposant d’un accès partie prenante pour un projet public ont un accès complet aux fonctionnalités de requête, tout comme les utilisateurs disposant d’un accès de base . Pour plus d’informations, consultez à propos des niveaux d’accès.

  • Par défaut, tous les membres du projet et les utilisateurs disposant d’un accès partie prenante peuvent afficher et exécuter toutes les requêtes partagées. Vous pouvez modifier les autorisations définies pour un dossier de requête partagé ou une requête partagée. Pour plus d’informations, consultez définir les autorisations de requête.
  • Pour ajouter et enregistrer une requête sous requêtes partagées, vous devez disposer d’un accès de base ou supérieur. En outre, votre autorisation collaboration doit être définie sur autoriser pour le dossier auquel vous souhaitez ajouter la requête. Par défaut, le groupe Contributors n’a pas cette autorisation.

Ouvrir des requêtes

À partir de votre navigateur Web, (1) Vérifiez que vous avez sélectionné le projet approprié, (2) choisissez tableaux>requêtes, puis (3) choisissez tout.

Ouvrir des tableaux>des requêtes, navigation verticale

S’il s’agit de la première fois que vous ouvrez des requêtes, la page s’ouvre sur favoris. Cette page répertorie les requêtes que vous avez indiquées comme favoris. Dans le cas contraire, vous pouvez choisir tous pour afficher toutes les requêtes que vous avez définies et les requêtes partagées définies pour le projet.

Conseil

Les requêtes que vous ou votre équipe avez choisies comme favoris s’affichent sur la page favoris . Les requêtes favorites, ainsi que d’autres objets, s’affichent également sur la page de votre projet . Pour plus d’informations, consultez définir des favoris personnels ou d’équipe.

À partir de votre navigateur Web, ouvrez tableaux>requêtes.

À partir de votre navigateur Web, ouvrez tableaux>requêtes.

Définir une requête de liste plate

Vous pouvez démarrer une nouvelle requête nouvelle à partir de l’onglet requêtes dans le portail Web ou de l’onglet éléments de travail dans Team Explorer.

Ajouter une nouvelle requête, nouvelle expérience

Requêtes, choisissez nouvelle requête dans le menu déroulant.

Interroger dans des projets ou dans des projets

Par défaut, les nouvelles requêtes sont étendues au projet actif. Toutefois, vous pouvez créer des requêtes pour rechercher des éléments de travail définis dans l’organisation ou la collection de projets. Toutes les requêtes que vous enregistrez sont toutefois enregistrées sous un projet spécifique.

Pour répertorier les éléments de travail définis dans plusieurs projets, requête de coches sur plusieurs projets. Par exemple, la requête suivante recherche toutes les fonctionnalités créées dans tous les projets au cours des 30 derniers jours.

Web portal, Queries page, Query Editor, Checkbox, Query across projects

Notes

La fonctionnalité requête sur plusieurs projets est prise en charge à partir de TFS 2015,1 et versions ultérieures.

Une fois la requête sur les projets activée, vous pouvez ajouter le champ projet d’équipe pour filtrer sur un nombre sélectionné de projets.

Azure Boards and TFS 2015.1, Web portal, Query across select projects using the In operator

Notes

Séparez les noms de plusieurs projets par le séparateur de liste qui correspond aux paramètres régionaux définis pour votre ordinateur client, par exemple, une virgule (,).

Le champ projet d’équipe devient disponible uniquement une fois que vous avez vérifié la requête entre les projets. En outre, lorsque la fonction interroger les projets est désactivée, seuls les champs de ces types d’élément de travail définis dans le projet actif s’affichent dans le menu déroulant champ. Lorsque l’option interroger les projets est activée, tous les champs de tous les types d’élément de travail définis dans tous les projets de la collection s’affichent dans le menu déroulant de champ.

Pour rechercher toutes les fonctionnalités créées dans tous les projets au cours des 30 derniers jours, supprimez la clause Team Project = @Project de la requête.

TFS 2013-2015, Web portal, Query across select projects using the In operator

Tous les champs de tous les types d’élément de travail définis dans tous les projets de la collection s’affichent toujours dans le menu déroulant de champ.

Utilisez Team Project = @Project pour définir la portée de la requête afin de rechercher uniquement les éléments de travail définis pour le projet actuel.

Définir une clause

Vous créez une requête en définissant une ou plusieurs clauses. Chaque clause définit un critère de filtre pour un champ unique. Choisissez Ajouter une nouvelle clause pour ajouter une autre clause, puis choisissez le champ, l' opérateur et la valeur pour cette clause.

Définissez une clause.

Par exemple, vous pouvez rechercher tous les éléments de travail qui vous sont assignés en spécifiant le champ affecté à , l’opérateur égal à (=) et la @Me macro qui représente votre identité d’utilisateur.

Exemple de clause de requête

et/ou Champ Opérateur Valeur

And

Affecté à

=

@

Pour obtenir une référence rapide des opérateurs disponibles en fonction du type de données du champ, consultez référence rapidede l’index de requête.

Toutes les clauses que vous ajoutez sont ajoutées en tant qu’instruction et . Choisissez ou pour modifier le regroupement. Vous regroupez des clauses pour vous assurer que les instructions de clause sont exécutées dans la séquence requise.

Conseil

Pour afficher la syntaxe WIQL d’une requête et la façon dont les parenthèses sont utilisées pour regrouper des clauses, installez l' éditeur WIQLde la place de marché. Cette extension prend en charge l’affichage de la syntaxe WIQL et l’exporte vers un fichier WIQL pour une utilisation dans les appels d’API REST. Pour plus d’informations, consultez syntaxe pour le langage WIQL (WIQL).

Liste de vérification pour la définition d’une clause de requête

  1. Dans la première ligne vide, sous l’en-tête de colonne champ , choisissez la flèche bas pour afficher la liste des champs disponibles, puis choisissez un élément dans la liste.

    Pour plus d’informations, consultez champs et valeurs de requête.

  2. Sur la même ligne, sous l’en-tête de colonne opérateur , choisissez la flèche bas pour afficher la liste des opérateurs disponibles, puis choisissez un élément dans la liste.

    Pour plus d’informations, consultez Opérateurs.

  3. Sur la même ligne, sous l’en-tête de colonne valeur , tapez une valeur ou cliquez sur la flèche orientée vers le bas, puis choisissez un élément dans la liste.

    Pour plus d’informations sur l’utilisation d’une macro ou d’une variable pour spécifier le projet, l’utilisateur, la date ou une autre sélection en cours, consultez variables.

  4. Pour ajouter une clause, choisissez Ajouter une nouvelle clause.

    Vous pouvez ajouter une clause à la fin de la requête, insérer une clause après une clause existante (icône de clause Insert) et Remove (icône de suppression de clause), groupe (icône de la clause Group) et dégrouper (icône dissocier la clause) si nécessaire.

Utiliser une arborescence d’éléments de travail pour afficher des hiérarchies

Utilisez la requête arborescence des éléments de travail pour afficher une liste imbriquée d’éléments de travail à plusieurs niveaux. Par exemple, vous pouvez afficher tous les éléments de backlog et leurs tâches liées. Développez  les nœuds (développer le nœud, portail Web ) ou réduire (  réduire le nœud, portail Web ) pour vous concentrer sur les différentes parties de l’arborescence.

Notes

Vous ne pouvez pas construire une requête qui affiche une vue hiérarchique des Test Plans, des suites de tests et des cas de test. Ces éléments ne sont pas liés en utilisant les types de liens parent-enfant. Toutefois, vous pouvez créer une requête de liens directs qui répertorie les éléments de travail liés au test. Vous pouvez également afficher la hiérarchie via la page Test>test plans.

Définissez les critères de filtre pour les éléments de travail parents et enfants. Pour rechercher les enfants liés, sélectionnez Rechercher d' abord les éléments de travail de niveau supérieur. Pour rechercher les parents liés, sélectionnez Rechercher d' abord les éléments de travail liés.

Utilisez la requête éléments de travail et liens directs pour suivre les éléments de travail qui dépendent d’autres travaux suivis, tels 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.

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.

Résultats de la requête de liens directs

Requête de liens directs, éditeur

Éditeur de 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 des liens correspondants: les éléments de travail de la première couche sont retournés, mais uniquement s’ils ont des liens vers les éléments de travail spécifiés par les critères de filtre d’éléments de travail liés.

  • Retourner tous les éléments 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 de liens correspondants: 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 liés.

Pour en savoir plus sur chaque type de lien, consultez liaison, traçabilité et gestion des dépendances.

Et/ou expression logique

Vous spécifiez and ou or pour créer des expressions logiques de vos clauses de requête. Spécifiez et pour rechercher les éléments de travail qui répondent aux critères dans la clause actuelle et dans la clause précédente. Spécifiez ou pour rechercher les éléments de travail qui répondent au critère dans la clause actuelle ou la clause précédente.

Vous pouvez ajouter une nouvelle clause pour chaque champ d'élément de travail pour affiner vos critères de recherche, de sorte qu'elle retourne uniquement le jeu d'é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.

Vous pouvez regrouper des clauses de requête pour qu’elles fonctionnent comme une unité unique distincte du reste de la requête, de la même façon que des parenthèses entourant une expression dans une équation mathématique ou une instruction logique. Lorsque vous regroupez des clauses, les clauses and ou or de la première clause du groupe s’appliquent à l’ensemble du groupe.

Grouper les clauses

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.

Comme le montrent les exemples suivants, les clauses groupées sont traduites en l’expression logique correspondante.

Conseil

Pour afficher la syntaxe WIQL d’une requête, installez l' extension de l’éditeur de requête WIQL qui vous permettra de voir la version WIQL de toute entrée de l’interface utilisateur de la requête. Cette extension vous permet de voir uniquement comment et/ou les clauses groupées sont traitées.

Requête Clauses regroupées Expression logique
1 Capture d’écran montrant une requête de la clause Group. Les filtres sont configurés pour le champ type d’élément de travail et le champ État ou le champ assigné à. Capture d’écran d’une expression logique. Un opérateur AND regroupe les champs type d’élément de travail, État et assigné à. Un opérateur OR regroupe l’État et assigné aux champs.
2 Capture d’écran montrant une requête de clause de groupe, avec des filtres pour le champ type d’élément de travail et l’un des champs État ou assigné à. Capture d’écran d’une expression logique. Un opérateur AND regroupe le type d’élément de travail avec l’État ou assigné aux champs, qui sont regroupés par un opérateur OR.
3 Capture d’écran montrant une requête de la clause Group. Les filtres sont configurés pour le champ type d’élément de travail ou à la fois dans le champ État et dans le champ assigné à. Capture d’écran d’une expression logique. Un opérateur ou lie le type d’élément de travail aux champs État et assigné à, qui sont liés par un opérateur AND.

Ces requêtes retournent des éléments de travail qui sont de type bogue et remplissent les expressions logiques suivantes :

  • Requête 1: et état = actif ou assigné à @Me
  • Requête 2: et (état = actif ou assigné à @Me )
  • Requête 3: ou (état = actif et affecté à @Me )

Pour regrouper une ou plusieurs clauses, sélectionnez-les, puis choisissez l' icône de clauses de groupe.

Portail Web, regrouper les clauses de requête sélectionnées

Vous pouvez également regrouper plusieurs clauses groupées en activant les cases à cocher de chaque clause qui a déjà été regroupée, puis en choisissant l' icône de clauses de groupe.

Regrouper plusieurs clauses de requête

Si les résultats de votre requête ne retournent pas les résultats attendus, procédez comme suit :

  • 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.
  • Passez en revue les options disponibles pour spécifier des champs, des opérateurs et des valeurs.

Dissocier une clause

Pour dissocier une clause, choisissez l’icône dissocier les clauses de la clause groupée.

Il s’agit des principes fondamentaux de la définition des requêtes. Pour obtenir un index des exemples de requêtes, consultez aide-mémoiresur les requêtes.