Interroger l’historique et les champs de discussion des éléments de travail

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

L’historique d’un élément de travail enregistre qui a créé l’élément, les modifications apportées et les raisons de ces modifications. Ces informations sont essentielles pour suivre l’évolution d’un élément au fil du temps. Lors de l’ajout d’entrées au champ d’historique, incluez des informations détaillées pour aider le propriétaire de l’élément de travail suivant à comprendre le contexte des modifications et les actions requises.

Remarque

Il n’y a pas de champ d’élément de travail Discussion séparé. Pour interroger les éléments de travail avec des commentaires saisis dans la zone de discussion, vous filtrez le champ Historique. Tout le texte entré dans la zone Discussion est automatiquement inclus dans le champ Historique.

Conditions préalables

• Niveaux d’accès :
  • Pour afficher et exécuter des requêtes partagées, soyez un membre de projet .
  • Pour ajouter et enregistrer une requête partagée, vous devez avoir au moins un accès Basique.
• Autorisations : Avoir l’autorisation Contributeur définie sur Autoriser pour le dossier auquel vous souhaitez ajouter une requête. Par défaut, le groupe contributeurs ne dispose pas de cette autorisation.

Remarque

Les utilisateurs disposant de l'accès Stakeholder pour un projet public disposent d'un accès complet aux fonctionnalités d'interrogation, comme les utilisateurs disposant de l'accès de base. Pour plus d’informations, consultez Référence rapide sur l’accès de partie prenante.

Opérateurs et macros pris en charge

• Opérateurs pris en charge :

  • contient des mots
  • ne contient pas de mots

• Méthodes de recherche

  • expression exacte : Localiser une séquence exacte de mots.
  • caractère générique (*) : Utiliser uniquement à la fin d’un mot ou d’une expression partielle.

• Recherche en texte intégral :Le champ Historique est automatiquement indexé pour la recherche en texte intégral lorsque celle-ci est disponible.

Interroger l’historique d’un élément de travail

Vous pouvez utiliser le portail web ou Team Explorer pour afficher l’historique d’un élément de travail ou rechercher des éléments de travail en fonction du champ Historique. La recherche dans le champ Historique retourne uniquement les éléments de travail avec les modifications enregistrées dans ce champ et n’inclut pas les modifications apportées à d’autres champs.

Navigateur

Visual Studio

L’éditeur de requête n’est pas disponible lorsque vous êtes connecté au dépôt GitHub ou non Microsoft Git. En outre, elle n’est pas disponible à partir de Visual Studio 2019 dans les conditions suivantes :

• Si vous vous préparez à utiliser l’expérience de page d’accueil par défaut, comme décrit dans Définir l’expérience éléments de travail dans Visual Studio 2019.
• Si vous vous préparez à utiliser le nouvel outil Git, comme décrit dans Expérience Git dans Visual Studio.

Répertorier les éléments en fonction du contenu du champ Historique

Utilisez l’éditeur de requête pour inclure le champ Historique dans une clause de requête .

• Contenu interrogeable : Commentaires saisis dans la zone de Discussion.
• contenu non interrogeable : entrées d’historique des modifications, telles que les modifications apportées aux champs, ne sont pas interrogeables.
• Méthodes de recherche alternatives : Pour rechercher des mots dans la Discussion, la Descriptionou d’autres champs de texte enrichi, utilisez la Recherche d’éléments de travail.
• Filtrer par date de modification : Filtrer les éléments de travail à la date à laquelle ils ont été modifiés ou spécifier une période donnée.

filtre pour

Inclure ces clauses de requête

---

Éléments dont le champ Historique contient le mot « reproductible »

History Contains Words reproducible

Éléments dont le champ Historique ne contient pas le mot « bêta »

History Does Not Contain Words beta

Éléments qui contiennent l’expression « stack traces » et qui ont été fermés, mais réactivés

History Contains Words stack tracesAnd State Was Ever Closed
And State <> Closed

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

State = Done
And Closed Date > 7/1/2015
And Closed Date <= 7/21/2015

Éléments auxquels j’ai été associé

History Contains Words MyName
Or Assigned To Was Ever _ @Me

---

Conseils pour l’utilisation de l’éditeur de requête

• Limiter l’étendue de requête par plage de dates : Affiner la plage de dates pour améliorer les performances et retourner uniquement les résultats pertinents.

• Utiliser des mots ou expressions complets :

  • Saisissez des mots complets ou des phrases exactes à partir du champ Historique.
  • Les mots partiels ne renvoient pas d’éléments de travail. Par exemple:
    • Effectuer une recherche par « comportement reproductible » permet de trouver l'élément.
    • La recherche de « repro » ne le trouve pas.
  • Utilisez des caractères génériques à la fin des mots ou des expressions, tels que repro*.

• Faites attention aux mots « stop » :

  • L’éditeur de requête ignore les mots courants.
  • Pour plus d’informations, consultez Configurer et gérer les mots vides et listes de mots vides pour la recherche en texte intégral.

• Exécuter et valider votre requête :

  • Sélectionnez ou dans la barre d’outils de l’éditeur de requête.
  • Vérifiez que la requête retourne les résultats attendus.
  • Si les résultats sont manquants, ajustez vos termes de recherche et réexécutez la requête.

Afficher l’historique des éléments de travail

Une entrée est faite dans le champ d'historique chaque fois qu’un élément de travail est enregistré. Pour afficher l’historique des modifications, ouvrez un élément de travail existant, puis choisissez l’icône de l’onglet historique ou Historique, ou pour certains types d’éléments de travail (WIT), choisissez Détails.

Les détails de l’historique affichés dépendent de la plateforme, de la version et du client.

