Partager via

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

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 la référence des métadonnées de test pour Azure DevOps.

EntitySet EntityType Descriptif
Zones Aire L'élément de travail Chemins d'accès de zone, avec des propriétés pour le regroupement et le filtrage par hiérarchie de zone.
Dattes CalendarDate Dates utilisées pour filtrer et regrouper d’autres entités à l’aide de relations.
Itérations Itération L'élément de travail Chemins d’itération, avec des propriétés pour le regroupement et le filtrage par hiérarchie d’itération.
BoardLocations BoardLocation Les emplacements des cellules de la carte, tels que identifiés par la colonne de bord, le couloir et le fractionnement, incluent des paramètres de carte historiques. Pour obtenir une description de chaque champ de carte, consultez Les champs flux de travail et carte.
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 l’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 Étiquette Toutes les étiquettes d’élément de travail pour chaque projet. Pour obtenir un exemple qui utilise Tags pour filtrer un rapport, consultez l’exemple de rapport burndown de version.
Équipes Équipe Toutes les équipes définies pour le projet. Pour obtenir un exemple qui utilise Teams pour filtrer un rapport, consultez Ajouter un segment d’équipe à un rapport Power BI.
Utilisateurs Utilisateur Informations utilisateur utilisées pour développer ou filtrer différentes propriétés d’élément de travail, par exemple affectées à, créées par.
WorkItemBoardSnapshot Capture du tableau des éléments de travail (Composite) État de chaque élément de travail sur chaque date de calendrier, y compris l’emplacement du tableau, utilisé pour générer des rapports de tendance. Pour obtenir un exemple de rapport, consultez l’exemple de rapport de diagramme de flux cumulé (CFD).
WorkItemLinks WorkItemLink Liens entre les éléments de travail, par exemple Enfant, Parent et Associé. Inclut uniquement la dernière révision des liens, sans historique. Les liens hypertexte ne sont pas inclus.
RévisionsD'ÉlémentsDeTravail 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 l’exemple de rapport 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 Cumul des valeurs d’élément de travail enfant vers 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 les instructions de requête 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 « 9999-01-01T00:00:00Z », c’est-à-dire la façon dont nous dénoteons une valeur Null dans un type de données datetime OData, 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 un affichage Analytics correspondent aux champs de suivi de travail réguliers et à certaines propriétés Analytics, tels que les jours de temps de cycle et les jours de délai d'exécution. 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 l’index du champ Élément de travail. Pour obtenir des descriptions de chaque type de données, consultez champs de requête, opérateurs et macros.
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 les descriptions de champ pour les champs d’élément de travail par défaut 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 ensembles d’entités CalendarDate et User décrits dans la référence de métadonnées Calendar date, Project et User.

