Interrogation par champs numériques

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

Découvrez comment interroger des champs numériques basés sur des champs d'effort, de calendrier, de points de récit ou de suivi du temps dans Azure Boards et Azure DevOps.

Les champs numériques les plus courants suivent l’effort pour les éléments de la catégorie Exigences ou le travail estimé, restant et terminé pour les éléments de la catégorie Tâche. Avec les requêtes, vous pouvez répertorier les éléments de travail qui vous intéressent, puis définir un graphique qui affiche un nombre d’éléments de travail ou une somme d’un champ numérique.

Utiliser des opérateurs et des macros

Les clauses de requête prises en charge qui spécifient un champ numérique peuvent utiliser les opérateurs suivants.

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

Développer des requêtes basées sur des graphiques

Les conseils suivants peuvent vous aider à développer vos requêtes :

  • Ajoutez des graphiques uniquement pour les requêtes de type "liste plate".
  • Faites référence aux filtres de la requête ou aux champs affichés dans les options de colonne.
  • Enregistrez les modifications apportées à votre requête avant d'ajouter ou de modifier un graphique.
  • Regroupez une ou plusieurs clauses en les sélectionnant puis en cliquant sur l'icône icône de groupe de clauses de requête de regroupement des clauses. Pour dissocier le groupe, sélectionnez la clause groupée.

Pour plus d'informations, consultez les sections Utiliser l'éditeur de requêtes pour répertorier et gérer les requêtes, Graphiques et Ajouter ou modifier un champ.

Utiliser des filtres

Le tableau suivant présente des filtres utiles pour les requêtes.

Filtrer sur

Inclure ces clauses de requête

Récits utilisateur ou bogues

Work Item Type In User Story,Bug

Tâches ou bogues

Work Item Type In Task,Bug

Éléments actifs ou fermés

State In Active,Closed

Éléments de la catégorie Exigences

Work Item Type In Group Microsoft.RequirementCategory

Récits utilisateur non estimés

Story Points <> (leave Value field blank)


Requête sur le nombre d'éléments de travail

Toutes les requêtes affichent un nombre d’éléments lorsque vous exécutez la requête. Ici, nous définissons une requête de liste plate qui filtre les bogues dans n’importe quel état.

Capture d'écran du résumé de la requête sur les bogues de tout état et le nombre d'éléments de travail.

En outre, tous les graphiques contiennent une sélection Valeurs conçue pour afficher un nombre d’éléments de travail dans le graphique.

Requête sur le nombre de bogues par développeur

Pour afficher Assigned To et State, créez une requête sur les bogues actifs et modifiez les options des colonnes. Ensuite, ajoutez un graphique croisé dynamique qui affiche les affectations et l’état.

Capture d'écran de la boîte de dialogue Configurer le graphique, pivot par assigné à et état.

Requête sur le nombre de bogues par État et par région

À l’aide de la requête de liste plate qui filtre les bogues de la section précédente, vous pouvez afficher un nombre en fonction de la zone. Modifiez les options de colonne pour afficher le chemin de zone. Ensuite, ajoutez un graphique croisé dynamique qui affiche le chemin d’état et de zone.

Capture d'écran de la boîte de dialogue Configurer le graphique, pivot par état et par région.

Requête pour les valeurs de champ non définies

Vous pouvez trouver des éléments de travail qui ont une valeur de champ non définie en utilisant l’opérateur égal (=) et en laissant la valeur du champ vide. Par exemple, les filtres suivants répertorient tous les éléments de travail de type Récits utilisateur dont le champ Story Points est vide.

Capture d'écran montrant le filtre basé sur les entrées vides.

Pour répertorier les éléments de travail en fonction d’un champ qui n’est pas vide, utilisez l’opérateur not (<>) et laissez la valeur vide.

Requête pour les points d'effort ou d'histoire

Vous pouvez affecter des Story Points à des récits utilisateur ou à des bogues lorsque vous travaillez dans un processus Agile. Ou, l’effort pour les éléments et les bogues du backlog de produit lorsque vous travaillez dans un processus Scrum. Pour plus d’informations, consultez les types d’éléments de travail Basic, Agile, Scrum et CMMI et les articles de workflow.

Recherche de la somme des points d'histoire et de leur statut

Créez une requête qui filtre le récit utilisateur comme type d’élément de travail et modifiez les options de colonne pour afficher les Story Points et l’état.

Capture d'écran montrant l'éditeur de requêtes, la liste plate, les histoires ouvertes.

Ensuite, ajoutez un graphique à barres empilées qui additionne les Story Points.

