Partager via

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

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

Le service Analytics collecte toutes les définitions de suivi du travail Azure Boards et l’activité de mise à jour. Vous pouvez exécuter des requêtes Analytics directement dans votre navigateur et utiliser une combinaison de propriétés pour filtrer une requête, agréger des données ou générer un rapport. Pour plus d’informations, consultez Définir des requêtes de base à l’aide d’OData Analytics.

Cet article décrit la plupart des propriétés que vous pouvez utiliser pour générer un rapport Analyse de suivi des travaux. Analytics stocke tous les champs de suivi de travail en tant que propriétés, à l’exception des champs HTML/texte enrichi et historique. Les champs personnalisés sont automatiquement ajoutés à Analytics en tant que propriétés personnalisées.

Remarque

Cet article fournit 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. 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, interrogez l’entité WorkItems définie pour générer des rapports d’état et de cumul. Utilisez l’entité WorkItemSnapshot définie pour générer des rapports tendance, burndown et burn up.

Utilisez d’autres types d’entités, tels que zone, itération, projet ou équipe pour filtrer les données ou sélectionner des propriétés à signaler. Pour obtenir des exemples de rapports, consultez Exemples de rapports et index de référence rapide.

Remarque

Pour générer des rapports d’état et de tendance sur les exécutions de test, les résultats des tests ou d’autres données de test, interrogez les types d’entités WorkItems et WorkItemSnapshot et filtrez en fonction des types d’entités TestRuns, TestPoints, TestResultsDaily, TestSuite ou TestPointHistorySnapshot . Pour plus d’informations, consultez la référence des métadonnées de test pour Azure DevOps.

Ensemble d’entités Type d'entité Descriptif
Zones Aire Chemins d’accès de zone d’élément de travail, avec les propriétés de regroupement et de filtrage par hiérarchie de zone.
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 d’élément de travail, avec les propriétés de regroupement et de filtrage par hiérarchie d’itération.
BoardLocations BoardLocation Emplacements des cellules de la carte, tels que identifiés par la colonne de bord, le couloir et le fractionnement, y compris les paramètres historiques de la carte. 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 une organisation ou une collection de projets.
É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 diverses propriétés d’élément de travail, par exemple affectées à ou créées par.
Capture du tableau des éléments de travail Capture du tableau des éléments de travail Type d’entité composite qui décrit l’état de chaque élément de travail sur chaque date de calendrier, y compris l’emplacement du tableau. Permet de 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 et n’inclut pas de liens hypertexte.
RévisionsDesÉ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 Type d’entité composite qui décrit l’état de chaque élément de travail sur 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.

Snapshots

Les jeux d’entités d’instantané de suivi du travail sont WorkItemSnapshot et WorkItemBoardSnapshot. Un instantané écrit dans Analytics en même temps chaque jour et fournit un enregistrement des valeurs définies pour un élément de travail pour ce jour-là. Vous pouvez utiliser des instantanés pour générer des rapports de tendance.

Par défaut, toutes les tables d’instantanés sont modélisées en tant que tables de faits d’instantanés quotidiennes. Une requête pour une plage de temps obtient une valeur pour chaque jour, et des 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 mensuels. Pour plus d’informations, consultez Utiliser des instantanés hebdomadaires ou mensuels pour les requêtes de tendance qui s’étendent sur une longue période.

Révisions d’éléments de travail

Chaque fois que vous mettez à jour un élément de travail, le système crée une nouvelle révision et l’enregistre dans le System.RevisedDate champ, ce qui est utile pour spécifier un filtre d’historique. Vous pouvez représenter la date révisée par les propriétés et RevisedDate (DateTime) les RevisedDateSK (Int32) propriétés.

Utilisez la propriété de clé de substitution de la dernière date pour des performances optimales. Cette clé indique la date à laquelle une révision a été créée ou affiche la valeur "9999-01-01T00:00:00Z" null datetime OData pour les révisions actives ou incomplètes. Si vous souhaitez toutes les dates depuis le {startDate}, inclus, ajoutez le filtre suivant à votre requête : RevisedDateSK eq null or RevisedDateSK gt {startDateSK}.

Vous utilisez l’entité WorkItemRevisions définie 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, et non pas les éléments de travail supprimés.

Propriétés partagées entre les types d’entités

