Informations de référence sur les métadonnées pour Azure Boards Analytics

  • Article

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

Le service Analytics collecte toutes les activités de suivi du travail définies et mises à jour via Azure Boards. Analytics stocke en tant que propriétés tous les champs de suivi du travail, à l’exception des champs HTML/texte enrichi et Historique. Les propriétés personnalisées des champs personnalisés sont automatiquement ajoutées à Analytics.

Cet article décrit la majorité des propriétés que vous pouvez utiliser pour générer un rapport Analytics pour le suivi du travail. Vous utilisez une combinaison de propriétés pour filtrer une requête, agréger des données ou créer un rapport. Vous pouvez exécuter ces requêtes directement dans votre navigateur. Pour plus d’informations, consultez Définir des requêtes de base à l’aide d’OData Analytics. Si vous débutez dans le suivi et la Azure Boards de travail, nous vous recommandons de consulter les articles suivants :

Remarque

Des descriptions des entités, des propriétés et des types énumérés pris en charge par le modèle de données Analytics sont fournies. Il s’agit d’un brouillon précoce. Veuillez fournir des commentaires sur les domaines que vous souhaitez obtenir plus d’informations. Pour interroger le modèle de données, consultez Construire des requêtes OData pour Analytics.

Vue d’ensemble des jeux d’entités

Lorsque vous interrogez Analytics pour les données de suivi du travail, utilisez l’un des types d’entités ou ensembles d’entités suivants.

  • Requête WorkItems pour générer des rapports de status et de cumul
  • Requête WorkItemSnapshot pour générer des rapports de tendance, de burndown et de burnup

Utilisez d’autres types d’entités, tels que Area, Iteration, Project, Teamou d’autres entités pour filtrer les données ou sélectionner des propriétés sur lesquelles créer un rapport. Pour obtenir un résumé des exemples de rapports, consultez Exemples de rapports et index de référence rapide.

Remarque

Pour générer des rapports de status et de tendance sur les types d’éléments de travail spécifiques aux tests, interrogez les WorkItems types d’entité et et WorkItemSnapshot filtrez en fonction du type d’élément de travail. Pour plus d’informations sur les séries de tests, les résultats des tests ou d’autres données de test, interrogez les TestRunstypes d’entités , TestPoints, TestResultsDailyTestSuite ou TestPointHistorySnapshot . Pour plus d’informations, consultez Référence des métadonnées de test pour Azure DevOps.

EntitySet EntityType Description
Zones Zone Chemins d’accès à la zone de l’élément de travail, avec des propriétés pour le regroupement et le filtrage par hiérarchie de zones.
Dates CalendarDate Dates utilisées pour filtrer et regrouper d’autres entités à l’aide de relations.
Itérations Itération Chemins d’itération de l’élément de travail, avec des propriétés pour le regroupement et le filtrage par hiérarchie d’itération.
BoardLocations BoardLocation Les emplacements des cellules de tableau Kanban, tels qu’identifiés par la colonne de tableau, le couloir de bain et le fractionnement, incluent les paramètres historiques du tableau. Pour obtenir une description de chaque champ de tableau Kanban, consultez Champs workflow et tableau Kanban.
Processus Processus Informations de backlog utilisées pour développer ou filtrer les éléments de travail et les types d’éléments de travail. Pour obtenir un exemple qui utilise des processus pour filtrer un rapport, consultez Exemple de rapport de suivi des exigences. Pris en charge pour Analytics v2.0 et versions ultérieures.
Projets Projet Tous les projets définis pour un organization (cloud) ou une collection de projets (local).
Étiquettes Tag Toutes les étiquettes d’élément de travail pour chaque projet. Pour obtenir un exemple qui utilise des balises pour filtrer un rapport, consultez Exemple de rapport de burndown de mise en production.
Teams Team Toutes les équipes définies pour le projet. Pour obtenir un exemple qui utilise Teams pour filtrer un rapport, consultez Ajouter un segment Team à un rapport Power BI.
Utilisateurs Utilisateur Informations utilisateur utilisées pour développer ou filtrer diverses propriétés d’élément de travail, par exemple Affectée à, Créé par.
WorkItemBoardSnapshot WorkItemBoardSnapshot (Composite) État de chaque élément de travail à chaque date de calendrier, y compris l’emplacement du tableau Kanban, utilisé pour générer des rapports de tendance. Pour obtenir un exemple de rapport, consultez Exemple de rapport de diagramme de flux cumulé (CFD).
WorkItemLinks WorkItemLink Liens entre les éléments de travail, par exemple, Enfant, Parent et Connexe. Inclut uniquement la dernière révision des liens, sans historique. Les liens hypertexte ne sont pas inclus.
WorkItemRevisions WorkItemRevision Toutes les révisions d’éléments de travail historiques, y compris la révision actuelle. N’inclut pas les éléments de travail supprimés.
WorkItemSnapshot WorkItemSnapshot (Composite) État de chaque élément de travail à chaque date de calendrier, utilisé pour prendre en charge les rapports de tendances. Pour obtenir un exemple de rapport, consultez Exemple de rapport sur les tendances des bogues.
WorkItems WorkItem État actuel des éléments de travail. Utilisé pour prendre en charge les rapports status. Pour obtenir un exemple de rapport, consultez Cumuler les valeurs d’élément de travail enfant dans l’exemple de rapport parent.
WorkItemTypeFields WorkItemTypeField Propriétés d’élément de travail pour chaque type et processus d’élément de travail. Utilisé pour prendre en charge la génération de rapports.

Informations concernant les instantanés

Il existe deux groupes d’entités de suivi du travail instantané : WorkItemSnapshot et WorkItemBoardSnapshot.