Capture d'écran montrant la boîte de dialogue Configurer le graphique, la barre empilée, la somme des points d'histoire.

Pour plus d’informations sur les diagrammes de flux cumulé définis par le système, consultez Flux cumulé.

Requête pour un graphique de combustion des histoires de l'utilisateur pour une itération

Créez une requête qui filtre le récit utilisateur comme type d’élément de travail et à l’état Actif ou Fermé. Pour afficher les Story Points, modifiez les options de la colonne.

Capture d'écran montrant l'éditeur de requêtes, la liste plate, les histoires d'utilisateurs - actives ou fermées.

Ensuite, ajoutez un graphique de tendance en aires empilées qui additionne les Story Points.

Capture d'écran montrant la boîte de dialogue Configurer le graphique, la tendance, la somme des points d'histoire.

Requête pour le travail restant et terminé

En fonction du processus auquel votre projet fait référence, vous pouvez affecter les champs suivants à des tâches ou des bogues.

Processus Champs disponibles
Agile Estimation d’origine, travail restant, travail terminé
Scrum Travail restant
CMMI Estimation d’origine, travail restant, travail terminé

Somme du travail restant par développeur

Si vous suivez les pratiques Scrum et estimez le travail restant pour vos tâches et bogues, vous pouvez obtenir un récapitulatif du travail restant avec la requête et le graphique suivants. Utilisez l'opérateur In et incluez à la fois Tâche et Bogue pour inclure tous les bogues qui sont suivis en tant que tâches.

Capture d'écran montrant la requête des tâches et des bogues pour le sprint.

Ajouter l’option Travail restant en tant que colonne à la requête et enregistrez. Pour afficher la somme du travail restant, ajoutez un graphique croisé dynamique comme indiqué dans l'exemple suivant.

Capture d'écran montrant la boîte de dialogue Configuration du graphique, graphique croisé dynamique, somme du travail restant par développeur.

Pour plus d’informations sur les graphiques d’avancement de sprint définis par le système, consultez Burndown du sprint.

Champs servant à effectuer l'estimation et le suivi du travail

Le tableau ci-dessous décrit les champs numériques et basés sur l’activité que vous pouvez utiliser pour effectuer le suivi du travail. Pour plus d’informations sur les champs liés à la date, comme Date de début, Date de fin et Date cible, consultez Requête par date ou itération actuelle.

Nom du champ

Description

Type d'élément de travail


Activité 1, 2

Le type d'activité nécessaire à la réalisation d'une tâche. Pour plus d'informations sur l'utilisation de ce champ, consultez la section Planification de la capacité. Les valeurs autorisées sont les suivantes :

  • Déploiement
  • Conception
  • Développement
  • Documentation
  • Configuration requise
  • Test

Le champ Activity est affecté à Activity dans le fichier ProcessConfiguration.3

Nom de référence=Microsoft.VSTS.Common.Activity, Type de données=Chaîne

Tâche, Bogue4 (Agile et Scrum)

Valeur commerciale

Unité de mesure subjective qui indique la valeur métier relative d'une fonctionnalité ou d'un élément de Backlog de produit par rapport à d'autres éléments du même type. La valeur métier d'un élément est considérée comme étant plus importante si sa valeur commerciale est supérieure à celle assignée à un autre élément.

Nom de référence=Microsoft.VSTS.Common.BusinessValue, Type de données=Entier

Épopée, Fonctionnalité

Travail effectué

Quantité de travail déployée pour l’implémentation d’une tâche. Vous pouvez spécifier le travail en heures ou en jours. Aucune unité de temps n'est associée à ce champ de manière inhérente.

Nom de référence=Microsoft.VSTS.Scheduling.CompletedWork, Type de données=Double

Tâche, Bogue4

Discipline 1, 2

Type d'activité ou discipline assigné(e) à une tâche. Pour en savoir plus sur l’utilisation de ce champ, consultez Planification de la capacité. Les valeurs autorisées sont les suivantes :

  • Analyse
  • Développement
  • Test
  • Documentation utilisateur
  • Expérience de l'utilisateur

Le champ Discipline est affecté à Activity dans le fichier ProcessConfiguration.3

Nom de référence=Microsoft.VSTS.Common.Discipline, Type de données=Chaîne

Tâche, Bogue 4 (CMMI)

Effort

Unité de mesure subjective qui indique la taille d’un bogue ou d’un élément de backlog. Si vous assignez plus d'efforts à un élément, vous indiquez qu'un travail supplémentaire est nécessaire pour l'implémenter.