Navigateur

Le diagramme de l’historique des modifications d’état s’affiche en premier. Pour afficher l’historique complet des modifications d’état, choisissez Tout afficher.

Choisissez une entrée dans le volet gauche et affichez les détails des modifications apportées.

Visual Studio

Pour afficher uniquement les commentaires ajoutés au journal, choisissez l’onglet Discussion uniquement. Pour afficher toutes les modifications apportées à l’article, choisissez l’onglet Toutes les modifications, puis cliquez sur le lien afficher toutes les modifications pour une date et une heure spécifiques.

Filtrer l’affichage de l’historique

L’onglet Historique est conçu pour suivre toutes les modifications apportées à un élément de travail pour prendre en charge la traçabilité complète. L'historique de révision long peut rendre difficile à comprendre quand des modifications se produisent dans des champs spécifiques. Pour rechercher rapidement les révisions apportées à un champ spécifique ou par des personnes spécifiques, filtrez l’affichage historique.

Remarque

La fonctionnalité activer/désactiver le filtre nécessite la fonctionnalité New Boards Hub, activée par défaut. Pour plus d’informations, consultez Gérer ou activer des fonctionnalités.

Pour passer en revue les mises à jour par des personnes spécifiques, sélectionnez leurs noms dans le menu Mis à jour par.

Pour passer en revue les mises à jour apportées à un ou plusieurs champs, sélectionnez les champs dans le menu Champs.

Champs qui prennent en charge l’historique, l’audit et le suivi des révisions

Vous pouvez utiliser les champs suivants pour filtrer les requêtes et créer des rapports. Plusieurs de ces champs se remplissent d'informations à mesure qu'un élément de travail évolue d'un état à un autre. D’autres champs sont mis à jour lorsque l’élément de travail est modifié. Certains champs n’apparaissent pas dans le formulaire d’élément de travail, mais sont suivis pour les types d’élément de travail répertoriés.

nom de champ

Description

Type d’élément de travail

---

Modifié par

Nom du membre de l’équipe qui a modifié l’élément de travail le plus récemment.

Reference name=System.ChangedBy, Data type=String

Tous

Date de modification

Date et heure de modification d’un élément de travail.

Reference name=System.ChangedDate, Data type=DateTime

Tous

Date de fermeture ¹

Date et heure de fermeture d’un élément de travail.
Reference name=Microsoft.VSTS.Common.ClosedDate, Data type=DateTime

Tous

Date de création

Date et heure de création d’un élément de travail.

Reference name=System.CreatedDate, Data type=DateTime

Tous

Histoire

Enregistrement des modifications apportées à l’élément de travail après sa création. Chaque fois que l’élément de travail est mis à jour, les informations s’ajoutent à l’historique, qui spécifie la date de la modification, qui a apporté les modifications et quels champs ont été modifiés.

Remarque

Les requêtes de champ d’historique retournent des éléments de travail dont Discussion commentaires ou Description champs contiennent des mots qui correspondent aux mots clés entrés. Vous ne pouvez pas utiliser le champ Historique pour interroger les modifications apportées à d’autres champs.

Vous ne pouvez pas ajouter de texte mis en forme au champ d’historique. Une fois que vous avez enregistré l’élément de travail, vous ne pouvez pas modifier l’historique.
Le champ History, ainsi que les champs Description, Steps to Repro et Title sont automatiquement indexés pour la recherche en texte intégral, comme décrit dans champs, opérateurs et macros de requête.

Reference name=System.History, Data type=History

Tous

Date de résolution ¹

Date et heure à laquelle l’élément de travail a été déplacé dans un état résolu.

Reference name=Microsoft.VSTS.Common.ResolvedDate, Data type=DateHeure

Bogue (Agile, CMMI)

Rev

Nombre affecté à la révision historique d’un élément de travail.

Remarque

Une limite de révision d’élément de travail de 10 000 est appliquée aux mises à jour effectuées via l’API REST pour Azure DevOps Services. Cette limite limite limite les mises à jour de l’API REST, mais les mises à jour du portail web ne sont pas affectées.

Reference name=System.Rev, Data type=Integer

Tous

Date révisée

Date et heure de révision ou de modification d’un élément de travail.

Reference name=System.RevisedDate, Data type=DateTime

Paramètre partagé, étape partagée, cas de test

Date de modification de l’état

Date et heure de modification de la valeur du champ État.

Reference name=Microsoft.VSTS.Common.StateChangeDate, Data type=DateTime

Tous

Audit de la suite de tests

Effectue le suivi d’autres opérations effectuées lors de la modification d’une suite de tests, par exemple en ajoutant des tests à une suite de tests ou en modifiant des configurations. Ce champ peut être consulté via l’onglet Historique ou via une requête distincte. Il existe une vue d’historique consolidée, y compris les modifications apportées au champ éléments de travail et les modifications résultant d’artefacts connexes, tels que les points de test et les configurations.

Reference name=Microsoft.VSTS.TCM.TestSuiteAudit, Data type=PlainText

Suite de tests

Filigrane

Champ géré par le système (non modifiable) qui incrémente les modifications apportées à un élément de travail.

Reference name=System.Watermark, Data type=Integer

Tous

Remarque

1. Ces champs doivent être inclus dans la section WORKFLOW de la définition WIT. Par exemple, cette syntaxe est incluse dans la définition FIELDS lors de la transition vers un état résolu :

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

Articles connexes

• Utiliser l’éditeur de requête
• champs de requête, opérateurs et macros
• Requête par date ou itération actuelle

REST API

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

• Référence de l’API REST des services Azure DevOps
• Requêtes
• 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