Requête par date ou itération actuelle dans Azure Boards

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

Dans cet article, découvrez comment répertorier les éléments de travail en fonction de leur date de création, de clôture, de résolution ou de modification. Vous pouvez spécifier une date ou utiliser une macro prise en charge. Utilisez la macro @Today et spécifiez un nombre de jours plus ou moins pour les dates relatives. Pour les requêtes qui répertorient les éléments de travail en fonction de leur affectation au sprint actuel d’une équipe, utilisez @CurrentIteration.

Vous pouvez, par exemple, rechercher les éléments de travail qui ont été modifiés au cours des trois derniers jours à l’aide de la requête suivante.

Opérateurs et macros pris en charge

Les clauses de requête qui spécifient un champ DateHeure ou le champ Chemin de l’itération peuvent utiliser les opérateurs et les macros répertoriés dans le tableau suivant.

Remarques :

1. Les macros @StartOfDay, @StartOfWeek, @StartOfMonth et @StartOfYear sont prises en charge pour Azure DevOps Server 2019.1 et les versions ultérieures. Elles ne sont prises en charge que lorsqu’elles sont exécutées depuis le portail web.
2. La macro @CurrentIteration +/- n est prise en charge pour Azure DevOps Server 2019 et les versions ultérieures. Elle est uniquement prise en charge lorsqu’elle est exécutée depuis le 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.

Restrictions du client sur l’utilisation des macros @CurrentIteration

Vous pouvez utiliser la macro @CurrentIteration dans une requête à partir des clients suivants :

• Portail web qui se connecte à Azure Boards
• Visual Studio 2019 ou versions ultérieures connectées à Azure Boards
• L’API REST

Vous pouvez utiliser la macro @CurrentIteration +/- n dans une requête sur Azure Boards, Azure DevOps Server 2019 et versions ultérieures et avec une API REST qui inclut l’équipe en tant que paramètre. par exemple @CurrentIteration('[Project]\Team').

Une erreur se produit si vous ouvrez une requête qui contient la macro @CurrentIteration dans les versions antérieures de Visual Studio ou à partir de Microsoft Excel ou de Microsoft Project. 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.

Requêtes basées sur la date

Filtrez les éléments de travail en fonction de la date à laquelle ils ont été modifiés ou sur une période spécifique. Limitez la portée de votre requête. Cette approche peut aider à améliorer les performances en ne renvoyant que les résultats correspondant à la plage de dates incluse. Si vous êtes novice dans la création de requêtes, consultez Définir une requête d’élément de travail.

Tous les champs ne sont pas valides pour tous les types d’éléments de travail. Accédez aux champs de date pour l’ensemble de champs que vous pouvez inclure dans les requêtes et les types d’éléments de travail auxquels ils s’appliquent.

Créer des requêtes pour l’itération actuelle de votre équipe

Si votre équipe suit les processus Scrum, vous planifiez l’exécution du travail dans les sprints. Vous pouvez suivre la progression des exigences, des bogues et d’autres tâches à terminer dans le sprint actuel à l’aide de la macro @CurrentIteration. Pour plus d’informations, consultez Gérer les calendriers de sprints.

La requête trouve tout élément assigné à un sprint qui correspond au chemin d’itération actuel de l’équipe. Par exemple, si une équipe se trouve sur Sprint 5, la requête retourne les éléments affectés au Sprint 5. Plus tard, lorsque l’équipe travaille dans Sprint 6, la même requête retourne les éléments affectés au Sprint 6.

Répertorier des éléments de travail déplacés hors du sprint

Répertoriez les éléments de travail qui ont été définis pour un sprint, mais qui ont ensuite été déplacés en utilisant une requête dont une clause contient l’opérateur Was Ever pour le champ Chemin de l’itération. Vous pouvez uniquement construire cette requête en utilisant la syntaxe WIQL. Modifiez la syntaxe WIQL dans l’Éditeur de requête en installant l’extension de la Place de marché de l’éditeur WIQL.

Par exemple, les requêtes syntaxiques suivantes pour les éléments de travail répondent aux critères suivants :