Un instantané fournit un enregistrement des valeurs définies pour un élément de travail chaque jour. L’enregistrement est écrit dans Analytics une fois par jour à la même heure chaque jour. Vous utilisez des instantanés lorsque vous souhaitez générer un rapport de tendance. Par défaut, toutes les tables instantané sont modélisées comme des tables de faits instantané quotidiennes. Si vous interrogez un intervalle de temps, il obtient une valeur pour chaque jour. Les intervalles de temps longs entraînent un grand nombre d’enregistrements. Si vous n’avez pas besoin d’une telle précision, vous pouvez utiliser des instantanés hebdomadaires ou même mensuels.

Pour plus d’informations, consultez Instructions relatives aux requêtes OData, Utilisez des instantanés hebdomadaires ou mensuels pour les requêtes de tendance qui s’étendent sur une longue période.

À propos des révisions d’éléments de travail

Chaque fois que vous mettez à jour un élément de travail, le système crée une révision et enregistre cette action dans le System.RevisedDate champ, ce qui la rend utile pour spécifier un filtre d’historique. La date révisée est représentée par RevisedDate les propriétés (DateTime) et RevisedDateSK (Int32). Pour de meilleures performances, utilisez la dernière clé de substitution de date. Il représente la date à laquelle une révision a été créée ou a la valeur Null pour les révisions actives ou incomplètes.

Si vous souhaitez toutes les dates depuis l’inclus {startDate} , ajoutez le filtre suivant à votre requête.

RevisedDateSK eq null or RevisedDateSK gt {startDateSK}

Vous utilisez le jeu d’entités WorkItemRevisions pour charger toutes les révisions d’un élément de travail donné. La requête retourne toutes les révisions d’éléments de travail historiques, y compris la révision actuelle, pour les éléments de travail sur lesquels vous filtrez. Il n’inclut pas les éléments de travail supprimés.

Propriétés partagées sur plusieurs types d’entités

Les propriétés que vous pouvez sélectionner dans une vue Analytique correspondent à des champs de suivi de travail standard et à des propriétés d’analyse, telles que Les jours de temps de cycle et les jours de délai. Ces propriétés, dont la plupart sont répertoriées et décrites dans le tableau suivant, sont définies pour les types d’entités suivants, sauf indication contraire.

  • WorkItem
  • WorkItemRevision
  • WorkItemSnapshot
  • WorkItemBoardSnapshot

Remarque

Le service Analytics ne stocke pas de données pour les champs de texte long affectés au type de données HTML ou texte enrichi. Cela inclut les champs Description et Historique . Analytics ne stocke pas non plus le nombre de liens ou de fichiers joints. Pour obtenir la liste complète des champs définis dans les modèles de processus par défaut, consultez Index des champs d’élément de travail. Pour obtenir une description de chaque type de données, consultez Champs, opérateurs et macros de requête.
Toutes les propriétés associées aux champs spécifiques au processus Scrum et CMMI ne sont pas incluses dans le tableau suivant. Pour obtenir la liste de ces champs, consultez Descriptions des champs pour les champs par défaut et les champs d’élément de travail utilisés dans les modèles de processus, Champs utilisés pour suivre les éléments de travail CMMI.

De nombreuses propriétés sont basées sur des dates ou basées sur l’utilisateur. Ces propriétés sont associées aux jeux d’entités CalendarDate et User décrits dans Date du calendrier, Projet et Informations de référence sur les métadonnées de l’utilisateur.

Nom complet
Property name		 Type de données Description
Reference name
Accepté par
Microsoft_VSTS_CodeReview_AcceptedBy		 UserSK Nom de la personne qui a répondu à une révision de code. (Processus CMMI)
Microsoft.VSTS.CodeReview.AcceptedBy
Date d'acceptation
AcceptedDate		 DateTime Date et heure auxquelles la personne a répondu à la révision de code. (Processus CMMI)
Microsoft.VSTS.CodeReview.AcceptedDate
Activé par
ActivatedBy
ActivatedByUserSK		 UserSK Nom du membre de l’équipe qui a activé ou réactivé l’élément de travail.
Microsoft.VSTS.Common.ActivatedBy
Date d'activation
ActivatedDate		 DateTime Date et heure auxquelles un membre de l’équipe a activé ou réactivé un bogue ou un élément de travail.
Microsoft.VSTS.CodeReview.ActivatedDate
Activité
Activity		 String Type d’activité requis pour exécuter une tâche.
Microsoft.VSTS.Common.Activity

