Partager via

Requête par comparaisons de valeurs de champ

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

Utilisez des opérateurs de champ de comparaison lorsque vous souhaitez filtrer les éléments de travail en comparant la valeur d’un champ à la valeur d’un autre champ. Les utilisations courantes sont les suivantes :

  • Recherchez des éléments de travail où le créateur est différent de l'assigné ou du clôturant.
  • Recherchez les tâches dont l’estimation d’origine est inférieure au travail terminé.
  • Recherchez les tâches fermées qui se sont terminées avant leur date cible.

Prérequis

Catégorie Exigences
Niveaux d’accès - Pour afficher et exécuter des requêtes partagées : membre du projet.
- Pour ajouter et enregistrer une requête partagée : au moins un accès de base (Basic).
Permissions Autorisation Contribuer définie sur Autoriser pour le dossier auquel vous souhaitez ajouter une requête. Par défaut, le groupe des contributeurs ne dispose pas de cette autorisation.

Remarque

Les utilisateurs disposant d'un accès Stakeholder pour un projet public ont un accès complet aux fonctionnalités de requête, tout comme les utilisateurs disposant d'un accès Basic. Pour plus d’informations, consultez Référence rapide sur l’accès de partie prenante.

Catégorie Exigences
Niveaux d’accès - Pour afficher et exécuter des requêtes partagées : membre du projet.
- Pour ajouter et enregistrer une requête partagée : au moins un accès de base (Basic).
Permissions Autorisation Contribuer définie sur Autoriser pour le dossier auquel vous souhaitez ajouter une requête. Par défaut, le groupe des contributeurs ne dispose pas de cette autorisation.

Types de données pris en charge

Vous pouvez utiliser les opérateurs de comparaison ( =[Field], , <>[Field]>[Field]<[Field], >=[Field], , ) <=[Field] avec les types de données répertoriés suivants. Le type de données du champ de gauche et le champ de droite doivent correspondre.

  • Boolean (prend en charge =[Field], <>[Field])
  • Date et heure
  • Double, Entier
  • GUID
  • Identité
  • Chaîne (à l’exception des étiquettes)

Remarque

Certains types de données/combinaisons d’opérateurs sont nonsensiques (par exemple, Title >= [Field] ou Assigned To <= [Field]). Validez votre comparaison pour vous assurer que les deux côtés utilisent des types de données compatibles.

Exemples de filtres

Utilisez ces exemples de clauses comme point de départ. La syntaxe exacte dans l’Éditeur de requête peut varier légèrement selon le client ; en cas de doute, générez la clause dans l’Éditeur de requête web et vérifiez le WIQL enregistré.

  • Éléments de travail fermés par une personne autre que la personne qui a créé l’élément de travail : [Créé par] [Fermé par] <> AND [État] = 'Fermé'

  • Tâches dont l’estimation d’origine est inférieure au travail terminé : [Estimation d’origine] < [Travail terminé]

  • Tâches fermées terminées avant leur date cible : [Date fermée] <= [Date cible] AND [État] = 'Fermé'

Champs qui prennent en charge la comparaison de champs

Le tableau ci-dessous répertorie les champs qui prennent en charge les requêtes de comparaison. Tous les champs ne sont pas disponibles pour chaque type d’élément de travail ou de processus ; certains nécessitent des champs personnalisés ou une configuration de processus. Consultez la note qui suit pour les liens de personnalisation.

Remarque

Tous les champs répertoriés ne sont pas présents dans chaque projet/processus. Vous pouvez ajouter des champs personnalisés et les activer pour les comparaisons. Consultez Ajouter un champ personnalisé à un type d’élément de travail (processus hérité) ou Ajouter ou modifier un champ (processus XML local).

A

B

C

D-F

H

I

J-N

O-Q

R

S

T

U-W

Remarque

La prise en charge de la comparaison champ par champ varie selon le client. L'éditeur de requêtes web prend en charge la plupart des comparaisons de champs. Les comparaisons complexes (par exemple, certaines utilisations de WAS EVER ou d'expressions WIQL avancées) nécessitent de modifier directement le WIQL (extension éditeur WIQL). En cas de doute, générez la clause dans l’Éditeur de requête web et inspectez le WIQL enregistré.

Contenu connexe

API REST

Pour interagir par programmation avec des requêtes, consultez l’une de ces ressources d’API REST :

Conseil / Astuce

Si vous avez besoin de noms de référence pour WIQL ou REST (par exemple, ou System.IterationIdMicrosoft.VSTS.Common.Priority), consultez les champs et attributs d’élément de travail.

  • Last updated on