Champs, opérateurs et macros de requête dans Azure Boards

Description

Spécifie un champ qui prend une valeur True/False.

Un champ de date dans lequel vous pouvez spécifier une variable, telle que @Today ou @Today-1, ou une valeur, telle que 01/01/2025. Entrez des dates dans le modèle de date que vous définissez pour votre profil personnel. (Pour obtenir plus d’informations, consultez Définir des préférences personnelles). Pour obtenir des exemples de requêtes, voir Query by date or @CurrentIteration.

Pour les requêtes WIQL, vous pouvez également spécifier la date dans le modèle de temps universel coordonné (UTC). Si vous souhaitez obtenir plus d’informations, consultez Syntaxe du langage WIQL.

Nombre réel, tel que 0,2 ou 3,5. Pour obtenir des exemples de requête, consultez Interroger par champs numériques.

Chaîne de caractères qui représente un ID unique.

Champ à mise en forme personnalisée utilisé pour suivre les informations historiques. Ce type de données est uniquement utilisé pour prendre en charge le champ Historique. Ce champ est automatiquement indexé pour la recherche en texte intégral lorsque celle-ci est disponible. Consultez l’article Recherches de mots partiels et en texte intégral plus loin dans cette rubrique. Pour obtenir des exemples de requête, consultez Historique et audit.

Chaînes de texte qui prennent en charge des descriptions mises en forme, comme les champs Description ou Étapes de reproduction. Ces champs sont automatiquement indexés pour la recherche en texte intégral lorsque celle-ci est disponible. Consultez l’article Recherches de mots partiels et en texte intégral plus loin dans cette rubrique. Pour interroger des champs de texte enrichi, consultez Interroger par titre, ID et champs de texte enrichi.

Chaîne de texte courte qui identifie une identité utilisateur.

Entier 32 bits signé, tel que 0, 1, 2, 34.

Chaînes de texte qui prennent en charge de longues descriptions, comme le champ Informations de démarrage de l’application. Ces champs sont automatiquement indexés pour la recherche en texte intégral lorsque celle-ci est disponible. Consultez l’article Recherches de mots partiels et en texte intégral plus loin dans cette rubrique. Pour interroger des champs de texte brut, consultez Interroger par titre, ID et champs de texte enrichi.

Champ personnalisé défini pour contenir une liste de sélection de valeurs décimales.

Champ personnalisé défini pour contenir une liste de choix de valeurs entières.

Champ personnalisé défini pour contenir une liste de choix de valeurs de chaîne de texte courte (255 caractères ou moins).

Chaîne de texte courte qui contient jusqu'à 255 caractères Unicode. Les champs de texte de chaîne sont souvent utilisés pour prendre en charge les listes déroulantes ou les menus déroulants.

Arborescence de branchement, par exemple un chemin de zone ou un chemin d’itération. Choisissez un élément dans une liste de valeurs valides. Trouvez les éléments de travail égaux à, non égaux à, sous ou non sous une structure arborescente. Vous pouvez également utiliser les opérateurs In ou Not In pour spécifier plusieurs valeurs. Définissez la structure arborescente d'un projet, chemins de zone et chemins d'itération, puis sélectionnez ceux que vous souhaitez associer à une équipe.

Pour plus d’informations sur la construction de requêtes, consultez Interroger par zone ou chemin d’itération ou Interroger par date ou itération actuelle.

Retourne des éléments de travail si la valeur dans l’élément de travail correspond aux critères répertoriés

Types de données applicables

Correspond à la valeur dans la clause.

Nombre (qui inclut Double, GUID, Entier) et Chaîne, DateTime et TreePath

Ne correspond pas à la valeur dans la clause.

Nombre, Chaîne, DateTime et TreePath

Est supérieure à la valeur dans la clause.

Nombre, Chaîne et DateTime

Est inférieure à la valeur dans la clause.

Nombre, Chaîne et DateTime

Est supérieure ou égale à la valeur dans la clause.

Nombre, Chaîne et DateTime

Est inférieure ou égale à la valeur dans la clause.

Nombre, Chaîne et DateTime

Correspond à la valeur contenue dans le champ spécifié.

Nom d'un champ de même type de données que le champ spécifié
Vérifie si le champ booléen est égal à un autre champ

Ne correspond pas à la valeur contenue dans le champ spécifié.

Nom d'un champ de même type de données que le champ spécifié
Vérifie si le champ booléen n'est pas égal à un autre champ

Est supérieure à la valeur contenue dans le champ spécifié.

Nom d'un champ de même type de données que le champ spécifié

Est inférieure à la valeur contenue dans le champ spécifié.

Nom d'un champ de même type de données que le champ spécifié

Est supérieure ou égale à la valeur contenue dans le champ spécifié.

Nom d'un champ de même type de données que le champ spécifié

Est inférieure ou égale à la valeur contenue dans le champ spécifié.