Type d'activité ou discipline assigné(e) à une tâche. Les valeurs autorisées sont les suivantes : Déploiement, Conception, Développement, Documentation, Configuration requise et Test. (Processus Agile, Scrum et De base)
Microsoft.VSTS.Common.Activity
AnalyticsUpdatedDate DateTimeOffset Données et heure de la dernière mise à jour de l’entité.
Type d’application String Type d'application sur lequel les parties prenantes fournissent des commentaires. Les valeurs par défaut sont Application web, Ordinateur distant et Application cliente. Les types valides sont spécifiés dans le fichier de configuration de processus pour les projets qui utilisent un processus XML local.
Microsoft_VSTS_Feedback_ApplicationType
Chemin d’accès à la zone
AreaPath
AreaSK		 String Regroupe les éléments de travail dans des fonctionnalités de produit ou des zones d'équipe. La zone doit être un nœud valide dans la hiérarchie de projet.
System.AreaPath
Affecté à
AssignedTo
AssignedToUserSK		 UserSK Nom du membre de l’équipe possédant actuellement l’élément de travail.
System.AssignedTo
ID de test automatisé
AutomatedTestId		 String ID du test automatisant le cas de test
Microsoft.VSTS.TCM.AutomatedTestId
Nom du test automatisé
AutomatedTestName		 String Nom du membre de l’équipe qui a activé ou réactivé l’élément de travail.
Microsoft.VSTS.TCM.AutomatedTestName
Stockage du test automatisé
AutomatedTestStorage		 String Assembly contenant le test automatisant le cas de test.
Microsoft.VSTS.TCM.AutomatedTestStorage
Type de test automatisé
AutomatedTestType		 String Type de test automatisant le cas de test.
Microsoft.VSTS.TCM.AutomatedTestType
Automation status
AutomatedStatus		 String Le status d’un cas de test avec les valeurs acceptées suivantes : Automatisé, Non automatisé ou Planifié.
Microsoft.VSTS.TCM.AutomationStatus
Priorité du Backlog :
BacklogPriority		 Double Nombre attribué par un processus d’arrière-plan système utilisé pour empiler le classement ou suivre la séquence d’éléments sur un backlog ou un tableau. (Processus Scrum)
Microsoft.VSTS.Common.BacklogPriority
Bloqué
Blocked		 String Indique qu’aucun autre travail ne peut être effectué sur l’élément de travail. Les valeurs valides sont Oui ou Non. (Processus CMMI)
Microsoft.VSTS.CMMI.Blocked
Valeur métier
BusinessValue		 Double 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.
Microsoft.VSTS.Common.BusinessValue
Modifié par
ChangedBy
ChangedByUserSK		 UserSK Nom de la personne qui a modifié l’élément de travail le plus récemment.
System.ChangedBy
Date de modification
ChangedDate		 DateTime Date et heure de modification de l’élément de travail.
System.ChangedDate
ChangedDateSK Int32 Date à laquelle l’élément de travail a été modifié, exprimée comme YYYYMMDD dans le fuseau horaire défini pour le organization. Utilisé par des outils externes pour joindre des entités associées.
ChangedOn Navigation Propriété de navigation vers l’entité Date pour la date à laquelle l’élément de travail a été modifié, dans le fuseau horaire défini pour le organization. Couramment utilisé pour référencer des propriétés de l’entité Date dans groupby des instructions.
Fermé par
ClosedBy
ClosedByUserSK		 UserSK Nom de la personne ayant fermé un élément de travail.
Microsoft.VSTS.Common.ClosedBy
Date de fermeture
ClosedDate
ClosedDateSK
ClosedOn		 DateTime Date et heure de fermeture d’un élément de travail.
Microsoft.VSTS.Common.ClosedDate
Nombre de commentaires
CommentCount		 Int32 Nombre de commentaires ajoutés à la section Discussion de l’élément de travail.
System.CommentCount
Engagés
Committed		 String Indique si l’exigence est validée dans le projet. Les valeurs valides sont Oui ou Non. (Processus CMMI)
Microsoft.VSTS.CMMI.Committed
CompletedDateSK Int32 Date de propriété de navigation capturée par Analytics qui stocke quand l’élément de travail est entré dans un état de flux de travail associé à la catégorie État du flux de travail Terminé .
CompletedOn Navigation Propriété de navigation vers l’entité Date pour la date à laquelle l’élément de travail a entré un état de flux de travail associé à la catégorie d’état de flux de travail Terminé, dans le fuseau horaire défini pour le organization. Couramment utilisé pour référencer des propriétés de l’entité Date dans groupby des instructions.
Travail effectué
CompletedWork		 Double Mesure de la quantité de travail passée sur une tâche.
Microsoft.VSTS.Scheduling.CompletedWork
Créé par
CreatedBy
CreatedByUserSK		 UserSK Nom de la personne qui a créé l’élément de travail.
Microsoft.VSTS.Common.CreatedBy
Date de création
CreatedDate
CreatedDateSK		 DateTime Date de création de l’élément de travail, exprimée dans le fuseau horaire défini pour le organization. Couramment utilisé pour le filtrage et pour l’affichage.
Microsoft.VSTS.Common.CreatedDate
CreatedDateSK Int32 Date de création de l’élément de travail, exprimée comme YYYYMMDD dans le fuseau horaire défini pour le organization. Utilisé par des outils externes pour joindre des entités associées.
CreatedOn Navigation Propriété de navigation vers l’entité Date pour la date de création de l’élément de travail, dans le fuseau horaire défini pour le organization. Couramment utilisé pour référencer des propriétés de l’entité Date dans groupby des instructions.
Jours de temps de cycle
CycleTimeDays		 Double Le temps de cycle est calculé à partir de la première entrée d’une catégorie d’état En cours ou Résolu à l’entrée d’une catégorie d’état Terminé . Pour plus d’informations, consultez Widgets temps de délai et temps de cycle.
Discipline
Discipline		 String Type d'activité ou discipline assigné(e) à une tâche. Les valeurs autorisées sont : Analyse*, Développement, Test, Éducation del’utilisateur et Expérience utilisateur. (processus CMMI)
Microsoft.VSTS.Common.Activity
Due Date
DueDate		 DateTime Date d’échéance prévue à laquelle un problème ou un élément de travail sera résolu. (Processus agile)
Microsoft.VSTS.Scheduling.DueDate
Effort
Effort		 Double Estimation de la quantité de travail nécessaire à l’implémentation d’un élément de backlog de produit (processus Scrum) ou d’un problème (processus de base).
Microsoft.VSTS.Scheduling.Effort
Date de fin
FinishDate		 DateTime Date et heure auxquelles la planification indique qu’un élément de travail sera terminé.
Microsoft.VSTS.Scheduling.FinishDate
Trouvé dans
FoundIn		 String Numéro de build du produit, ou « révision », dans lequel un bogue a été trouvé.
Microsoft.VSTS.Build.FoundIn
InProgress Date
InProgressDate		 DateTime Date stockée analytique qui capture la date et l’heure de déplacement d’un élément de travail dans un état qui appartient à la catégorie État en cours .
InProgressDateSK Int32 Date à laquelle l’élément de travail a été déplacé dans un état qui appartient à la catégorie d’état En cours, exprimée comme YYYYMMDD dans le fuseau horaire défini pour le organization. Utilisé par des outils externes pour joindre des entités associées.
Build d'intégration
IntegrationBuild		 String Numéro de build du produit contenant le code ou corrigeant un bogue.
Microsoft.VSTS.Build.IntegrationBuild
Est actuel
IsCurrent		 Boolean Prend en charge le filtrage des données pour afficher les instantané les plus récents de l’ensemble filtré d’éléments de travail en définissant la valeur sur True.
Valide pour ces types d’entités : WorkItemRevision, WorkItemBoardSnapshotet BoardLocation.
Dernière révision du jour
IsLastRevisionOfDay		 Boolean Indique que le instantané représente la dernière révision du jour quand la valeur est définie sur True.
Dernière révision de la période
IsLastRevisionOfPeriod		 Boolean Indique que le instantané représente la dernière révision de la période lorsqu’elle est définie sur True.
Problème
Issue		 String Indique que l'étape partagée est associée à un résultat attendu. Les valeurs autorisées sont Oui et Non.
Microsoft.VSTS.Common.Issue
Jours de délai de travail
LeadTimeDays		 Double Le temps d’exécution est calculé à partir de la création d’un élément de travail ou de l’entrée d’une catégorie d’état proposé à l’entrée d’une catégorie d’état Terminé . Pour plus d’informations, consultez Widgets temps de délai et temps de cycle.
Estimation d’origine
OriginalEstimate		 Double Mesure de la quantité de travail nécessaire pour effectuer une tâche.
Microsoft.VSTS.Scheduling.OriginalEstimate
ID d’élément de travail parent
ParentWorkItemId		 Int32 ID unique qui identifie l’élément de travail lié en tant que parent. Utile pour générer des rapports de cumul. Le champ Parent est disponible à partir de Azure DevOps Server 2020 et versions ultérieures. Valide pour ces types d’entités : WorkItemRevision et WorkItem.
System.Parent
Priorité
Priority		 Int32 Évaluation subjective du bogue, du problème, de la tâche ou du cas de test dans le cadre de l’activité. Les valeurs sont les suivantes : - 1, 2 ou 3.
Microsoft.VSTS.Common.Priority
Nom du projet
ProjectName		 Navigation Nom du projet auquel appartient l’élément de travail. Pour plus d’informations, consultez Date du calendrier, Projet et Référence des métadonnées utilisateur, Propriétés du projet.
System.TeamProject
ProjectSK GUID GUID affecté au projet auquel appartient l’élément de travail.
Évaluation
Reason		 String Nombre d'étoiles attribué à un élément par un réviseur dans un système d'évaluation basé sur les étoiles (Réponse aux commentaires) Le nombre est stocké dans le système et écrit comme suit : - 0 - Not Rated, 1 - Poor, 2 - Fair, 3 - Good, 4 - Very Good et 5 - Excellent. Valide pour ces types d’entités : WorkItemRevision et WorkItem.
Microsoft.VSTS.Common.Rating
Motif
Reason		 String Raison pour laquelle l'élément de travail est dans l'état actuel. Chaque transition d’un état de workflow à un autre est associée à une raison correspondante.
System.Reason
Travail restant
RemainingWork		 Double Mesure de la quantité de travail restante pour terminer une tâche.
Microsoft.VSTS.Scheduling.RemainingWork
Résolu par
ResolvedBy
ResolvedByUserSK		 UserSK Nom du membre de l’équipe ayant résolu le bogue ou le récit utilisateur.
Microsoft.VSTS.Common.ResolvedBy
Date de résolution
ResolvedDate		 DateTime Date et heure auxquelles le bogue ou le récit utilisateur a été résolu.
Microsoft.VSTS.Common.ResolvedDate
ResolvedDateSK Int32 Date à laquelle l’élément de travail a été résolu, exprimée comme YYYYMMDD dans le fuseau horaire défini pour le organization. Utilisé par des outils externes pour joindre des entités associées.
ResolvedOn Navigation Propriété de navigation vers l’entité Date pour la date à laquelle l’élément de travail a été résolu, dans le fuseau horaire défini pour l’organization. Couramment utilisé pour référencer des propriétés de l’entité Date dans groupby des instructions.
Motif de résolution
ResolvedReason		 String Motif pour lequel le problème a été résolu (correction, par exemple).
Microsoft.VSTS.Common.ResolvedReason
Révision
Revision		 Int32 Numéro assigné à la révision dans l'historique d'un élément de travail.
System.Rev
Date de révision
RevisedDate		 DateTime Date et heure auxquelles un élément de travail a été modifié ou mis à jour.
RevisedDateSK Int32 Date à laquelle l’élément de travail a été révisé, exprimée comme YYYYMMDD dans le fuseau horaire défini pour le organization. Utilisé par des outils externes pour joindre des entités associées.
RevisedOn Navigation Propriété de navigation vers l’entité Date pour la date à laquelle l’élément de travail a été révisé, dans le fuseau horaire défini pour l’organization. Couramment utilisé pour référencer des propriétés de l’entité Date dans groupby des instructions.
Risque
Risk		 Double Évaluation subjective de l'incertitude relative quant à l'achèvement du récit utilisateur. Les valeurs valides sont les suivantes : 1 - Élevé, 2 - Moyen et 3 - Faible.
Microsoft.VSTS.Common.Risk
Niveau de gravité
Severity		 Double Évaluation subjective de l'impact d'un bogue, d'un problème ou d'un risque sur le projet. Les valeurs valides sont : 1 - Critique, 2 - Élevé, 3 - Moyen et 4 - Faible.
Microsoft.VSTS.Common.Severity
Taille
Size		 Double Estimation de la quantité de travail nécessaire à l’implémentation d’un processus CMMI.
Microsoft.VSTS.Scheduling.Size
Rang dans la pile
StackRank		 Double Nombre attribué par un processus d’arrière-plan système utilisé pour empiler le classement ou suivre la séquence d’éléments sur un backlog ou un tableau. (Processus Agile, Scrum et De base)
Microsoft.VSTS.Common.StackRank
Date de début
StartDate		 DateTime Date et heure affectées à un élément de travail pour le début du travail.
Microsoft.VSTS.Scheduling.StartDate
State
State		 String État actuel de l'élément de travail. Les valeurs valides pour l’état sont spécifiques à chaque type d’élément de travail et aux personnalisations qui y sont apportées.
System.State
Catégorie d’état
StateCategory		 String Les catégories d’état déterminent la façon dont Azure Boards et les widgets de tableau de bord sélectionnés traitent chaque état de flux de travail. Les catégories d’état utilisées sont les suivantes : Proposé, En cours, Résolu, Supprimé et Terminé. Pour plus d’informations, consultez Utilisation des états de flux de travail et des catégories d’états. Valide uniquement pour le type d’entité WorkItemRevision .
Date de modification d'état
StateChangeDate		 DateTime Date et heure de modification de la valeur du champ État .
Microsoft.VSTS.Common.StateChangeDate
StateChangeSK Int32 Date à laquelle l’état d’un élément de travail a été modifié, exprimée comme YYYYMMDD dans le fuseau horaire défini pour le organization. Utilisé par des outils externes pour joindre des entités associées.
StateChangeOn Navigation Propriété de navigation vers l’entité Date pour la date à laquelle l’état d’un élément de travail a été modifié, dans le fuseau horaire défini pour le organization. Couramment utilisé pour référencer des propriétés de l’entité Date dans groupby des instructions.
Points d’histoire
StoryPoints		 Double Estimation de la quantité de travail nécessaire à l’implémentation d’un récit utilisateur (processus Agile), généralement agrégée sous forme de somme.
Microsoft.VSTS.Scheduling.StoryPoints
Balises
TagNames		 String Liste délimitée par des points-virgules de balises affectées à un ou plusieurs éléments de travail à des fins de filtrage ou d’interrogation.
System.Tags
Date limite
TargetDate		 DateTime Date d’échéance prévue à laquelle un problème ou un autre élément de travail sera résolu ou terminé.
Microsoft.VSTS.Scheduling.TargetDate
Type de suite de tests String Spécifie le type de suite de tests. Les valeurs valides sont les suivantes : Basé sur la requête, Basé sur les exigences et Statique.
Microsoft_VSTS_TCM_TestSuiteType
ID de type de suite de tests Int64 Numéro attribué par le système qui correspond à la catégorie de la suite de tests et qui s’applique uniquement aux suites de tests. Les valeurs affectées sont : 1 (statique), 2 (basé sur une requête) et 3 (basé sur les exigences).
Microsoft_VSTS_TCM_TestSuiteTypeId
Critique dans le temps
TimeCriticality		 Double Unité de mesure subjective qui capture la façon dont la valeur métier diminue au fil du temps. Des valeurs plus élevées indiquent que l’épique ou la fonctionnalité est intrinsèquement plus critique du point de vue du temps que ces éléments ayant des valeurs moins élevées.
Microsoft.VSTS.Common.TimeCriticality
Titre
Title		 String Brève description qui résume la nature de l'élément de travail et aide les membres d'équipe à le distinguer d'autres éléments de travail dans une liste.
System.Title
Zone de valeur
ValueArea		 String La zone de valeur du client traitée par l'élément Épique, Fonctionnalité ou Backlog. Les valeurs incluent : Architectural ou Business.
Microsoft.VSTS.Common.ValueArea
Filigrane
Watermark		 String Champ géré par le système qui s’incrémente avec les modifications apportées à un élément de travail. Valide pour ces types d’entités : WorkItemRevision et WorkItem.
System.Watermark
ID d’élément de travail
WorkItemId		 Int32 Identificateur unique assigné à un élément de travail. Les ID d’élément de travail sont uniques pour tous les projets et au sein d’un organization ou d’une collection de projets.
System.Id
WorkItemRevisionSK Int32 Clé unique Analytics pour la révision de l’élément de travail utilisée par les outils externes pour joindre des entités associées.
Type d’élément de travail
WorkItemType		 String Nom du type d'élément de travail. Les types d’éléments de travail sont définis en fonction du processus utilisé lors de la création de votre projet. Pour plus d’informations, consultez À propos des processus et des modèles de processus.
System.WorkItemType