• Défini dans le projet actuel.
• Le type d’élément de travail est Récit utilisateur ou Bogue
• Les éléments de travail se trouvent sous le chemin de zone de l’équipe Fabrikam Fiber Web.
• Les éléments de travail ne sont pas dans un état Closed, Completed, Cut ou Resolved.
• Pas dans le chemin d’itération actuel pour l’équipe Fabrikam Fiber Web.
• Ont été affectés au chemin d’itération actuel pour l’équipe Fabrikam Fiber Web
• Sont à présent affectés à l’itération actuelle +1 pour l’équipe Fabrikam Fiber Web.
• Ont été modifiés au cours des 30 derniers jours (la durée du sprint).

SELECT
    [System.Id],
    [System.WorkItemType],
    [System.AssignedTo],
    [System.Title],
    [System.State],
    [System.Tags],
    [System.IterationPath],
    [System.AreaPath]
FROM workitems
WHERE
    [System.TeamProject] = @project
    AND [System.WorkItemType] IN ('User Story', 'Bug')
    AND [System.AreaPath] UNDER 'FabrikamFiber\Web'
    AND NOT [System.State] IN ('Completed', 'Closed', 'Cut', 'Resolved')
    AND NOT [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>')
    AND (
        EVER (
            [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>')
        )
        AND [System.IterationPath] = @currentIteration('[FabrikamFiber]\Web <id:cdf5e823-1179-4503-9fb1-a45e2c1bc6d4>') + 1
        AND [System.ChangedDate] >= @today - 30
    )
ORDER BY [System.Id]

L’affichage Éditeur de requête de la syntaxe s’affiche comme indiqué.

Répertorier les éléments de travail ajoutés à un sprint après la date de début

Pour répertorier les éléments de travail nouvellement créés ajoutés à un sprint après sa date de début, utilisez une requête similaire à celle présentée dans l’image suivante. Cette requête fonctionne en filtrant les éléments de travail affectés au sprint actuel, mais créés après le début de la date de sprint. Utilisez la clause created Date = @Today - 28.

Pour d’autres options pour interroger les changements de portée des sprints, consultez Changement de portée de sprint.

Champs Date et Chemin d’itération

Utilisez les champs de date pour filtrer vos requêtes. Plusieurs de ces champs sont renseignés dès qu’un élément de travail change d’état. Plusieurs de ces champs n’apparaissent pas dans le formulaire d’élément de travail, mais ils sont suivis pour les types d’éléments de travail répertoriés dans le tableau suivant.

Remarques :

1. Voir aussi Requête par assignation ou changements de flux de travail.

2. Pour que ces champs soient définis pour un type d’élément de travail, ils doivent être inclus dans la section WORKFLOW de la définition du type d’élément de travail. Par exemple, cette syntaxe est incluse dans la définition FIELDS lors de la transition vers un état Resolved.

   <FIELD refname="Microsoft.VSTS.Common.ResolvedDate" />  
      <SERVERDEFAULT from="clock"  />  
   </FIELD >  
   

3. Les valeurs des champs Date de début et Date de fin sont calculées si vous créez un plan de projet dans Project, puis synchronisez ce plan avec les tâches stockées dans Azure Boards. Ces champs n’apparaissent pas sur le formulaire d’élément de travail, mais ils sont calculés pour les tâches et les éléments de backlog qui sont liés aux éléments de backlog. Vous pouvez consulter leurs valeurs en lecture seule dans les résultats à partir d’une requête ou d’Excel.

   Important

   L’intégration de Microsoft Project et la commande TFSFieldMapping ne sont pas prises en charge pour :

   • Visual Studio 2019 et Azure DevOps Intégration Office 2019.
   • Azure DevOps Server 2019 et versions ultérieures, y compris Azure DevOps Services.

   La prise en charge complète de l'intégration de Microsoft Excel est maintenue, ce qui permet l'importation et la mise à jour en masse des éléments de travail. Les alternatives à l’utilisation de Microsoft Project sont les suivantes :

   • Plans de livraison
   • Extensions de la place de marché comme Project Connect ou le diagramme GANTT

Articles connexes

• Interroger par affectation ou modifications de workflow
• Définir les chemins de l’itération (sprint) et configurer les itérations d’équipe
• Définir une requête d’élément de travail dans Azure Boards
• Champs, opérateurs et macros de requête
• Champs et attributs d’élément de travail
• Syntaxe du langage de requête d’élément de travail (WIQL)

API REST

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

• Informations de référence de l’API REST Azure DevOps Services
• Requêtes
• Langage de requête d’élément de travail
• Extraire des éléments de travail avec des requêtes par programmation