Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020
Utilisez des requêtes pour répertorier les bogues, les récits utilisateur ou d’autres éléments de travail en fonction des critères de champ que vous spécifiez. Les équipes utilisent ces listes pour trier le travail, mettre à jour massivement les éléments ou passer en revue les hiérarchies. La recherche sémantique offre des fonctionnalités qui se chevauchent et des fonctionnalités complémentaires qui méritent d’être explorées.
Utilisez des requêtes gérées pour :
- Mettre à jour en bloc des éléments de travail à l’aide du portail web
- Trier et mettre à jour des éléments de travail
- Passer en revue une hiérarchie d’éléments de travail
- Partager une liste d’éléments de travail avec un collègue
Vous pouvez créer des requêtes et des dossiers de requêtes à partir du portail web ou de Visual Studio Team Explorer. Les modifications que vous apportez dans un client apparaissent dans les autres, car toutes les modifications sont stockées dans le stockage de données de suivi du travail.
Prise en main des requêtes
Si vous débutez, lisez visualisez, exécutez, ou envoyez par e-mail une requête de tâche de travail. Pour obtenir une référence rapide aux tâches de l’éditeur de requête et à des exemples de requêtes, consultez Référence rapide des requêtes.
- Pour rechercher des éléments de travail attribués à vous, utilisez la macro @Me comme valeur du champ Affecté à dans une clause.
- Tous les utilisateurs valides disposant d’un accès standard peuvent créer des requêtes et des dossiers sous Mes requêtes. Pour créer des requêtes ou des dossiers sous Requêtes partagées, vous devez disposer de l’autorisation Contribuer. Consultez Définir des autorisations sur les requêtes.
- Modifiez une requête en ajoutant des critères pour vous concentrer sur une zone de produit, une itération ou un autre champ. Pour modifier une requête, ouvrez l’éditeur de requête.
- Ouvrez n’importe quelle requête dans Excel pour mettre à jour les champs et publier des modifications dans la base de données.
- Visualisez l’état ou la progression en créant un graphique en secteurs, en colonne ou en courbes de tendance pour les requêtes de liste plate. Pour plus d’informations, consultez Graphiques.
Interrogation des données par requête
Les sections suivantes résument les fonctions que vous utilisez pour définir et gérer les requêtes d’élément de travail.
- Définissez des filtres de requête avec l’Éditeur de requête.
- Utilisez des macros de requête dans des clauses pour cibler des champs dynamiquement.
- Gérer les résultats et les dossiers des requêtes à partir de la page Résultats de la requête.
Filtres de requête
Le tableau suivant récapitule les fonctions de filtre de requête prises en charge par chaque version d’Azure DevOps.
Remarque
Les requêtes managées ne prennent pas en charge les recherches de proximité, mais les recherches sémantiques le font. 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 génériques. Pour plus d’informations, consultez Recherche d’éléments de travail fonctionnels.
Fonction Filter
Prise en charge des requêtes
Versions prises en charge
Recherches de chaînes de texte (texte unique, texte sur plusieurs lignes, texte enrichi)
Les recherches ne respectent pas la casse.
Toutes les versions
Caractère générique = *
Toutes les versions
Recherchez des éléments de travail en fonction de liens directs ou de types de liens topologiques/hiérarchiques.
Filtrer les éléments de travail liés en fonction de MODE (syntaxe WIQL)
Toutes les versions
Regrouper et imbriquer des clauses à l’aide des opérateurs booléens AND et OR.
Toutes les versions
Recherchez des éléments de travail en fonction d’une correspondance de champ avec une valeur précédente.
Opérateur pris en charge : Was Ever Recherchez des éléments de travail en fonction d’une valeur définie à une date spécifique.
Opérateur pris en charge : ASOF (syntaxe WIQL)
Toutes les versions
Utilisez des macros pour créer des requêtes relatives à une date, d’autres outils, comme le chemin de zone de l’équipe, l’itération d’équipe, etc.
Toutes les versions
Recherchez des éléments de travail dans un ou plusieurs projets d’une organisation ou d’une collection. La valeur par défaut est le projet actuel. Utilisez le champ Projet d’équipe pour interroger deux projets ou plus.
Toutes les versions
Recherchez des éléments de travail en fonction de la façon dont deux champs se comparent l’un à l’autre.
Opérateurs pris en charge : =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
Toutes les versions
Recherchez des éléments de travail selon qu’ils contiennent ou non une balise.
Opérateurs pris en charge : Contains, Does Not Contain
Toutes les versions
Recherchez des éléments de travail basés sur des champs HTML/texte enrichi vides ou non vides.
Opérateurs pris en charge : Is Empty, Is Not Empty
Toutes les versions
Recherchez un travail dont la valeur de champ correspond à n’importe quelle valeur d’un ensemble délimité, comme un ensemble de types d’élément de travail, d’états de workflow ou de valeurs de liste de sélection. Valeurs séparées avec le séparateur de liste qui correspond aux paramètres régionaux définis pour votre ordinateur client. Par exemple, vous pouvez utiliser une virgule (,).
Toutes les versions
Recherchez des éléments de travail en fonction de la valeur d’un champ booléen.
Toutes les versions
Recherchez des éléments de travail sur la base de mots clés ou d’expressions ajoutés par le biais de la discussion.
Toutes les versions
Recherchez des éléments de travail en fonction de leur colonne, de leur couloir ou de leur statut En cours/Terminé.
Toutes les versions
Filtrez les résultats de requête en fonction d’un mot clé ou de champs sélectionnés.
Toutes les versions
Pour déplacer, copier ou coller en bloc des clauses de requête, installez et utilisez l’éditeur WIQL.
Macros prises en charge
Le tableau suivant récapitule les macros ou variables de requête prises en charge par les versions d’Azure DevOps. Vous pouvez utiliser certaines de ces macros pour filtrer les notifications.
Remarque
Vous pouvez utiliser certaines macros à partir du portail web uniquement. Il s’agit notamment des macros @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity et @TeamAreas. Ces macros ne sont pas prises en charge lors de l’exportation d’une requête vers Excel, pour les filtres de notification ou à partir de Team Explorer ou des API REST.
Pour obtenir des descriptions plus détaillées et des liens vers des exemples, consultez Champs de requête, opérateurs et macros.
Macro
Prise en charge des requêtes
Versions prises en charge
Recherchez n’importe quel type d’élément de travail, Work Item Type=[Any], ou n’importe quel état, State=[Any].
Toutes les versions
Recherchez le travail où Identity field=logged in user.
Toutes les versions
Recherchez le travail où Date-Time field=today.
Toutes les versions
Recherchez le travail défini dans un ou plusieurs projets.
Toutes les versions
Recherchez le travail défini dans l’itération actuelle pour une équipe.
Toutes les versions
Recherchez le travail défini à +/- n de l’itération actuelle pour une équipe.
Toutes les versions
Recherchez le travail où l’utilisateur actuellement connecté est le suivant, ID In @Follows.
Toutes les versions
Recherchez des éléments de travail récemment modifiés, ID In @MyRecentActivity Voir aussi Afficher et ajouter des éléments de travail, page Éléments de travail.
Toutes les versions
Recherchez le travail où le champ date-heure sélectionné se trouve dans le jour, le mois, la semaine ou l’année en cours avec un décalage plus/moins, par exemple : Closed Date>=@StartOfDay-7.
Toutes les versions
Recherchez le travail affecté à un chemin de zone ou à un chemin d’itération de l’équipe spécifiée. Pour obtenir des exemples, consultez Requête par chemin de zone ou d’itération.
Toutes les versions
Résultats des requêtes et fonctionnalités de gestion des requêtes
Les fonctionnalités suivantes prennent en charge l’utilisation des résultats des requêtes, l’enregistrement et le partage de requêtes, et plus encore.
-
Ajouter un graphique de requête à un tableau de bord
-
Appliquer des filtres interactifs
-
Choisir le tri des colonnes
-
Choisir les options de colonne de requête
-
Copier des résultats de requête
-
Copier l'URL de requête
-
Créer des graphiques de requête
-
Créer des dossiers de requête
Fonctionnalités non prises en charge
Les requêtes prennent en charge uniquement les éléments de travail et leurs liens avec d'autres éléments. Les requêtes contrôlées ne sont pas supportées par :
- Vues hiérarchiques des plans de test, des suites de test et des cas de test (ces éléments n’utilisent pas de liens parent-enfant). Au lieu de cela, affichez la hiérarchie sur la page Plans de test >.
- Vues qui affichent des objets liés tels que des builds, des versions, du code ou d'autres objets qui ne sont pas des éléments de travail.
- Lister les éléments de travail liés d’un projet à un autre.
- Exportation d’une requête inter-projets vers Excel (les requêtes de liens directs exportent en tant que liste plate).
Types de requêtes (plates, liens directs, arborescence)
Azure Boards prend en charge trois types de requêtes ; l’icône en regard d’une requête indique son type. Choisissez le type en fonction des résultats dont vous avez besoin.
Type de requête
Conseils d’utilisation
Liste plate des éléments de travail
- Répertorier les éléments pour effectuer des mises à jour en bloc
- Trier une liste d’éléments de travail
- Créer un graphique de requête et l’ajouter à un tableau de bord
- Créer un graphique pour compter des éléments ou additionner un champ numérique
- Exporter une liste vers Excel pour mettre à jour les champs
Éléments de travail et liens directs
- Répertorier les éléments qui dépendent d’autres éléments de travail
- Rechercher des éléments connexes ou dépendants
- Répertorier les éléments de travail liés pour effectuer des mises à jour en bloc
- Triage des éléments liés à des travaux, y compris les liens relatifs aux tests
- Rechercher des éléments de backlog orphelins (éléments sans parent)
Remarque
Les requêtes d’éléments de travail et de liens directs s’exportent vers Excel sous forme de liste plate. Excel les importe en tant que liste plate, car Excel ne prend pas en charge la modification de plusieurs types de liens.
Arborescence des éléments de travail
- Répertorier une arborescence d'éléments de travail liés Parent-Enfant ou d'autres types de liens topologiques en arborescence
- Triage des listes hiérarchiques d’éléments de travail
- Exporter une liste hiérarchique vers Excel pour mettre à jour des champs ou modifier une hiérarchie
Pour en savoir plus sur les types de lien, consultez Référence des types de lien.
Mes requêtes, Requêtes partagées et Favoris
Vous pouvez uniquement afficher et exécuter des requêtes enregistrées sous Mes requêtes. Ajoutez une requête aux favoris pour qu'elle apparaisse dans votre sélecteur de requêtes.
Les requêtes enregistrées sous Requêtes partagées sont visibles par tous les utilisateurs disposant d’un accès au projet. Organisez les requêtes partagées dans les dossiers et les favoris pour un accès rapide. Vous pouvez définir des autorisations sur les dossiers et les requêtes pour empêcher d’autres personnes de les déplacer ou de les modifier.
Pour plus d’informations, voir :
- Gérer les requêtes et les dossiers de requêtes
- Définir des autorisations de requête
- Ajouter une requête aux favoris et Définir les favoris personnels ou d’équipe
Répertoire de requête, dossiers de requête et navigation
La page Requêtes fournit des favoris et tous les onglets. Chaque onglet affiche une vue de répertoire que vous pouvez filtrer pour rechercher des requêtes spécifiques.
Lorsque vous naviguez dans les pages Requêtes , vous pouvez ouvrir un dossier, un sous-dossier ou une page de requête.
Lorsque vous effectuez des sélections, les barres de navigation apparaissent en haut de la page. Utilisez-les pour accéder à un dossier, un sous-dossier ou une page de requête.
Vous pouvez également sélectionner une requête favorite ou revenir à la page des Toutes les requêtes à partir du menu déroulant d’une requête ouverte.
Pour plus d’informations, consultez Questions fréquentes (FAQ) sur les requêtes, la navigation et les dossiers.
Graphiques de requête et widgets
Créez des graphiques à secteurs, barres, pivots et tendances à partir d’une requête de liste plate (les requêtes doivent retourner 1 000 éléments de travail ou moins). Ajoutez des graphiques de requête aux tableaux de bord, remettez-les en forme et reconfigurez-les selon vos besoins.
Les widgets basés sur des requêtes affichent des informations de requête sur un tableau de bord (par exemple, le nombre de bogues actifs ou une liste interactive d’éléments de travail). Pour en savoir plus, consultez :
- Graphique de requête de liste plate
- Diagramme pour le widget des éléments de travail
- Widget de résultats de requête
- Widget de vignette de requête
Ajouter un champ personnalisé pour prendre en charge les requêtes
Pour ajouter un champ personnalisé pour les requêtes, consultez Personnaliser votre expérience de suivi du travail.
Éléments de liste des tâches et de requête
Si le contenu du tableau de tâches diffère des résultats d’une requête créée, consultez les éléments du tableau de tâches et les éléments de liste de requêtes pour plus d’informations.
Requêtes de recherche en texte intégral et paramètres de classement
Si vous utilisez des requêtes de recherche en texte intégral avec les opérateurs Contains ou Contains Words, vérifiez que le classement SQL Server correspond à une langue avec un analyseur de mots enregistré. Les langues non prises en charge peuvent produire des résultats inattendus.
Pour plus d’informations, voir :
API REST
Pour interagir par programmation avec des requêtes, consultez l’une de ces ressources d’API REST :
- Référence de l’API REST des services Azure DevOps
- Requêtes
- Langage de requête des éléments de travail
- Récupérez les éléments de travail avec des requêtes de manière programmatique