Les propriétés de navigation dans OData sont les attributs de référence d’une entité qui pointe vers une autre entité. Le tableau suivant fournit un résumé des propriétés de navigation, de leurs contraintes référentielles et des types d’entités pour lesquels elles sont valides.

Nom d’affichage Nom
Contrainte référentielle et propriété		 Valide pour les types d’entités
ChangedOn
ChangedDateSK, DateSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
ClosedOn
ClosedDateSK, DateSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
CreatedOn
CreatedDateSK, DateSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
ResolvedOn
ResolvedDateSK, DateSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
StateChangeOn
StateChangeDateSK, DateSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
InProgressOn
InProgressDateSK, DateSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
CompletedOn
CompletedDateSK, DateSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
ChangedOn
ChangedDateSK, DateSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
RevisedOn
RevisedDateSK, DateSK		 WorkItemRevision, WorkItemSnapshot
Date
DateSK, DateSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Zones (Areas) Area
AreaSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
BoardLocation WorkItemRevision, WorkItem, WorkItemBoardSnapshot
Itérations Iteration
IterationSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Affecté à AssignedTo
AssignedToUserSK, UserSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Modifié par ChangedBy
ChangedByUserSK, UserSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Créé par CreatedBy
CreatedByUserSK, UserSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Activé par ActivatedBy
ActivatedByUserSK, UserSK		 WorkItemRevision,WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
Fermé par ClosedBy
ClosedBySK, UserSK		 WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
ResolvedBy ResolvedBy
ResolvedByUserSK, UserSK		 WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Équipes Area, BoardLocation, Iteration, WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Balises WorkItem, WorkItemRevision, WorkItemBoardSnapshot
Projet Project
ProjectSK, ProjectSK		 Tag, WorkItemBoardSnapshot, WorkItemLink, WorkItemRevision, WorkItemSnapshot, WorkItemTypeField,
Processus WorkItemRevision, WorkItem, WorkItemSnapshot
Révisions WorkItem
Liens WorkItem
Children WorkItem
Parent WorkItem
Descendants WorkItem
WorkItem WorkItemId WorkItemRevision

