Requête par date ou itération actuelle

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

Cet article montre comment répertorier les éléments de travail en créant, modifier, résoudre ou fermer des dates et comment utiliser des macros de date (par exemple @Today) et des macros d’itération pour les sprints d’équipe. Pour connaître les notions de base du chemin d’itération et les restrictions client/macro, consultez Requête par zone ou chemin d’itération.

Prerequisites

Opérateurs et macros de date pris en charge

Utilisez les opérateurs et macros suivants pour les champs DateTime et Itération Path dans l’Éditeur de requête.

• Opérateurs Date et Heure : = , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was Ever
• Macros de date : @StartOfDay, , @StartOfWeek@StartOfMonth, @StartOfYear,@Today
  Vous pouvez combiner +/- n avec ces macros (par exemple, @Today - 7).
• Macros d’itération : @CurrentIteration et @CurrentIteration +/- n (consultez la note et le lien suivants pour les restrictions du client et le comportement des paramètres d’équipe).

Exemples de dates rapides (requêtes courantes)

• Éléments créés au cours des 30 derniers jours :

• Éléments modifiés à une date spécifique :

• Éléments résolus aujourd’hui :

• Éléments fermés dans une période spécifiée :

• Éléments dont la date fermée est null (non fermée) :

• Éléments dont l’état a changé au cours de la dernière semaine :

Utilisation des @CurrentIteration macros (guide court)

Permet @CurrentIteration de cibler le sprint actuel de l’équipe et @CurrentIteration +/- n de créer une fenêtre glissante de sprints (par exemple, les deux derniers, actuels et deux sprints suivants). Points importants :

• @CurrentIteration retourne les éléments affectés au sprint actuel pour le contexte d’équipe utilisé lors de l’exécution de la requête.
• @CurrentIteration +/- n déplace cette fenêtre de sprints par n ; utile pour les analyses de tendance ou de report.
• Étant donné que le comportement des macros et la prise en charge des clients varient, consultez le chemin requête par zone ou itération pour plus d’informations sur les paramètres d’équipe, les clients qui évaluent les macros et la façon dont les macros sont stockées/développées lors de l’enregistrement des requêtes.

Exemples d’images (Éditeur de requête du portail web) :

Macros de date : début de jour/semaine/mois/année

Les macros de début permettent de créer des plages de dates relatives cohérentes :

• @StartOfDay, , @StartOfWeek, @StartOfMonth, @StartOfYear— utilisez ces macros avec +/- n pour générer des plages telles que « depuis le début de la semaine » ou « les 3 derniers mois ».
• Ces macros sont évaluées par l’interface utilisateur du portail web ; leur comportement dans les scénarios nonweb peut différer : tester dans votre client cible.

Exemples de requêtes :

Quand utiliser WIQL directement

Utilisez WIQL quand :

• Vous avez besoin d’opérateurs avancés tels que WAS EVER pour les modifications de chemin d’itération.
• L’Éditeur de requête bloque ou marque une clause comme non prise en charge (par exemple, certaines Was Ever utilisations). L’extension éditeur WIQL vous permet de créer ces requêtes et de les enregistrer.

Pour obtenir des exemples, consultez la syntaxe WIQL (Work Item Query Language) et l’extension de la Place de marché de l’éditeur WIQL.

Contenu connexe

• Requête par chemin de zone ou d’itération
• Syntaxe du langage de requête d’élément de travail (WIQL)
• Champs, opérateurs et macros de requête
• Champs et attributs d’éléments de travail.

REST API

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
• Queries
• 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