Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022
Découvrez comment interroger par champs numériques tels que l’effort, les estimations de planification, les points d’histoire ou les champs de suivi du temps dans Azure Boards et Azure DevOps.
Les champs numériques courants servent à suivre l'effort pour les exigences, ou le travail estimé, restant et terminé pour les tâches. Utilisez des requêtes pour répertorier les éléments de travail qui vous intéressent, puis créez des graphiques qui affichent un nombre d’éléments de travail ou une somme d’un champ numérique.
Prérequis
| Catégorie | Spécifications |
|---|---|
| Niveaux d’accès | - Pour afficher et exécuter des requêtes partagées : membre du projet. - Pour ajouter et enregistrer une requête partagée : un accès de base au minimum. |
| Permissions | Autorisation Contribuer définie sur Autoriser pour le dossier auquel vous souhaitez ajouter une requête. Par défaut, le groupe des contributeurs ne dispose pas de cette autorisation. |
| Catégorie | Spécifications |
|---|---|
| Niveaux d’accès | - Pour afficher et exécuter des requêtes partagées : membre du projet. - Pour ajouter et enregistrer une requête partagée : au moins un accès de base . |
| Permissions | Autorisation Contribuer définie sur Autoriser pour le dossier auquel vous souhaitez ajouter une requête. Par défaut, le groupe des contributeurs ne dispose pas de cette autorisation. |
Utiliser des opérateurs et des macros
Les clauses qui référencent des champs numériques prennent en charge 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
Conseils pour la création de requêtes qui alimentent les graphiques :
- Ajoutez des graphiques aux requêtes de liste plate uniquement.
- Faites référence aux filtres de la requête ou aux champs affichés dans les options de colonne.
- Enregistrez votre requête avant d’ajouter ou de modifier un graphique.
- Pour regrouper des clauses, sélectionnez-les et utilisez l’icône group-clauses ; pour dissocier, sélectionnez la clause groupée.
Pour plus d’informations, consultez Utiliser l’éditeur de requête pour répertorier et gérer des requêtes, des graphiques et ajouter ou modifier un champ.
Utiliser des filtres
Le tableau suivant présente des filtres utiles pour les requêtes.
Filtrer pour
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 retournent un nombre d’éléments correspondants lorsque vous les exécutez. L’exemple suivant montre une requête de liste plate qui filtre les bogues dans n’importe quel état.
Les graphiques incluent également une option de sélection des valeurs pour afficher le nombre d’éléments de travail.
Requête sur le nombre de bogues par développeur
Créez une requête pour les bogues actifs, incluez "Affecté À" et "État" dans les colonnes, puis ajoutez un graphique croisé dynamique qui montre les affectations et l'état.
Requête sur le nombre de bogues par État et par région
À l’aide de la même requête de liste plate, incluez le chemin d’accès à la zone sous forme de colonne et ajoutez un graphique croisé dynamique regroupé par état et zone.
Requête pour les valeurs de champ non définies
Recherchez les éléments de travail avec une valeur de champ non définie (vide) en utilisant l’opérateur = « equals » et en laissant la valeur vide. Par exemple, cette clause recherche des récits utilisateur dont le champ Points d’histoire est vide.
Pour rechercher les éléments où un champ n’est pas vide, utilisez l’opérateur <> « not » et laissez la valeur vide.
Requête pour les points d'effort ou d'histoire
Attribuez des points d’histoire à des récits utilisateur ou des bogues dans le processus Agile. Utilisez Effort pour les éléments de backlog de produit et les bogues dans le processus Scrum. Pour plus d’informations, consultez Basic, Agile, Scrum ou CMMI.
Recherche de la somme des points d’histoire et de leur statut
Créez une requête qui filtre pour "Récit utilisateur" et ajoutez les points de récit et l'état aux colonnes.
Ajoutez ensuite un graphique à barres empilées qui additionne les Story Points.
Pour plus d’informations sur les diagrammes de flux cumulatifs, consultez Flux cumulatif.
Requête pour un graphique de combustion des histoires de l’utilisateur pour une itération
Créez une requête qui filtre les User Stories dans un état actif ou fermé et incluez les Story Points dans les colonnes.
Ajoutez ensuite un graphique de tendance empilé de zone qui additionne les Story Points.
Requête pour le travail restant et terminé
Selon votre processus, les projets peuvent inclure ces champs sur des tâches ou des bogues :
| Process | 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 estimez le travail restant pour les tâches et les bogues, obtenez un résumé cumulatif avec une requête qui utilise l’opérateur In et inclut à la fois les tâches et les bogues pour inclure les bogues suivis en tant que tâches.
Ajoutez Le travail restant en tant que colonne, enregistrez, puis ajoutez un graphique croisé dynamique pour afficher la somme du travail restant par développeur.
Pour les graphiques de burndown sprint définis par le système, voir Burndown Sprint.
Champs servant à effectuer l'estimation et le suivi du travail
Ce tableau décrit les champs numériques et basés sur l’activité que vous pouvez utiliser pour suivre le travail. Pour les champs liés à la date, tels que 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
Activité requise pour effectuer une tâche. Pour la planification de la capacité, consultez Planification de la capacité. Les valeurs autorisées sont les suivantes :
- Déploiement
- Création
- Développement
- Documentation
- Spécifications
- Essai
Le champ Activité est associé au Activity dans le fichier ProcessConfiguration.3
Nom de référence=Microsoft.VSTS.Common.Activity, Type de données=Chaîne
Tâche, Bug4 (Agile et Scrum)
Valeur commerciale
Mesure subjective de la valeur métier relative d’un élément ou d’une fonctionnalité de backlog de produit. Les nombres supérieurs indiquent une valeur relative plus élevée.
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 enregistrer le travail en heures ou en jours ; aucune unité de temps inhérente n’est appliquée.
Nom de référence=Microsoft.VSTS.Scheduling.CompletedWork, Type de données=Double
Tâche, Anomalie4
Discipline 1, 2
Discipline affectée à une tâche. Consultez la 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 correspond à 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
Mesure subjective de la taille d’un bogue ou d’un élément de backlog de produit. Utilisez l’effort pour calculer la vélocité et la prévision de l’équipe ; cela se réfère au fichier Effort dans la configuration du processus.
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
Mesure subjective de la taille d’un récit utilisateur. Les Story Points contribuent à la vélocité et à la prévision de l’équipe et sont associés à 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)
Size
Mesure subjective de la taille des exigences. La taille contribue à la vitesse et se mappe à Effort dans le fichier ProcessConfiguration.
Nom de référence = Microsoft.VSTS.Scheduling.Size, Type de données = Double
Exigence, Bogue 4 (CMMI)
Estimation d'origine
La quantité initiale de travail estimée à effectuer une tâche. Exprimée en heures ou en jours ; aucune unité inhérente n’est appliquée.
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. Enregistré en heures ou en jours ; aucune unité inhérente n’est appliquée. Le travail restant contribue également au graphique de burndown et est mappé à RemainingWork dans le fichier ProcessConfiguration.
Remarque
Pour Azure Boards, le tableau des tâches affiche « h » (heures) pour le travail restant. Pour la configuration du processus XML local, vous pouvez modifier le fichier ProcessConfiguration pour modifier l’étiquette (par exemple, « d » pendant des jours).
Nom de référence=Microsoft.VSTS.Scheduling.RemainingWork, Type de données=Double
Tâche, Anomalie4
Révision obligatoire
Indique que la tâche doit être examinée. Valeurs autorisées : 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. Valeurs autorisées : 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. Les valeurs autorisées sont les suivantes :
- Action corrective
- Action d'atténuation
- Planifié
Nom de référence=Microsoft.VSTS.CMMI.TaskType, Type de données=Chaîne
Tâche, Bogue4 (processus CMMI)
Remarque
- Pour modifier les valeurs de liste de sélection : pour les services cloud ou un processus hérité, consultez Ajouter et gérer des champs ; pour le processus XML local, utilisez Ajouter ou modifier un champ, personnalisez une liste de sélection.
- La page Capacité affiche une union de toutes les valeurs définies pour le champ dans les projets de la collection de projets. Pour restreindre les valeurs affichées sur la page Capacité, faites correspondre les valeurs entre toutes les équipes qui partagent le champ affecté à
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 configure si les bogues se comportent comme des exigences ou des tâches. Puisque des bogues peuvent apparaître à l'un ou l'autre niveau, les champs utilisés pour estimer l'effort à ces deux niveaux sont inclus dans le formulaire d'élément de travail.
Étapes suivantes
Contenu connexe
- 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 :