Les propriétés que vous pouvez sélectionner dans une vue Analytics correspondent aux champs de suivi de travail réguliers et aux propriétés Analytics sélectionnées, telles que Les jours de temps de cycle et les jours de temps de début. Ces propriétés sont définies pour les types d’entités suivants, sauf indication contraire :

  • WorkItem
  • WorkItemRevision
  • WorkItemSnapshot
  • Capture du tableau des éléments de travail

Remarque

Le tableau suivant répertorie et décrit la plupart des propriétés que vous pouvez sélectionner dans un affichage Analytics, y compris les champs de suivi de travail réguliers et d’autres propriétés Analytics.

Nom complet Nom de la propriété Type de données Descriptif Nom de la référence
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é ou de discipline affecté à 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 Groupe d’éléments de travail de la fonctionnalité de produit ou de zone d’équipe dans. Doit être un nœud valide dans la hiérarchie du projet. System.AreaPath
Affecté à AssignedTo, AssignedToUserSK UserSK Nom du membre de l’équipe qui possède actuellement l’élément de travail. System.AssignedTo
ID de test automatisé AutomatedTestId Chaîne ID du test qui automatise 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 qui contient le test qui automatise le cas de test. Microsoft.VSTS.TCM.AutomatedTestStorage
Type de test automatisé AutomatedTestType Chaîne Type de test qui automatise 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 automatisées, non automatisées ou planifiées. Microsoft.VSTS.TCM.AutomationStatus
Priorité des éléments en suspens BacklogPriority Double Numéro attribué par un processus d’arrière-plan système utilisé pour empiler le classement ou suivre la séquence d’éléments d’un backlog ou d’une carte. (Processus Scrum) Microsoft.VSTS.Common.BacklogPriority
Bloqué Blocked Chaîne Indication qu’aucun travail supplémentaire 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é subjective de mesure qui capture la valeur métier relative d’un élément ou d’une fonctionnalité de backlog de produit par rapport à d’autres éléments du même type. Les nombres plus élevés attribués aux éléments sont considérés comme ayant plus de valeur métier que les éléments affectés à des nombres inférieurs. 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 de modification de l’élément de travail, 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.
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 qui a fermé un élément de travail. Microsoft.VSTS.Common.ClosedBy
Date de fermeture ClosedDate, , ClosedDateSKClosedOn 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 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 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 consacrée à 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é dans le fuseau horaire défini pour l’organisation. Couramment utilisé pour le filtrage et 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 l’organisation. 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 Durée de cycle 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é . 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 de discipline affecté à une tâche. Les valeurs autorisées sont les suivantes : analyse, développement, test, éducation utilisateur et expérience utilisateur. (Processus CMMI) Microsoft.VSTS.Common.Activity
Échéance DueDate Date et heure Date d’échéance prévue d’un problème ou d’un élément de travail à résoudre. (Processus agile) Microsoft.VSTS.Scheduling.DueDate
Effort Effort Double Quantité estimée 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 doit être terminé. Microsoft.VSTS.Scheduling.FinishDate
Se trouve dans FoundIn Chaîne Numéro de build du produit, également appelé révision, dans laquelle un bogue a été trouvé. Microsoft.VSTS.Build.FoundIn
Date en cours InProgressDate Date et heure Date stockée d’Analyse qui capture la date et l’heure de déplacement d’un élément de travail dans un état appartenant à 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 É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 qui incorpore le code ou corrige un bogue. Microsoft.VSTS.Build.IntegrationBuild
Est actuel IsCurrent Booléen Prise en charge du filtrage des données pour afficher l’instantané le plus récent de l’ensemble filtré d’éléments de travail en définissant la valeur Truesur . Valide pour les types d’entités WorkItemRevision, WorkItemBoardSnapshot et BoardLocation.
Est-ce la dernière révision du jour ? IsLastRevisionOfDay Booléen Indication que l’instantané représente la dernière révision du jour où la valeur est définie True.
Dernière révision de la période IsLastRevisionOfPeriod Booléen Indication que l’instantané représente la dernière révision de la période définie sur True.
Émettre Issue Chaîne Indication 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 Délai calculé à partir de la création d’un élément de travail ou entrée d’une catégorie d’état proposée à une catégorie d’état terminé . 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 valide pour les 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 tel qu’il est lié à l’entreprise. Les valeurs incluent 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 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 qu’un élément reçoit d’un réviseur dans un système de classement en étoile (réponse de commentaires). Le nombre est stocké dans le système et écrit en tant que 0 - Not Rated, 1 - Poor, 2 - Fair, 3 - Good, 4 - Very Good, or 5 - Excellent. Valide pour les 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 Mesurez la quantité de travail qui reste à terminer une tâche. Microsoft.VSTS.Scheduling.RemainingWork
Résolu par ResolvedBy, ResolvedByUserSK UserSK Nom du membre de l’équipe qui a résolu le bogue ou l’histoire utilisateur. Microsoft.VSTS.Common.ResolvedBy
Date de résolution ResolvedDate Date et heure Date et heure de résolution du bogue ou de l’histoire utilisateur. Microsoft.VSTS.Common.ResolvedDate
ResolvedDateSK Int32 Date à laquelle l’élément de travail a été résolu, exprimé comme YYYYMMDD dans le fuseau horaire défini pour l’organisation. 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 Raison pour laquelle le bogue a été résolu, tel que Résolu. Microsoft.VSTS.Common.ResolvedReason
Révision Revision Int32 Numéro affecté à la révision 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 de révision de l’élément de travail, 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.
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 à la réussite de l’élément de travail. Les valeurs valides incluent 1 - Élevé, 2 - Moyen et 3 - Faible. Microsoft.VSTS.Common.Risk
Sévérité Severity Double Évaluation subjective de l’effet d’un bogue, d’un problème ou d’un risque sur le projet. Les valeurs valides incluent 1 - Critique, 2 - Élevé, 3 - Moyen et 4 - Faible. Microsoft.VSTS.Common.Severity
Taille Size Double Estimez la quantité de travail nécessaire à l’implémentation d’une exigence. (Processus CMMI) Microsoft.VSTS.Scheduling.Size
Classement hiérarchisé StackRank Double Numéro attribué par un processus d’arrière-plan système utilisé pour empiler le classement ou suivre la séquence d’éléments d’un backlog ou d’une carte. (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 Comment Azure Boards et sélectionner des widgets de tableau de bord traitent chaque état de flux de travail. Les catégories d’état incluent 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 de modification de l’état de l’élément de travail, exprimé comme YYYYMMDD dans le fuseau horaire défini pour l’organisation. 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 un état d’élément de travail a changé, 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.
Points d’histoire StoryPoints Double Estimer la quantité de travail nécessaire à l’implémentation, généralement agrégée en tant que somme, d’un récit utilisateur. (Processus agile) Microsoft.VSTS.Scheduling.StoryPoints
Étiquettes TagNames Chaîne Liste délimitée par des points-virgules des 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 d’un problème ou d’un autre élément de travail à résoudre ou à terminer. Microsoft.VSTS.Scheduling.TargetDate
Type de suite de tests Chaîne Type de suite de test. Les valeurs valides sont basées sur des requêtes, basées sur des conditions requises et statiques. Microsoft_VSTS_TCM_TestSuiteType
Test Suite Type Id Int64 Numéro attribué par le système correspondant à la catégorie de suite de tests. Applicable uniquement aux suites de test. Les valeurs attribuées sont 1 (statique),2 (basées sur une requête) et 3 (basées sur les conditions requises). 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. Les valeurs plus élevées indiquent qu’une épopée ou une fonctionnalité est intrinsèquement plus importante que les éléments avec des valeurs inférieures. Microsoft.VSTS.Common.TimeCriticality
Titre Title Chaîne Brève description récapitulons l’élément de travail qui aide les membres de l’équipe à le distinguer des autres éléments de travail d’une liste. System.Title
Zone de valeur ValueArea Chaîne Zone de valeur du client traitée par l’élément épique, fonctionnel ou backlog. Les valeurs incluent l’architecture ou l’entreprise. Microsoft.VSTS.Common.ValueArea
Filigrane Watermark Chaîne Champ géré par le système qui incrémente les modifications apportées à un élément de travail. Valide pour les types d’entités WorkItemRevision et WorkItem . System.Watermark
ID de l’élément de travail WorkItemId Int32 Identificateur unique affecté à un élément de travail. Un ID d’élément de travail est unique dans tous les projets au sein d’une organisation ou d’une collection de projets. System.Id
WorkItemRevisionSK Int32 Clé unique d’analytique pour la révision des éléments 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 disponibles sont basés sur le processus que le projet utilise. Pour plus d’informations, consultez À propos des processus et des modèles de processus. System.WorkItemType

Les propriétés de navigation 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 dont ils sont valides.

Nom complet Nom Contrainte référentielle Propriété référentielle Types d’entités valides
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 Area AreaSK WorkItemRevision, WorkItem, WorkItemSnapshot, WorkItemBoardSnapshot
BoardLocation WorkItemRevision, 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
RésoluPar ResolvedBy ResolvedByUserSK UserSK WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Équipes Area, BoardLocation, Itération, WorkItemRevision, WorkItemSnapshot, WorkItemBoardSnapshot
Étiquettes WorkItem, WorkItemRevision, WorkItemBoardSnapshot
Projet Project ProjectSK ProjectSK Tag, WorkItemBoardSnapshot, WorkItemLink, WorkItemRevision, WorkItemSnapshot, WorkItemTypeField
Processus WorkItemRevision, WorkItem, WorkItemSnapshot
Révisions WorkItem
Liens WorkItem
Enfants WorkItem
Parent WorkItem
Descendants WorkItem
WorkItem* WorkItemId WorkItemRevision

*L’entité WorkItem prend également en charge les fonctions et PredictTags les Predict tendances prédictives sur la sélection de rapports et de widgets Analytics intégrés.

BoardLocation et WorkItemBoardSnapshot

Le tableau suivant répertorie et décrit les propriétés définies pour les types d’entités BoardLocation et WorkItemBoardSnapshot , sauf indication contraire. Vous pouvez utiliser ces champs pour 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. Pour obtenir un exemple qui interroge l’ensemble d’entités WorkItemBoardSnapshot, consultez l’exemple de rapport diagramme de flux cumulé (CFD).

Nom complet Nom de la propriété Type de données Descriptif
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 de type d’élément de travail utilisée 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é au tableau, par exemple Stories, Backlog Items, Features ou Epics.
Niveau du conseil BoardLevel Int32 Nombre affecté à 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 Le nom de la colonne de tableau auquel un élément de travail est actuellement affecté, par exemple Active, Closed, Committed, Done ou une étiquette de colonne personnalisée. Nom de la référence : System.BoardColumn
Ordre des colonnes ColumnOrder Int32 Nombre affecté à la colonne de tableau en termes de séquence dans la carte.
Fait Done Énuméré Indicateur de l’emplacement de la colonne fractionnée.*
Limite des éléments de colonne ColumnItemLimit Int32 Nombre affecté à la colonne de carte en termes de séquence.
Le tableau est-il visible ? IsBoardVisible Booléen Indication indiquant si l’équipe a choisi de rendre visible un conseil d’administration.
Colonne scindée? IsColumnSplit Booléen Indication de la répartition d’une colonne en colonnes Doing and Done , comme décrit dans Fractionnement des 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 l’instantané le plus récent des éléments de travail filtrés lorsqu’ils sont définis Truesur .
Est voie par défaut IsDefaultLane Booléen Indication que l’élément de travail est affecté au couloir par défaut lorsqu’il est défini sur True.
Terminé IsDone Booléen Affectation actuelle de l’élément de travail dans une colonne à Faire si False ou Terminé quand True. Valide uniquement lorsque les colonnes fractionnées sont activées pour une colonne de carte. Nom de la référence : System.BoardColumnDone
Identifiant de la voie LaneId Guide GUID unique affecté à un couloir de bord. Chaque équipe peut ajouter un ou plusieurs couloirs à 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. Nom de la référence : System.BoardLane
Ordre des voies LaneOrder Int32 Nombre attribué au couloir de bord en termes de séquence.

*Le tableau suivant répertorie les noms de membres pour le BoardColumnSplit type énuméré, que vous pouvez utiliser pour filtrer les éléments de travail dans les colonnes 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 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 signaler des données de suivi du travail en fonction des affectations de chemins d’accès de zone.

Nom complet Nom Type de données Descriptif
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’accès de zone lors de la création.
Profondeur Depth Int32 Niveau du chemin de zone 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 la création.
Niveau de zone 1 à niveau de zone 14 AreaLevel1 à AreaLevel14 Chaîne Niveau de nœud d’un chemin d’accès de zone jusqu’à 14 niveaux imbriqués. 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 de zone lors de la création.
Chemin d’accès à la zone AreaPath Chaîne Chemin complet du chemin d’accès de la zone commençant par le nœud racine.

Importante

La suppression de valeurs de chemin d’accès 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 widgets burndown et burn up
  • 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

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. Lorsque vous supprimez ces chemins d’accès, vous ne pouvez plus récupérer leurs données historiques.

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 area Path, 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 signaler des données de suivi du travail en fonction des affectations de chemins d’itération.

Nom complet Nom Type de données Descriptif
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 la création.
Profondeur Depth Int32 Niveau du chemin d’itération 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 Indication que la date de fin du chemin d’itération est passée lorsqu’elle est définie sur True.
ID d’itération IterationId Identifiant Unique Global (GUID) Identificateur unique affecté à un chemin d’itération lors de la création.
Niveau d’itération 1 à niveau d’itération 14 IterationLevel1 à IterationLevel14 Chaîne Niveau de nœud d’un chemin d’itération jusqu’à 14 niveaux imbriqués. 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 la création.
Chemin d’itération IterationPath Chaîne Chemin d’itération complet commençant par le nœud racine. L'itération doit être un nœud valide dans la hiérarchie de projet. Nom de la référence : System.IterationPath
Date de début StartDate Date et heure Date de début définie pour le chemin d’itération.

Importante

La suppression de valeurs de chemin d’accès 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 widgets burndown et burn up
  • 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

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. Lorsque vous supprimez ces chemins d’accès, vous ne pouvez plus récupérer leurs données historiques.

Les 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. Utilisez ces propriétés pour filtrer ou signaler des données de suivi du travail sur les types d’éléments de travail pour un projet ou une équipe.

Remarque

Les versions v-2.0, v3.0-preview et v4.0-preview Analytics prennent en charge le type d’entité processus et l’ensemble d’entités Processus .

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 Descriptif
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 affecté au backlog associé au type d’élément de travail. Exemples : Microsoft.EpicCategory, Microsoft.FeatureCategory, Microsoft.RequirementCategoryet Microsoft.TaskCategory.
Nom du backlog BacklogName Booléen Nom de référence affecté au backlog associé au type d’élément de travail
Type de Backlog BacklogType Identifiant Unique Global (GUID) Identificateur unique affecté à un backlog lors de la création.
Niveau d'arriéré BacklogLevel Chaîne Niveau de backlog associé au type d’élément de travail. La null valeur retourne si le type d’élément de travail n’est pas associé à un niveau de backlog.
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 est 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 est supprimé.

Pour plus d’informations sur les backlogs de traitement et les types d’éléments de travail, consultez les articles suivants :

É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 complet Nom Type de données Descriptif
ID de balise TagId Identifiant Unique Global (GUID) ID unique affecté à la balise lors de la 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 complet Nom Type de données Descriptif
AnalyticsUpdatedDate Date et heure Filigrane indiquant la dernière mise à jour des données Analytics.
ID d’équipe TeamId Identifiant Unique Global (GUID) ID unique attribué à l’équipe lors de la 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 projets, zones et itérations.

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 complet Nom Type de données Descriptif
AnalyticsUpdatedDate Date et heure Filigrane indiquant 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 affecté à l’élément de travail lié cible.
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 affecté au type de lien.
Le type de lien est acyclique LinkTypeIsAcyclic Booléen Indication que le type de lien autorise les relations circulaires lorsqu’il est défini sur True. Par exemple, les liens de type d’arborescence limitent les relations circulaires.
Le type de lien est directionnel LinkTypeIsDirectional Booléen Indique si 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 affecté à l’élément de travail source de lien.
ID de l’élément de travail cible TargetWorkItemId Int32 ID affecté à l’élément de travail cible du lien.

Les propriétés de navigation pour le type d’entité WorkItemLink incluent Projects, SourceWorkItem et 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 complet Nom Type de données Descriptif
Nom du champ FieldName Chaîne Nom convivial attribué à un champ par le système ou lors de la création.
Nom de référence de champ FieldReferenceName Chaîne Nom de référence affecté à 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 Type d’élément de travail pour lequel 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és personnalisées. Custom_ ou Custom. est ajouté au nom de la propriété. Vérifiez les métadonnées de votre collection comme décrit dans Interroger les métadonnées. L’exemple suivant montre la syntaxe des métadonnées pour l’opportunité de risque de champ personnalisé.

<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>

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

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 lorsqu’un type d’élément de travail personnalisé et un niveau de backlog sont définis, avec Custom_ ou Custom. ajoutés au GUID de catégorie. Par exemple, une catégorie personnalisée telle que Custom.49b81c4e-9c4f-4c04-94fd-d660cbf3a000 peut être affectée au type d’élément de travail personnalisé Portfolio dans un backlog Portfolios.

Contenu connexe

  • Last updated on