Nom d'affichage
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 acceptée
AcceptedDate		 Date et heure 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		 Date et heure 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		 Chaîne 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, exigences et tests. (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 Chaîne Type d'application sur lequel les parties prenantes fournissent des commentaires. Les valeurs par défaut sont l’application web, l’ordinateur distant et l’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		 Chaîne 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		 Chaîne ID du test automatisant le cas de test
Microsoft.VSTS.TCM.AutomatedTestId
Nom de test automatisé
AutomatedTestName		 Chaîne Nom du membre de l’équipe qui a activé ou réactivé l’élément de travail.
Microsoft.VSTS.TCM.AutomatedTestName
Stockage de test automatisé
AutomatedTestStorage		 Chaîne Assembly contenant le test automatisant le cas de test.
Microsoft.VSTS.TCM.AutomatedTestStorage
Type de test automatisé
AutomatedTestType		 Chaîne Type de test automatisant le cas de test.
Microsoft.VSTS.TCM.AutomatedTestType
État de l’automatisation
AutomatedStatus		 Chaîne État d’un cas de test avec les valeurs acceptées suivantes : automatisé, non automatisé ou planifié.
Microsoft.VSTS.TCM.AutomationStatus
Priorité des éléments en suspens
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		 Chaîne 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 modifiée
ChangedDate		 Date et heure 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 Menu de 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		 Date et heure 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
validée
Committed		 Chaîne 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 lorsque l’élément de travail a entré un état de flux de travail associé à la catégorie d’état du flux de travail terminé .
CompletedOn Menu de 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 du flux de travail Terminé , dans le fuseau horaire défini pour l’organisation. Couramment utilisé pour référencer des propriétés de l’entité Date dans groupby des instructions.
Travail terminé
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		 Date et heure Date de création de l’élément de travail, exprimée dans le fuseau horaire défini pour l’organisation. 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 Menu de 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 L’heure du cycle est calculée à partir de la première entrée d’une catégorie d’état en cours ou résolue à l’entrée d’une catégorie d’état terminée . Pour plus d’informations, consultez les widgets Délai d'exécution et Durée de cycle.
Discipline
Discipline		 Chaîne Type d'activité ou discipline assigné(e) à une tâche. Les valeurs autorisées sont : Analysis*, Development, Test, User Education et User Experience. (processus CMMI)
Microsoft.VSTS.Common.Activity
Échéance
DueDate		 Date et heure 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		 Date et heure Date et heure auxquelles la planification indique qu’un élément de travail sera terminé.
Microsoft.VSTS.Scheduling.FinishDate
Se trouve dans
FoundIn		 Chaîne Numéro de build du produit, ou « révision », dans lequel un bogue a été trouvé.
Microsoft.VSTS.Build.FoundIn
Date en cours
InProgressDate		 Date et heure Analyse de la date-heure stockée qui capture le moment où un élément de travail a été déplacé dans un état appartenant à la catégorie d'état En cours.
InProgressDateSK Int32 Date à laquelle l’élément de travail a été déplacé dans un état qui appartient à la catégorie État en cours , exprimée comme YYYYMMDD dans le fuseau horaire défini pour l’organisation. Utilisé par des outils externes pour joindre des entités associées.
Build d’intégration
IntegrationBuild		 Chaîne Numéro de build du produit contenant le code ou corrigeant un bogue.
Microsoft.VSTS.Build.IntegrationBuild
Est actuel
IsCurrent		 Booléen 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.
Est-ce la dernière révision du jour ?
IsLastRevisionOfDay		 Booléen 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		 Booléen Indique que le instantané représente la dernière révision de la période lorsqu’elle est définie sur True.
Émettre
Issue		 Chaîne 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 d’exécution
LeadTimeDays		 Double Le délai est calculé à partir de la création d’un élément de travail ou de l’entrée dans une catégorie d’état proposée jusqu'à l'entrée dans une catégorie d’état terminée. Pour plus d’informations, consultez les widgets Délai d'exécution et Durée 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 d’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		 Menu de 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 Identifiant Unique Global (GUID) GUID affecté au projet auquel appartient l’élément de travail.
Notation
Reason		 Chaîne Nombre d'étoiles attribué à un élément par un réviseur dans un système d'évaluation basé sur les étoiles (Réponse de commentaires) Le nombre est stocké dans le système et écrit comme suit : - 0 - Non noté, 1 - Pauvre, 2 - Juste, 3 - Bon, 4 - Très Bon et 5 - Excellent. Valide pour ces types d’entités : WorkItemRevision et WorkItem.
Microsoft.VSTS.Common.Rating
Raison
Reason		 Chaîne 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		 Date et heure 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 Menu de 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.
Raison résolue
ResolvedReason		 Chaîne 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 révisée
RevisedDate		 Date et heure 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 Menu de 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
Sévérité
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 les suivantes : 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
Classement hiérarchisé
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		 Date et heure Date et heure affectées à un élément de travail pour le début du travail.
Microsoft.VSTS.Scheduling.StartDate
État
State		 Chaîne É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		 Chaîne 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 Comment utiliser les états de flux de travail et les catégories d’état. Valide uniquement pour le type d’entité WorkItemRevision .
Date de modification de l’état
StateChangeDate		 Date et heure 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 Menu de 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
Étiquettes
TagNames		 Chaîne 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 cible
TargetDate		 Date et heure 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 Chaîne Spécifie le type de suite de tests. Les valeurs valides sont les suivantes : Basée sur la requête, Basée sur les conditions requises et Statique.
Microsoft_VSTS_TCM_TestSuiteType
Test Suite Type Id 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 temporelle
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		 Chaîne 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		 Chaîne La zone de valeur du client traitée par l'élément Épique, Fonctionnalité ou Backlog. Les valeurs sont les suivantes : architecture ou entreprise.
Microsoft.VSTS.Common.ValueArea
Filigrane
Watermark		 Chaîne 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 de l’é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		 Chaîne 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 complet Nom
Contrainte référentielle et propriété		 Valide pour les types d’entités
ChangedOn
ChangedDateSK, DateSK		 WorkItemRevision, , WorkItemSnapshotWorkItemBoardSnapshot
ClosedOn
ClosedDateSK, DateSK		 WorkItemRevision, , WorkItemSnapshotWorkItemBoardSnapshot
CreatedOn
CreatedDateSK, DateSK		 WorkItemRevision, , WorkItemSnapshotWorkItemBoardSnapshot
ResolvedOn
ResolvedDateSK, DateSK		 WorkItemRevision, , WorkItemWorkItemSnapshot, ,WorkItemBoardSnapshot
StateChangeOn
StateChangeDateSK, DateSK		 WorkItemRevision, , WorkItemWorkItemSnapshot, ,WorkItemBoardSnapshot
InProgressOn
InProgressDateSK, DateSK		 WorkItemRevision, , WorkItemWorkItemSnapshot, ,WorkItemBoardSnapshot
CompletedOn
CompletedDateSK, DateSK		 WorkItemRevision, , WorkItemWorkItemSnapshot, ,WorkItemBoardSnapshot
ChangedOn
ChangedDateSK, DateSK		 WorkItemRevision, , WorkItemWorkItemSnapshot, ,WorkItemBoardSnapshot
RevisedOn
RevisedDateSK, DateSK		 WorkItemRevision, WorkItemSnapshot
Date
DateSK, DateSK		 WorkItemRevision, , WorkItemSnapshotWorkItemBoardSnapshot
Zones Area
AreaSK		 WorkItemRevision, , WorkItemWorkItemSnapshot, ,WorkItemBoardSnapshot
BoardLocation WorkItemRevision, , WorkItemWorkItemBoardSnapshot
Itérations Iteration
IterationSK		 WorkItemRevision, , WorkItemWorkItemSnapshot, ,WorkItemBoardSnapshot
Affecté à AssignedTo
AssignedToUserSK, UserSK		 WorkItemRevision, , WorkItemWorkItemSnapshot, ,WorkItemBoardSnapshot
Modifié par ChangedBy
ChangedByUserSK, UserSK		 WorkItemRevision, , WorkItemWorkItemSnapshot, ,WorkItemBoardSnapshot
Créé par CreatedBy
CreatedByUserSK, UserSK		 WorkItemRevision, , WorkItemWorkItemSnapshot, ,WorkItemBoardSnapshot
Activé par ActivatedBy
ActivatedByUserSK, UserSK		 WorkItemRevision,WorkItem, WorkItemSnapshot, , WorkItemBoardSnapshot
Fermé par ClosedBy
ClosedBySK, UserSK		 WorkItemRevision, , WorkItemWorkItemSnapshot, ,WorkItemBoardSnapshot
RésoluPar ResolvedBy
ResolvedByUserSK, UserSK		 WorkItemRevision, , WorkItemSnapshotWorkItemBoardSnapshot
Équipes Area, , BoardLocation, IterationWorkItemRevision, , WorkItemSnapshotWorkItemBoardSnapshot
Étiquettes WorkItem, , WorkItemRevisionWorkItemBoardSnapshot
Projet Project
ProjectSK, ProjectSK		 Tag, WorkItemBoardSnapshot, , WorkItemLinkWorkItemRevision, WorkItemSnapshot, , WorkItemTypeField,
Processus WorkItemRevision, , WorkItemWorkItemSnapshot
Révisions WorkItem
Liens WorkItem
Enfants 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 l’état d’un élément de travail au sein de la colonne de tableau, du couloir ou du backlog d’une équipe.

  • BoardLocation
  • WorkItemBoardSnapshot

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

Nom d'affichage
Property name		 Type de données Description
Reference name
ID de tableau
BoardId		 Guide GUID unique affecté à une carte. Chaque équipe est associée à un ou plusieurs tableaux.
Nom de référence de catégorie de panneau
BoardCategoryReferenceName		 Chaîne Nom attribué à la catégorie des types d’éléments de travail utilisés pour remplir un tableau. 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 du tableau
BoardName		 Chaîne Nom attribué à la carte. Par exemple, les récits, les éléments de backlog, les fonctionnalités et les épopées.
Niveau du conseil
BoardLevel		 Int32 Nombre attribué à la carte en fonction de l’emplacement où il se trouve dans la hiérarchie des tableaux.
Type de Backlog
BacklogType		 Chaîne Nom du type de backlog. Par exemple, itération, exigence ou portefeuille.
Nom de colonne
ColumnName		 Chaîne Nom de la colonne de tableau affectée à un élément de travail, par exemple Active, Closed, Committed, Done ou autre étiquette de colonne personnalisée.
System.BoardColumn
Ordre des colonnes
ColumnOrder		 Int32 Nombre attribué à la colonne de tableau en termes de séquence dans la carte.
Fait
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 de tableau en termes de séquence.
Le tableau est-il visible ?
IsBoardVisible		 Booléen Indique si l’équipe a choisi de rendre un tableau visible ou non.
Colonne scindée?
IsColumnSplit		 Booléen Indique si une colonne a été divisée en colonnes Doing and Done , comme décrit dans Fractionner les colonnes de votre carte pour afficher le travail en cours.
Est actuel
IsCurrent		 Booléen 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 voie par défaut
IsDefaultLane		 Booléen Propriété qui indique que l’élément de travail est affecté au couloir par défaut (True) ou non (False).
Terminé
IsDone		 Booléen L'affectation actuelle de l'élément de travail à En cours (Faux) ou Fait (Vrai) dans une colonne. Affecté uniquement lorsque les colonnes fractionnées sont activées pour une colonne de tableau.
System.BoardColumnDone
Identifiant de la voie
LaneId		 Guide GUID unique affecté à une voie de natation à bord. Chaque équipe peut ajouter une ou plusieurs voies de natation à un tableau. Pour plus d’informations sur les swimlanes, consultez Accélérez le travail de votre équipe en utilisant les swimlanes dans votre tableau.
Nom de la voie
LaneName		 Chaîne Nom attribué au couloir de bord.
System.BoardLane
Ordre des voies
LaneOrder		 Int32 Le nombre attribué au couloir de bord en termes de séquence.

Membres énumérés BoardColumnSplit

Le tableau suivant répertorie les noms de membres de l'énumération BoardColumnSplit, qui peuvent être utilisés pour filtrer les éléments de travail dans les colonnes À faire ou Fait.

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

Pour plus d’informations 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 à La zone 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 d'affichage Nom Type de données Description
AnalyticsUpdatedDate Date et heure 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 Identifiant Unique Global (GUID) Identificateur unique affecté à un chemin d’accès de zone lors de sa création.
Niveau de zone 1 jusqu'à
Niveau de zone 14		 De AreaLevel1 à
AreaLevel14		 Chaîne 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 la zone AreaName Chaîne Nom défini pour le chemin d’accès à la zone lors de sa création.
Chemin d’accès à la zone AreaPath Chaîne Chemin d’accès complet du chemin d’accès à la zone en commençant par le nœud racine.

Important

  • La suppression de valeurs de chemin de zone ou la reconfiguration des valeurs de chemin d’itération entraîne une perte de données irréversible dans les graphiques suivants :
    • Graphiques de modules burndown et burnup
    • Graphiques de burndown de Sprint
    • Graphiques de vélocité pour les équipes avec des chemins de zone modifiés
    • Graphiques de tendance historique qui référencent les valeurs chemin d’accès à la zone et chemin d’itération définies au moment de chaque élément de travail
  • Lorsque vous supprimez ces chemins d’accès, vous ne pouvez pas récupérer leurs données historiques.
  • Vous pouvez supprimer des chemins de zone et d’itération uniquement lorsqu’ils ne sont plus utilisés par des éléments de travail.

Les propriétés de navigation pour le type d’entité Area et l’ensemble d’entités Zones incluent Project et Teams.

Pour plus d’informations sur les chemins d’accès aux zones, 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 d'affichage Nom Type de données Description
AnalyticsUpdatedDate Date et heure 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 Date et heure Date de fin définie pour le chemin d’itération.
IsEnded IsEnded Booléen 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 Identifiant Unique Global (GUID) Identificateur unique affecté à un chemin d’itération lors de sa création.
Niveau d’itération 1 à
Niveau d’itération 14		 De IterationLevel1 à
IterationLevel14		 Chaîne 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 Chaîne Nom défini pour un chemin d’itération lors de sa création.
Chemin d’itération IterationPath Chaîne 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 Date et heure Date de début définie pour le chemin d’itération.

Important

  • La suppression de valeurs de chemin de zone ou la reconfiguration des valeurs de chemin d’itération entraîne une perte de données irréversible dans les graphiques suivants :
    • Graphiques de modules burndown et burnup
    • Graphiques de burndown de Sprint
    • Graphiques de vélocité pour les équipes avec des chemins de zone modifiés
    • Graphiques de tendance historique qui référencent les valeurs chemin d’accès à la zone et chemin d’itération définies au moment de chaque élément de travail
  • Lorsque vous supprimez ces chemins d’accès, vous ne pouvez pas récupérer leurs données historiques.
  • Vous pouvez supprimer des chemins de zone et d’itération uniquement lorsqu’ils ne sont plus utilisés par des éléments de travail.

Propriétés de navigation pour le type d’entité Itération et l'ensemble d'entités Itérations incluent Project et Teams.

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

Processus

Les propriétés suivantes sont valides pour le type d’entité Process et l’ensemble d’entités Processus . Les clés de substitution associées au processus 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 d'affichage Nom Type de données Description
AnalyticsUpdatedDate Date et heure Filigrane qui indique l’heure de la dernière mise à jour des données Analytics.
ProjectSK Identifiant Unique Global (GUID) Clé de projet associée au processus.
TeamSK Identifiant Unique Global (GUID) Clé d’équipe associée au processus.
Nom de référence de catégorie du backlog BacklogCategoryReferenceName Chaîne 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 Booléen Nom de référence attribué au backlog associé au type d’élément de travail
Type de Backlog BacklogType Identifiant Unique Global (GUID) Identificateur unique affecté à un chemin d’itération lors de sa création.
Niveau d'arriéré BacklogLevel Chaîne 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 Chaîne Nom défini pour un type d’élément de travail.
Contient un backlog HasBacklog Chaîne Indique si le type d’élément de travail appartient à un backlog.
Est de type masqué IsHiddenType Booléen Indique si le type d’élément de travail a été désactivé.
Est-ce que c'est un type de bogue? IsBugType Booléen Indique si le type d’élément de travail appartient à la catégorie Bogue.
Est supprimé IsDeleted Booléen Indique si le type d’élément de travail a été supprimé.

Pour plus d’informations sur les backlogs de traitement 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 associé à un backlog de portfolios, un GUID est attribué à la catégorie personnalisée, comme Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000.

Étiquettes

Les propriétés suivantes sont valides pour l’ensemble d’entités Tags . Clés de substitution associées à Tag incluent TagSK et ProjectSK. Les propriétés de navigation incluent Project et sa contrainte ProjectSKréférentielle . Pour plus d’informations 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 d'affichage Nom Type de données Description
ID de balise TagId Identifiant Unique Global (GUID) ID unique affecté à la balise lors de sa création.
Nom de la balise TagName Chaîne Nom de la balise.

Équipes

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 d'affichage Nom Type de données Description
AnalyticsUpdatedDate Date et heure Filigrane qui indique l’heure de la dernière mise à jour des données Analytics.
ID d’équipe TeamId Identifiant Unique Global (GUID) ID unique attribué à l’équipe lors de sa création.
Nom de l’équipe TeamName Chaîne Nom de l’équipe.

Les propriétés de navigation pour l’ensemble 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 parents/enfants, les prédécesseurs/successeurs ou d’autres types de liens.

Nom d'affichage Nom Type de données Description
AnalyticsUpdatedDate Date et heure 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 Identifiant Unique Global (GUID) Date de création du lien.
Commentaire Comment Chaîne Commentaire ajouté lors de la création du lien.
Date supprimée DeletedDate Chaîne 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 Chaîne Nom convivial attribué au type de lien.
Nom de référence du type de lien LinkTypeReferenceName Chaîne Nom de référence attribué au type de lien.
Le type de lien est acyclique LinkTypeIsAcyclic Booléen 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.
Le type de lien est directionnel LinkTypeIsDirectional Booléen 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 pour le type d’entité WorkItemLink incluent Projects, SourceWorkItemet TargetWorkItem.

Pour plus d’informations sur les liens et les types de liens, consultez les articles suivants :

ChampsDuTypeD'ÉlémentDeTravail

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 d'affichage Nom Type de données Description
Nom du champ FieldName Chaîne Nom convivial attribué à un champ par le système ou lors de sa création.
Nom de référence de champ FieldReferenceName Chaîne 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 Chaîne Type de données affecté à un champ.
Type d’élément de travail WorkItemType Chaîne 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 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 les analyses, 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>