Fonctions de prédiction

Les deux fonctions suivantes sont prises en charge pour l’entité WorkItem . Ces fonctions sont utilisées pour prendre en charge les tendances prédictives sur certains rapports et widgets intégrés Analytics.

  • PredictTags
  • Predict

BoardLocation et WorkItemBoardSnapshot

Les propriétés répertoriées et décrites dans le tableau suivant sont définies pour les types d’entités suivants, sauf indication spécifique. Avec ces champs, vous pouvez filtrer les données d’élément de travail en fonction de la status d’un élément de travail dans la colonne tableau Kanban d’une équipe, au niveau du couloir ou du backlog.

  • BoardLocation
  • WorkItemBoardSnapshot

Pour obtenir un exemple d’interrogation de l’ensemble WorkItemBoardSnapshot d’entités, consultez Exemple de rapport de diagramme de flux cumulé (CFD).

Nom complet
Property name		 Type de données Description
Reference name
ID de carte
BoardId		 Guid GUID unique affecté à un tableau Kanban. Chaque équipe est associée à un ou plusieurs tableaux Kanban.
Nom de référence de la catégorie de tableau
BoardCategoryReferenceName		 String Nom attribué à la catégorie des types d’éléments de travail utilisés pour remplir un tableau Kanban. Par exemple, le tableau de backlog de produits est associé à la catégorie Exigences. Pour plus d’informations, consultez Personnaliser vos backlogs ou tableaux (processus d’héritage).
Nom de la carte
BoardName		 String Nom attribué au tableau Kanban. Par exemple, les récits, les éléments du backlog, les fonctionnalités et les epics.
Niveau de la carte
BoardLevel		 Int32 Numéro attribué au tableau Kanban en fonction de son emplacement dans la hiérarchie des tableaux Kanban.
Backlog Type
BacklogType		 String Nom du type de backlog. Par exemple, itération, exigence ou portefeuille.
Nom de la colonne
ColumnName		 String Nom de la colonne de tableau Kanban à laquelle un élément de travail est actuellement affecté, par exemple Active, Closed, Committed, Done ou toute autre étiquette de colonne personnalisée.
System.BoardColumn
Ordre des colonnes
ColumnOrder		 Int32 Numéro attribué à la colonne tableau Kanban en termes de séquence dans le tableau Kanban.
Done
Done		 Énuméré Indique l’emplacement de la colonne fractionnée. Les valeurs valides sont répertoriées ci-dessous pour BoardColumnSplit.
Limite des éléments de colonne
ColumnItemLimit		 Int32 Nombre attribué à la colonne tableau Kanban en termes de séquence.
La carte est-elle visible
IsBoardVisible		 Boolean Indique si l’équipe a choisi de rendre un tableau visible ou non.
Fractionnement de colonne
IsColumnSplit		 Boolean Indique si une colonne a été divisée en colonnes Faire et Terminé , comme décrit dans Fractionner les colonnes de votre tableau Kanban pour afficher le travail en cours.
Est actuel
IsCurrent		 Boolean Propriété qui prend en charge le filtrage des données pour afficher les instantané les plus récents de l’ensemble filtré d’éléments de travail en définissant la valeur sur True.
Est la voie par défaut
IsDefaultLane		 Boolean Propriété qui indique que l’élément de travail est affecté au couloir par défaut (True) ou non (False).
Est terminé
IsDone		 Boolean Affectation actuelle de l’élément de travail à Doing (False) ou Done (True) dans une colonne Kanban. Attribué uniquement lorsque les colonnes fractionnées sont activées pour une colonne de tableau Kanban.
System.BoardColumnDone
ID de voie
LaneId		 Guid GUID unique affecté à une voie de nage de tableau Kanban. Chaque équipe peut ajouter une ou plusieurs voies de nage à un tableau Kanban. Pour en savoir plus sur les couloirs de bain, consultez Accélérer le travail de votre équipe en utilisant des couloirs dans votre tableau Kanban.
Nom de la voie
LaneName		 String Nom attribué au couloir de tableaux Kanban.
System.BoardLane
Ordre de voie
LaneOrder		 Int32 Numéro attribué au couloir de bain kanban en termes de séquence.