Ce champ 3 est également utilisé pour calculer la rapidité de l’équipe et les prévisions. Il est assigné à Effort dans le fichier ProcessConfiguration.

Nom de référence=Microsoft.VSTS.Scheduling.Effort, Type de données=Double

Élément de backlog de produit, bogue 4 (Scrum)

Fonctionnalité, Épopée

Story points

Unité de mesure subjective qui indique la taille d'un récit utilisateur. Si vous assignez davantage de points à un récit utilisateur, vous indiquez qu'un travail supplémentaire est nécessaire pour l'implémenter.

Ce champ 3 est également utilisé pour calculer la rapidité de l’équipe et les prévisions. Il est assigné à Effort dans le fichier ProcessConfiguration.

Nom de référence=Microsoft.VSTS. Scheduling.StoryPoints, Type de données=Double

Récit utilisateur, Bogue 4 (Agile)

Taille

Unité de mesure subjective qui capture la taille d'une spécification. Plus la taille est importante, plus de travail est requis pour l'implémenter.

Ce champ3 est également utilisé pour calculer la rapidité de l’équipe et les prévisions. Il est assigné à Effort dans le fichier ProcessConfiguration.

Nom de référence=Microsoft.VSTS. Planification. Taille, Type de données=Double

Exigence, Bogue 4 (CMMI)

Estimation d'origine

Quantité de travail requise pour effectuer une tâche. Vous pouvez spécifier le travail en heures ou en jours. Aucune unité de temps n'est associée à ce champ de manière inhérente.

Nom de référence=Microsoft.VSTS.Scheduling.OriginalEstimate, Type de données=Double

Tâche, Bogue 4 (Agile et CMMI)

Travail restant

Quantité de travail restante pour terminer une tâche. Vous pouvez spécifier le travail en heures ou en jours. Aucune unité de temps n'est associée à ce champ de manière inhérente. Ce champ 3 est également utilisé pour calculer l’avancement. Il est assigné à type="RemainingWork" dans le fichier ProcessConfiguration.

Remarque

Pour Azure Boards, le tableau des tâches affiche toujours « h » pour les heures par rapport au travail restant. Pour TFS, vous pouvez modifier le fichier ProcessConfiguration pour le champ de type de travail restant afin de spécifier « d » pour les jours, ou une autre étiquette souhaitée.

Nom de référence=Microsoft.VSTS.Scheduling.RemainingWork, Type de données=Double

Tâche, Bogue4

Examen nécessaire

Indique que la tâche doit être examinée. Vous pouvez spécifier Oui ou Non (valeur par défaut).

Nom de référence=Microsoft.VSTS.CMMI.RequiresReview, Type de données=Chaîne

Tâche (CMMI)

Test obligatoire

Indique que la tâche nécessite un test. Vous pouvez spécifier Oui ou Non (valeur par défaut).

Nom de référence=Microsoft.VSTS.CMMI.RequiresTest, Type de données=Chaîne

Tâche (CMMI)

Type de tâche1

Spécifie le type de tâche à implémenter. Les valeurs autorisées sont les suivantes :

  • Action corrective
  • Action d'atténuation
  • Prévu

Nom de référence=Microsoft.VSTS.CMMI.TaskType, Type de données=Chaîne

Tâche, Bogue4 (processus CMMI)

Notes

  1. Pour modifier la sélection de menu : pour les services cloud ou un processus hérité, consultez Ajouter et gérer des champs ; et pour le processus XML local, consultez Ajouter ou modifier un champ, personnaliser une liste de choix.
  2. Les valeurs affichées dans la page Capacité pour Activité (Agile ou Scrum) ou Discipline (CMMI) reflètent une union de toutes les valeurs définies pour le champ dans tous les projets au sein de l’instance de collection de projets. C’est pourquoi, pour limiter les valeurs qui s’affichent pour Capacité dans les pages de Backlog des sprints, les valeurs doivent correspondre dans tous les projets pour le champ assigné à type="Activity".
  3. Pour modifier l’affectation de champ ProcessConfiguration (localement uniquement), consultez Informations de référence sur les éléments XML de configuration de processus.
  4. Chaque équipe peut configurer ses outils Agile pour déterminer si les bogues sont traités de la même façon que les exigences ou les tâches. Étant donné que les bogues peuvent apparaître avec des exigences ou des tâches, les champs utilisés pour estimer l’effort au niveau des exigences et des tâches sont inclus dans le formulaire d’élément de travail.

Étapes suivantes

API REST

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