Nom d'un champ de même type de données que le champ spécifié

Contient une correspondance exacte ou partielle de la chaîne de texte dans le champ sélectionné pour le filtrage.

Chaîne

Ne contient pas une correspondance exacte ou partielle de la chaîne de texte dans le champ sélectionné pour le filtrage.

Chaîne

Contient la chaîne de texte ou les mots exacts dans le champ que vous avez sélectionné pour le filtrage. Vous pouvez également taper des mots ou expressions partiels contenant le caractère générique *. La chaîne de texte est limitée à 100 caractères. Pour les restrictions, consultez Recherches en texte intégral pour connaître la configuration requise pour le serveur et le classement.

Champs de texte long indexés pour la recherche en texte intégral, qui correspondent à tous les champs PlainText et HTML, ainsi que les champs Historique et Titre.

Ne contient pas la chaîne de texte ou les mots exacts dans le champ que vous avez sélectionné pour le filtrage. La chaîne de texte est limitée à 100 caractères.

Utilisez cet opérateur en combinaison avec une clause avec l'opérateur Contains Words pour inclure et exclure des mots-clés spécifiques.

Champs de texte indexés pour la recherche en texte intégral.

Correspond à n'importe quelle valeur dans un jeu délimité. Par exemple, vous pouvez rechercher des éléments de travail dont les ID sont 100, 101 et 102 si vous spécifiez ces valeurs pour le champ ID. 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 pourriez utiliser une virgule ,.

Nombre, Chaîne, DateTime, TreePath

Répertorie les éléments de travail qui contiennent un champ HTML vide. Vous ne spécifiez pas de valeur avec cet opérateur. Cet opérateur est pris en charge pour Azure Boards et Azure DevOps Server.

HTML

Répertorie les éléments de travail qui contiennent du contenu dans le champ HTML. Vous ne spécifiez pas de valeur avec cet opérateur. Cet opérateur est pris en charge pour Azure Boards et Azure DevOps Server.

HTML

Ne correspond à aucune valeur dans un jeu délimité. Vous pouvez exclure des éléments de travail dont les états ne sont pas Résolus, Terminés ou Fermés des résultats de la requête si vous spécifiez ces valeurs pour le champ État. 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 pourriez utiliser une virgule ,.

L'opérateur Not In est pris en charge pour Azure Boards et Azure DevOps Server.

Nombre, Chaîne, DateTime, TreePath

Correspond à une valeur qui est membre du groupe dans la clause. Les groupes correspondent au nom d’une équipe, d’un groupe de sécurité ou d’une catégorie de suivi du travail. Par exemple, vous pouvez créer une requête pour trouver tous les éléments de travail assignés aux membres du groupe Contributors ou à une équipe. Les groupes d'équipe sont créés quand vous créez une équipe. Le nom des groupes d’équipes suit le modèle [Nom_Projet_Équipe]\Nom_Équipe.

Pour obtenir des exemples de requête, consultez Interroger par affectation ou modifications de workflow.

Chaîne qui correspond au nom d’une équipe, d’un groupe de sécurité ou d’une catégorie défini dans le système.

Pour plus d’informations, veuillez consulter la section Utiliser des catégories pour regrouper les types d’éléments de travail.

Ne correspond pas à une valeur qui est membre du groupe dans la clause.

String qui correspond au nom d’un groupe d'utilisateurs dans Azure DevOps Server ou à un groupe de catégories défini pour un projet.

Ne correspond pas à la valeur dans la clause et n’est pas contenue sous le nœud dans la clause.

TreePath

Correspond à la valeur dans la clause ou est contenue sous le nœud dans la clause.

TreePath

Correspond à la valeur dans la clause à un point précédent quelconque.

String, DateTime

Description

Utilisez avec les champs Type d’élément de travail ou État pour effectuer une recherche dans tous les types d’éléments de travail ou dans tous les états. Par exemple, Work Item Type=[Any] ne place aucun filtre basé sur le type d’élément de travail.

Utilisez avec le champ Chemin d’itération pour filtrer automatiquement les éléments de travail affectés au sprint actuel en fonction du focus ou du contexte d’équipe actuel. Pour obtenir des exemples spécifiques, consultez Requête par date ou itération actuelle.
La macro @CurrentIteration fonctionne uniquement lorsqu’elle est exécutée à partir du portail web. Vous ne pouvez pas utiliser la macro lors de la copie ou du clonage de suites de tests et de cas de test, de la définition d’alertes ou avec des API REST.

Utilisez avec le champ Chemin d’itération pour filtrer l’ensemble d’éléments de travail attribués au sprint actuel +/- n sprints en fonction du focus ou du contexte d’équipe actuel. Pour obtenir des exemples spécifiques, consultez Requête par date ou itération actuelle.
La macro @CurrentIteration +/- n est prise en charge pour Azure Boards, Azure DevOps Server lorsqu'elle est exécutée à partir du portail web.