Membres énumérés BoardColumnSplit

Le tableau suivant répertorie les noms des membres pour le BoardColumnSplit type énuméré, qui peuvent être utilisés pour filtrer les éléments de travail dans la colonne de tableau En cours ou Terminé .

Nom du membre Valeur Nom complet
Doing 0 En cours
Done 1 Terminé
Unknown 2 Inconnu (non fractionné)

Pour en savoir plus sur les colonnes de tableau d’une équipe, consultez les articles suivants :

Zones (Areas)

Les propriétés suivantes sont valides pour l’ensemble d’entités Areas , qui est associé au champ Chemin d’accès à la zone. Les clés de substitution associées à Area incluent AreaSK et ProjectSK. Vous pouvez utiliser ces propriétés pour filtrer ou générer des rapports sur les données de suivi du travail en fonction des affectations de chemin d’accès à la zone.

Nom complet Nom Type de données Description
AnalyticsUpdatedDate DateTime Filigrane qui indique l’heure de la dernière mise à jour des données Analytics.
Number Int32 Valeur entière affectée à un nœud Area Path lors de sa création.
Profondeur Depth Int32 Niveau auquel le chemin d’accès à la zone est défini en fonction de sa profondeur à partir du niveau racine.
ID de zone AreaId GUID Identificateur unique affecté à un chemin d’accès de zone lors de sa création.
Niveau de zone 1 à
Niveau de zone 14		 De AreaLevel1 à
AreaLevel14		 String Nom associé au niveau du nœud d’un chemin d’accès de zone. Jusqu’à 14 niveaux imbriqués sont pris en charge. Par exemple, le niveau de zone 1 correspond toujours au nœud racine et au nom du projet.
Nom de zone AreaName String Nom défini pour le chemin d’accès à la zone lors de sa création.
Chemin d’accès à la zone AreaPath String Chemin d’accès complet du chemin d’accès à la zone en commençant par le nœud racine.

