Partage via

Utiliser un index pour interroger des données de référence rapides dans Azure Boards et Azure DevOps

  • Article

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019

Utilisez cet index pour accéder rapidement aux exemples de requête et aux informations sur l’ouverture, la définition et l’utilisation de requêtes. Pour savoir comment utiliser l’Éditeur de requête, consultez Définir une requête. Si vous constatez que vos requêtes prennent trop de temps à donner des résultats, consultez Définir une requête/meilleures pratiques.

Exemples de requêtes

Vous pouvez répertorier les éléments de travail en fonction des critères suivants...

Mots clés, requêtes génériques

Requêtes basées sur des étiquettes

Requêtes de modification d’état, de raison ou de workflow

Requêtes basées sur la date et l’itération

Requêtes de nombre de liens et de pièces jointes

Requêtes basées sur l’identité

Nombre d’éléments de travail et requêtes de champ numérique

Historique, discussion et requêtes de modification-révision

Requêtes de focus d’équipe

Générer et tester des requêtes de champ

Autres

Tâches de requête

Opérateurs et macros pris en charge pour chaque type de données

Le tableau suivant indique les opérateurs et les macros disponibles pour les différents types de données de champ. Chaque champ est associé à un type de données. Vous trouverez le type de données répertorié dans les descriptions de chaque champ, que vous pouvez rechercher à l’aide de l’Index des champs d’élément de travail. Les opérateurs disponibles pour définir une clause de requête dépendent du type de données du champ que vous sélectionnez. Pour obtenir des descriptions plus détaillées des types de données, des opérateurs et des macros, consultez Champs de requête, opérateurs et macros.

Notes

Les macros suivantes sont uniquement prises en charge à partir du portail web : @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity et @TeamAreas. Les requêtes qui contiennent ces macros ne fonctionnent pas lorsqu’elles sont ouvertes dans Visual Studio/Team Explorer, Microsoft Excel ou Microsoft Project.

Type de données

Description

Opérateurs et macros pris en charge

Booléen

Prend en charge une valeur True/False. Exemples de requête : Interroger par affectation ou modifications de workflow.

= , <> , =[Field] , <>[Field]

DateTime

Champ de date dans lequel vous pouvez spécifier une variable, comme @Today ou @Today-1, ou une valeur, comme 1/1/2012. Entrez des dates dans le modèle de date que vous définissez pour votre profil personnel. Pour plus d’informations, consultez Définir des préférences personnelles.

Pour obtenir des exemples de requête, consultez Interroger par date ou @CurrentIteration.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
Macros : @Today, valide avec n’importe quel champ DateTime

Macros supplémentaires prises en charge sur Azure DevOps 2019 Update 1 et versions ultérieures :
@StartOfDay, @StartOfWeek, @StartOfMonth et @StartOfYear, valides avec n’importe quel champ DateTime

Double

Également appelé Décimal et inclut picklistDouble1. Nombre réel, tel que 0,2 ou 3,5.

Exemples de requête : Interroger par champs numériques.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

GUID

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

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

History

Champ mis en forme personnalisé utilisé pour suivre les informations historiques et affecté uniquement au champ Historique.

Exemples de requêtes : Historique et audit.

Contains Words, Does Not Contain Words

HTML

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. Exemples de requête : Interroger par titre, ID et champs de texte enrichi.

Contains Words, Does Not Contain Words, Is Empty2, Is Not Empty2

Identité

Champ chaîne utilisé pour contenir une identité d’utilisateur. Exemples de requête : Interroger par affectation ou modifications de workflow.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was EverMacros : @me valide pour tous les champs Identité.

Integer

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

Exemples de requête : Interroger par champs numériques

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever

Macros : @Follows, @MyRecentActivity, @RecentMentions et @RecentProjectActivity, valides lorsqu’elles sont utilisées avec le champ ID.

Texte brut

Chaînes de texte multilignes qui prennent en charge les descriptions longues et sont automatiquement indexées pour la recherche en texte intégral, lorsque la recherche en texte intégral est disponible.
Exemples de requêtes : Interroger par titres, ID et champs de texte enrichi.

Contains Words, Does Not Contain Words, Is Empty, Is Not Empty

Chaîne

Inclut également picklistString1. Chaîne de texte à ligne unique qui contient jusqu’à 255 caractères Unicode. Les champs de chaîne prennent en charge le champ Titre, les listes de sélection (menus déroulants), les comptes d’utilisateur, les étiquettes et d’autres champs.

Exemples de requête : Interroger par titre, ID et champs de texte enrichi et Requête par valeur de liste de choix.

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was Ever

Macros : [Any], valide avec le champ Type d’élément de travail, @Project, valide avec le champ Projet d’équipe.

TreePath

Type de champ qui prend en charge les champs Chemin de zone et Chemin d’itération. Vous définissez l’arborescence d’un projet : Chemins de zone et Chemins d’itération.

Exemples de requête : Requête par chemin de zone ou d’itération et Requête par date ou itération actuelle.

Under, Not Under, =, <>, In, Not In

Macros : @TeamAreas3, valide avec le champ Chemin de zone
@CurrentIteration et @CurrentIteration+/- n4, valides avec le champ Chemin d’itération

Notes

  1. Les types de données liste de sélection... sont uniquement affectés aux champs personnalisés définis pour un processus hérité. Le modèle de processus hérité est pris en charge uniquement pour Azure DevOps Server 2019 et versions ultérieures.
  2. Les opérateurs Is Empty et Is Not Empty sont pris en charge pour Azure DevOps Server 2019 RC2 et versions ultérieures.
  3. La macro @TeamAreas est prise en charge pour Azure Boards et Azure DevOps Server 2019 et versions ultérieures.
  4. La macro @CurrentIteration +/- n est prise en charge pour Azure DevOps Server 2019 et versions ultérieures, et uniquement lorsqu’elle est exécutée à partir du portail web.

Modèle de date et d’heure

Le modèle de date et d’heure que vous entrez pour les champs DateTime doit correspondre à celui que vous sélectionnez dans votre profil. Pour afficher ou modifier votre sélection, consultez Définir les préférences utilisateur.

Capture d’écran montrant les options de liste déroulante Modèle de date dans le volet Heure et paramètres régionaux.Capture d’écran montrant les options de liste déroulante Modèle d’heure dans le volet Heure et paramètres régionaux.

Capture d’écran montrant le volet Heure et paramètres régionaux avec les champs Modèle de date et Modèle d’heure.

Exemples de requêtes pour des champs sélectionnés

Le tableau suivant répertorie les champs de requête courants et leur type de données pour lesquels des exemples de requêtes sont fournis. Pour déterminer le type de données d’un champ, consultez Champs et attributs d’élément de travail, Attributs de champ de liste.

Un

B

C

D-E-F

H-P

R

S

T

V-W