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
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.
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.
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.
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.
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.
Ensuite, ajoutez un graphique à barres empilées qui additionne les Story Points.
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.
Ensuite, ajoutez un graphique de tendance en aires empilées qui additionne les Story Points.
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.
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.
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é
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)
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
- 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.
- 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"
. - Pour modifier l’affectation de champ ProcessConfiguration (localement uniquement), consultez Informations de référence sur les éléments XML de configuration de processus.
- 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
Articles connexes
- Créer votre backlog
- Planifier des sprints
- Planifier la capacité
- Définir une requête d'élément de travail
- Champs, opérateurs et macros de requête
- Prise en charge du cumul du travail et d’autres champs
- Créer des graphiques cumulatifs avec Power BI
API REST
Pour interagir par programmation avec des requêtes, consultez l’une de ces ressources d’API REST :