Important

La suppression des chemins d’accès de zone ou la reconfiguration des chemins d’itération peuvent entraîner une perte de données et ne peuvent pas être rétablies. Par exemple, les graphiques de widgets burndown ou burnup, le sprint burndown et les graphiques de vitesse pour les équipes dont les chemins d’accès à la zone sont modifiés ne reflètent pas les données correctes. Les graphiques de tendance historique référencent le chemin d’accès à la zone et le chemin d’itération tels que définis à un point dans le passé pour chaque élément de travail. Lorsqu’un chemin d’accès à une zone ou un chemin d’itération est supprimé, les données historiques de ce chemin ne peuvent pas être récupérées.

Les propriétés de navigation pour le type d’entité Area et le jeu d’entités Areas incluent Project et Teams.

Pour en savoir plus sur les chemins d’accès à la zone, consultez les articles suivants :

Itérations

Les propriétés suivantes sont valides pour l’ensemble d’entités Itérations , qui est associé au champ Chemin d’itération . Les clés de substitution associées à l’itération incluent IterationSK et ProjectSK. Vous pouvez utiliser ces propriétés pour filtrer ou générer des rapports sur les données de suivi du travail en fonction des affectations de chemin d’itération.

Nom complet Nom Type de données Description
AnalyticsUpdatedDate DateTime Filigrane qui indique l’heure de la dernière mise à jour des données Analytics.
Number Int32 Valeur entière affectée à un nœud De chemin d’itération lors de sa création.
Profondeur Depth Int32 Niveau auquel le chemin d’itération est défini en fonction de sa profondeur à partir du niveau racine.
Date de fin EndDate DateTime Date de fin définie pour le chemin d’itération.
IsEnded IsEnded Boolean Lorsqu’il est défini sur True, indique que la date de fin du chemin d’itération est dans le passé.
ID d’itération IterationId GUID Identificateur unique affecté à un chemin d’itération lors de sa création.
Itération de niveau 1 à
Niveau d’itération 14		 De IterationLevel1 à
IterationLevel14		 String Nom associé au niveau du nœud d’un chemin d’itération. Jusqu’à 14 niveaux imbriqués sont pris en charge. Par exemple, le niveau d’itération 1 correspond toujours au nœud racine et au nom du projet.
Nom de l'itération IterationName String Nom défini pour un chemin d’itération lors de sa création.
Chemin d’itération IterationPath String Chemin d’accès complet du chemin d’itération commençant par le nœud racine. L'itération doit être un nœud valide dans la hiérarchie de projet.
System.IterationPath
Date de début StartDate DateTime Date de début définie pour le chemin d’itération.

Important

La suppression des chemins d’accès de zone ou la reconfiguration des chemins d’itération peuvent entraîner une perte de données et ne peuvent pas être rétablies. Par exemple, les graphiques de widgets burndown ou burnup, le sprint burndown et les graphiques de vitesse pour les équipes dont les chemins d’accès à la zone sont modifiés ne reflètent pas les données correctes. Les graphiques de tendance historique référencent le chemin d’accès à la zone et le chemin d’itération tels que définis à un point dans le passé pour chaque élément de travail. Lorsqu’un chemin d’accès à une zone ou un chemin d’itération est supprimé, les données d’historique ne peuvent pas être récupérées.

Les propriétés de navigation du type d’entité Itération et de l’ensemble d’entités Itérations incluent Project et Teams.

Pour en savoir plus sur les chemins d’itération, consultez les articles suivants :

Processus

Les propriétés suivantes sont valides pour le type d’entité Processus et l’ensemble d’entités Processus . Les clés de substitution associées à Process incluent ProcessSK, ProjectSKet TeamSK. Vous pouvez utiliser ces propriétés pour filtrer ou générer des rapports sur les données de suivi du travail en fonction des types d’éléments de travail utilisés par un projet ou une équipe.

Remarque

Le type d’entité Processus et l’ensemble d’entités Processus sont pris en charge avec les versions v-2.0, v3.0-preview et v4.0-preview d’Analytics.

Vous pouvez utiliser ces propriétés pour filtrer les données de suivi du travail en fonction d’un niveau de backlog

Nom complet Nom Type de données Description
AnalyticsUpdatedDate DateTime Filigrane qui indique l’heure de la dernière mise à jour des données Analytics.
ProjectSK GUID Clé de projet associée au processus.
TeamSK GUID Clé d’équipe associée au processus.
Nom de référence de la catégorie du backlog BacklogCategoryReferenceName String Nom de référence de catégorie attribué au backlog associé au type d’élément de travail. Les exemples incluent Microsoft.EpicCategory, Microsoft.FeatureCategory, Microsoft.RequirementCategory, Microsoft.TaskCategory.
Nom du backlog BacklogName Boolean Nom de référence attribué au backlog associé au type d’élément de travail
Backlog Type BacklogType GUID Identificateur unique affecté à un chemin d’itération lors de sa création.
Niveau du backlog BacklogLevel String Spécifie le niveau de backlog associé au type d’élément de travail. Si le type d’élément de travail n’est pas associé à un niveau de backlog, la valeur retournée est null.
Type d’élément de travail WorkItemType String Nom défini pour un type d’élément de travail.
A backlog HasBacklog String Indique si le type d’élément de travail appartient à un backlog.
Type masqué IsHiddenType Boolean Indique si le type d’élément de travail a été désactivé.
Type de bogue IsBugType Boolean Indique si le type d’élément de travail appartient à la catégorie Bogue.
Est supprimé IsDeleted Boolean Indique si le type d’élément de travail a été supprimé.