Utilisez avec le champ ID et l’opérateur In pour répertorier tous les éléments de travail que vous suivez dans le projet. Pour plus d’informations, consultez Suivre un élément de travail ou une demande de tirage ( pull request). Vous pouvez afficher cette même liste à partir de la page Éléments de travail, vue croisée dynamique Suivi.
La macro @Follows est prise en charge uniquement lorsqu’elle est exécutée à partir du portail web.

Utilisez avec un champ d’identité ou de compte utilisateur pour rechercher automatiquement les éléments associés à votre nom d’utilisateur ou de compte. Par exemple, vous pouvez trouver des éléments de travail que vous avez ouverts avec la clause Created By=@Me. Pour plus d'exemples, veuillez consulter la section Faire une requête par attribution, workflow ou modifications du tableau.

Utilisez avec le champ ID et l'opérateur In pour répertorier les éléments de travail que vous avez consultés ou mis à jour dans le projet au cours des 30 derniers jours. Vous pouvez afficher cette même liste à partir de la page Éléments de travail, vue croisée dynamique Mon activité.

Utilisez avec le champ Projet d’équipe pour filtrer les éléments de travail dans d’autres projets. Par exemple, vous pouvez trouver tous les éléments de travail dans le projet actuellement sélectionné avec la clause Team Project=@Project. Le système effectue automatiquement un filtrage par défaut en fonction du projet actuel. Pour obtenir plus d’informations, consultez Définir une requête, Interroger entre les projets.

Utilisez avec le champ ID et l'opérateur In pour répertorier les éléments de travail dans lesquels vous êtes mentionné dans la section Discussion. Vous pouvez afficher cette même liste à partir de la page Éléments de travail, vue croisée dynamique Mentionné.

Utilisez avec le champ ID et l'opérateur In pour répertorier les éléments de travail récemment mis à jour. Le nombre d’éléments de travail répertoriés dépend de l’activité de suivi du travail du projet. Pour les projets très actifs, la macro répertorie les éléments de travail mis à jour dans le projet au cours des 30 derniers jours environ. Toutefois, pour les projets moins actifs, cette liste peut inclure des éléments de travail remontant à plus de 30 jours. Vous pouvez afficher des listes similaires à partir de la page Éléments de travail, vues croisées dynamiques Récemment créé, Récemment mis à jour et Achèvement récent. Le nombre d’éléments de travail retournés est limité à 5 000.

Utilisez un champ DateTime pour filtrer les éléments de travail liés à la date actuelle avec un décalage plus/moins. Par exemple, vous pouvez trouver tous les éléments fermés au cours de la dernière semaine avec la clause Closed Date>=@StartOfDay-7. Pour plus d’exemples, consultez Requête par date ou itération actuelle.

Utilisez avec un champ DateTime pour filtrer les éléments de travail liés au mois en cours ou avec un décalage plus/moins. Par exemple, vous pouvez trouver tous les éléments créés au cours des trois derniers mois avec la clause Created Date>=@StartOfMonth-3. Pour plus d’exemples, consultez Requête par date ou itération actuelle.

Utilisez un champ DateTime pour filtrer les éléments de travail liés à la semaine actuelle avec un décalage plus/moins. Par exemple, vous pouvez trouver tous les éléments modifiés au cours des deux dernières semaines avec la clause Changed Date>=@StartOfWeek-2. Pour plus d’exemples, consultez Requête par date ou itération actuelle.

Utilisez un champ DateTime pour filtrer les éléments de travail liés à l’année actuelle avec un décalage plus/moins. Par exemple, vous pouvez trouver toutes les fonctionnalités dont la date cible est planifiée au cours de l’année en cours avec la clause Target Date>=@StartOfYear. Pour plus d’exemples, consultez Requête par date ou itération actuelle.

Utilisez uniquement avec le champ Chemin de zone pour filtrer les éléments de travail dont le chemin de zone correspond à celui attribué à une équipe spécifique. Vous devez utiliser l’opérateur =. Par exemple, vous pouvez trouver tous les éléments affectés aux chemins de zone attribués à l’équipe web avec la clause Area Path=@TeamAreas [Fabrikam Fiber]\Web. Pour plus d’exemples, consultez Requête par zone ou chemin d’itération.
La macro @TeamAreas est prise en charge uniquement pour Azure DevOps Server lorsqu'elle est exécutée à partir du portail web.

Utilisez un champ DateTime pour filtrer les éléments de travail liés à la date actuelle ou à une date antérieure. Vous pouvez également modifier la macro @Today en retirant des jours. Par exemple, vous pouvez trouver tous les éléments créés au cours de la dernière semaine avec la clause Created Date>=@Today-7. Pour plus d’exemples, consultez Requête par date ou itération actuelle.