Pour en savoir plus sur les backlogs de processus et les types d’éléments de travail, consultez les articles suivants :

Types d’éléments de travail personnalisés et catégories de backlog personnalisées

Les données des types d’éléments de travail personnalisés sont automatiquement ajoutées au service Analytics.

Une catégorie personnalisée est créée quand un type d’élément de travail personnalisé et un niveau de backlog sont définis. Custom_ est ajouté au GUID de catégorie. Par exemple, pour le type d’élément de travail personnalisé Portfolio avec un backlog Portfolios, un GUID est affecté à la catégorie personnalisée, telle que Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000.

Étiquettes

Les propriétés suivantes sont valides pour l’ensemble d’entités Tags . Les clés de substitution associées à la balise include TagSK et ProjectSK. Les propriétés de navigation incluent Project et sa contrainte ProjectSKréférentielle . Pour en savoir plus sur l’utilisation des balises, consultez Ajouter des balises d’élément de travail pour classer et filtrer des listes et des tableaux.

Vous pouvez utiliser ces propriétés pour filtrer ou créer des rapports sur les données de suivi du travail.

Nom complet Nom Type de données Description
ID de balise TagId GUID ID unique affecté à la balise lors de sa création.
Nom de la balise TagName String Nom de la balise.

Teams

Les propriétés suivantes sont valides pour le type d’entité Team et l’ensemble d’entités Teams . Les clés de substitution associées à Team incluent TeamSK et ProjectSK. Vous pouvez utiliser ces propriétés pour filtrer ou générer des rapports sur les données de suivi du travail en fonction des affectations d’équipe. Pour plus d’informations sur l’utilisation et l’ajout d’équipes, consultez À propos des équipes et des outils Agile et Créer ou ajouter une équipe.

Nom complet Nom Type de données Description
AnalyticsUpdatedDate DateTime Filigrane qui indique l’heure de la dernière mise à jour des données Analytics.
ID d’équipe TeamId GUID ID unique attribué à l’équipe lors de sa création.
Nom de l’équipe TeamName String Nom de l’équipe.

Les propriétés de navigation du jeu d’entités Teams incluent Projects, Areaset Iterations.

Les propriétés suivantes sont valides pour l’ensemble d’entités WorkItemLinks . La clé de substitution de référence de propriété est WorkItemLinkSK. Interrogez WorkItemLinks pour créer un rapport sur les types de liens parent/enfant, connexes, prédécesseurs/successeurs ou autres.

Nom complet Nom Type de données Description
AnalyticsUpdatedDate DateTime Filigrane qui indique l’heure de la dernière mise à jour des données Analytics.
WorkItemLinkSK Int32 Clé de substitution affectée à l’entité WorkItemLink .
Date de création CreatedDate GUID Date de création du lien.
Commentaire Comment String Commentaire ajouté lors de la création du lien.
Date de suppression DeletedDate String Date de suppression du lien.
ID de type de lien LinkTypeId Int32 ID attribué à l’élément de travail cible lié à.
Nom du type de lien LinkTypeName String Nom convivial attribué au type de lien.
Nom de référence du type de lien LinkTypeReferenceName String Nom de référence attribué au type de lien.
Le type de lien est acyclique LinkTypeIsAcyclic Boolean La valeur de l’attribut de type de lien qui indique le type de lien autorise les relations circulaires lorsque la valeur est définie sur True. Par exemple, les liens de type d’arborescence limitent les relations circulaires.
Type de lien directionnel LinkTypeIsDirectional Boolean Valeur de l’attribut de type de lien qui indique que le type de lien est directionnel. Les types de liens directionnels sont définis par paires avec un composant avant et un composant inverse.
ID de l’élément de travail source SourceWorkItemId Int32 ID attribué à l’élément de travail source lié à.
ID de l’élément de travail cible TargetWorkItemId Int32 ID attribué à l’élément de travail cible lié à.

Les propriétés de navigation du type d’entité WorkItemLink incluent Projects, SourceWorkItemet TargetWorkItem.

Pour en savoir plus sur les liens et les types de liens, consultez les articles suivants :

WorkItemTypeFields

Les propriétés suivantes sont valides pour l’ensemble d’entités WorkItemTypeFields . Les clés de référence de propriété sont FieldName, ProjectSKet WorkItemType.

Nom complet Nom Type de données Description
Nom du champ FieldName String Nom convivial attribué à un champ par le système ou lors de sa création.
Nom de la référence de champ FieldReferenceName String Nom de référence attribué à un champ par le système ou lors de la création d’un champ personnalisé.
Type de champ FieldType String Type de données affecté à un champ.
Type d’élément de travail WorkItemType String Nom des types d’éléments de travail pour lesquels un champ est défini.

Les propriétés de navigation incluent Project.

Pour obtenir un index de tous les champs définis pour un projet, consultez Descriptions des champs pour les champs d’élément de travail. Pour plus d’informations, consultez les articles suivants :

Propriétés personnalisées

Les champs personnalisés sont automatiquement ajoutés au service Analytics en tant que propriété personnalisée. Custom_ ou Custom. est ajouté au nom de la propriété. Vérifiez les métadonnées de votre collection, comme décrit dans Construire des requêtes OData pour Analytics, composants d’URL pour interroger les métadonnées. L’exemple suivant fournit la syntaxe des métadonnées pour le champ personnalisé, Risk Opportunity.

<Property Name="Custom_RiskOpportunity" Type="Edm.Double">
<Annotation Term="Display.DisplayName" String="Risk Opportunity"/>
<Annotation Term="Ref.ReferenceName" String="Custom.RiskOpportunity"/>
<Annotation Term="Display.Description" String="Risk Reduction | Opportunity Enablement Value. Enter a value from 1 to 5. 5 represents high risk reduction or high opportunity enablement."/>
</Property>