Partage via


Modèle de données pour Analytics

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

Le modèle de données Analytique pour Azure DevOps se compose de jeux d’entités, dont les membres (entités) contiennent des propriétés qui peuvent être filtrées, agrégées et résumées. En outre, ils contiennent des propriétés de navigation qui associent des entités à l’autre, fournissant l’accès à d’autres propriétés pour la sélection, le filtrage et le regroupement.

Remarque

Le service Analytique est automatiquement activé et pris en charge en production pour tous les services Azure DevOps. L’intégration de Power BI et l’accès au flux OData du service Analytique sont généralement disponibles. Nous vous encourageons à l’utiliser et à nous faire part de vos commentaires. Les données disponibles dépendent de la version. La dernière version prise en charge est v2.0, et la dernière version d’évaluation est v4.0-preview. Pour plus d’informations, consultez gestion des versions de l’API OData.

Remarque

Le service Analytique est automatiquement installé et pris en charge en production pour toutes les nouvelles collections de projets pour Azure DevOps Server 2020 et versions ultérieures. L’intégration de Power BI et l’accès au flux OData du service Analytique sont généralement disponibles. Nous vous encourageons à l’utiliser et à nous faire part de vos commentaires. Si vous avez effectué une mise à niveau à partir d’Azure DevOps Server 2019, vous pouvez installer le service Analytique pendant la mise à niveau.

Les données disponibles dépendent de la version. La dernière version prise en charge est v2.0, et la dernière version d’évaluation est v4.0-preview. Pour plus d’informations, consultez gestion des versions de l’API OData.

Remarque

Le service Analytique est en préversion pour Azure DevOps Server 2019. Vous pouvez l’activer ou l’installer pour une collection de projets. L’intégration de Power BI et l’accès au flux OData du service Analytique sont en préversion. Nous vous encourageons à l’utiliser et à nous faire part de vos commentaires.

Les données disponibles dépendent de la version. La dernière version prise en charge est v2.0, et la dernière version d’évaluation est v4.0-preview. Pour plus d’informations, consultez gestion des versions de l’API OData.

Espaces de noms de schéma

Le modèle de données Analytique est basé sur deux espaces de noms de schéma :

  • Microsoft.VisualStudio.Services.Analytics.Model
  • Microsoft.VisualStudio.Services.Analytics.

Jeux d’entités et types d’entités

Les types d’entités sont nommés types structurés avec une clé. Ils définissent les propriétés et relations nommées de chaque entité. La clé d’un élément EntityType est formée à partir d’un sous-ensemble des propriétés primitives, par exemple, WorkItemId, PipelineId, ReleasePipelineId, et plus encore du type d’entité.

Les jeux d’entités sont des collections nommées d’entités. Par exemple, WorkItems il s’agit d’un jeu d’entités contenant des WorkItem entités. La clé d’une entité identifie de façon unique l’entité au sein d’un jeu d’entités. Si plusieurs jeux d’entités utilisent le même type d’entité, la même combinaison de valeurs de clé peut apparaître dans plusieurs ensembles d’entités et identifie différentes entités, une par jeu d’entités où cette combinaison de clés s’affiche. Chacune de ces entités a un ID d’entité différent. Les jeux d’entités fournissent des points d’entrée dans le modèle de données.

Les jeux d’entités sont décrits dans les métadonnées OData et varient selon le projet. Vous pouvez explorer la liste complète des jeux d’entités, des types d’entités et des propriétés en demandant les métadonnées OData pour votre projet. Pour en savoir plus, consultez Créer des requêtes OData pour Analytique.

Entités composées

Les entités composites prennent en charge des scénarios spécifiques. Elles sont composées d’entités plus simples, nécessitent souvent davantage de ressources informatiques pour générer et peuvent retourner des jeux de résultats plus volumineux. Pour obtenir les meilleures performances et éviter une limitation inutile, veillez à interroger l’entité appropriée pour votre scénario.

Par exemple, WorkItemSnapshot combine et WorkItemRevisions Dates telle que chaque date a une révision pour chaque élément de travail. Cette représentation prend en charge les requêtes OData qui se concentrent sur les données de tendance pour un ensemble filtré d’éléments de travail. Toutefois, vous ne devez pas utiliser cette entité composite pour interroger l’état actuel des éléments de travail. Au lieu de cela, vous devez utiliser l’ensemble WorkItems d’entités pour générer une requête plus rapide.

De même, certaines entités peuvent contenir toutes les valeurs historiques, tandis que d’autres peuvent contenir uniquement des valeurs actuelles. WorkItemRevisions contient l’historique des éléments de travail, que vous ne devez pas utiliser dans les scénarios où les valeurs actuelles sont intéressantes.

Relations

Pour générer des résultats de requête plus complexes, vous pouvez combiner des entités à l’aide de relations. Vous pouvez utiliser des relations pour développer, filtrer ou synthétiser des données.

Certaines propriétés de navigation entraînent une entité unique, tandis que d’autres entraînent une collection d’entités. Le diagramme suivant montre les entités sélectionnées et leurs propriétés de navigation. Pour plus de clarté, certaines entités et relations composites ont été omises.

Diagramme de relation pour Analytique modèle de données.

Clés de relation

Les relations d’entité sont également représentées en tant que clés étrangères afin que les outils externes puissent joindre des entités. Ces propriétés ont le suffixe « SK » et sont des types de données entiers ou GUID. Les propriétés de date ont des propriétés de clé de date entière correspondantes au format suivant : AAAAMMDD.

Types d’entités et jeux d’entités de suivi du travail

Les types d’entités et les jeux d’entités suivants sont pris en charge avec les versions d’API indiquées. Pour obtenir une référence complète, consultez la référence des métadonnées de suivi des tâches pour Azure Boards Analytique.

EntityType/EntitySet Description v1.0 v2.0 v3.0-preview v4.0-preview
Zone/
Zones
Chemins d’accès à la zone de l’élément de travail, avec des propriétés pour le regroupement et le filtrage par hiérarchie de zones. ✔️ ✔️ ✔️ ✔️
Itération/
Itérations
Chemins d’itération de l’élément de travail, avec des propriétés pour le regroupement et le filtrage par hiérarchie d’itération. ✔️ ✔️ ✔️ ✔️
BoardLocation/
BoardLocations
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. ✔️ ✔️ ✔️ ✔️
CalendarDate/
Dates
Dates utilisées pour filtrer et regrouper d’autres entités à l’aide de relations. ✔️ ✔️ ✔️ ✔️
Projet/
Projets
Tous les projets définis pour un organization (cloud) ou une collection de projets (local). ✔️ ✔️ ✔️ ✔️
Process/
Processus
Informations de backlog utilisées pour développer ou filtrer les éléments de travail et les types d’éléments de travail. Pour obtenir un exemple qui utilise des processus pour filtrer un rapport, consultez Exemple de rapport de suivi des exigences. ✔️ ✔️ ✔️
Tag/
Étiquettes
Toutes les étiquettes d’élément de travail pour chaque projet. Pour obtenir un exemple qui utilise des balises pour filtrer un rapport, consultez Exemple de rapport de burndown de mise en production. ✔️ ✔️ ✔️ ✔️
Team/
Teams
Toutes les équipes définies pour le projet. Pour obtenir un exemple qui utilise Teams pour filtrer un rapport, consultez Ajouter un segment Team à un rapport Power BI. ✔️ ✔️ ✔️ ✔️
Utilisateur/
Utilisateurs
Informations utilisateur utilisées pour développer ou filtrer diverses propriétés d’élément de travail, par exemple Affectée à, Créé par. ✔️ ✔️ ✔️ ✔️
WorkItemBoardSnapshot/
WorkItemBoardSnapshot
(Composite) État de chaque élément de travail 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 Exemple de rapport de diagramme de flux cumulé (CFD). ✔️ ✔️ ✔️ ✔️
WorkItemLink/
WorkItemLinks
Liens entre les éléments de travail, par exemple, Enfant, Parent et Connexe. Inclut uniquement la dernière révision des liens, sans historique. Les liens hypertexte ne sont pas inclus. ✔️ ✔️ ✔️ ✔️
WorkItemRevision/
WorkItemRevisions
Toutes les révisions d’éléments de travail historiques, y compris la révision actuelle. N’inclut pas les éléments de travail supprimés. ✔️ ✔️ ✔️ ✔️
WorkItemSnapshot/
WorkItemSnapshot
(Composite) État de chaque élément de travail à chaque date de calendrier, utilisé pour prendre en charge les rapports de tendances. Pour obtenir un exemple de rapport, consultez Exemple de rapport sur les tendances des bogues. ✔️ ✔️ ✔️ ✔️
WorkItem/
WorkItems
État actuel des éléments de travail. Utilisé pour prendre en charge les rapports status. Pour obtenir un exemple de rapport, consultez Cumuler les valeurs d’élément de travail enfant dans l’exemple de rapport parent. ✔️ ✔️ ✔️ ✔️
WorkItemTypeField/
WorkItemTypeFields
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. ✔️ ✔️ ✔️ ✔️

Types d’entités et jeux d’entités de pipelines

Les types d’entités et jeux d’entités suivants sont pris en charge avec la version v3.0-preview ou v4.0-preview Analytique. Pour obtenir une référence complète, consultez référence de métadonnées de pipeline .

EntityType/EntitySet Description v3.0-preview v4.0-preview
Branche/
Branches
Informations de base sur les branches utilisées dans les tests ou les pipelines. Pour obtenir un exemple de rapport, consultez l’exemple de rapport État de progression. ✔️ ✔️
ParallelPipelineJobsSnapshot/
ParallelPipelineJobsSnapshot
(Composite) Prend en charge la compréhension de la consommation de pipeline parallèle. Pour plus d’informations sur les tests de pipeline parallèles, consultez Exécuter des tests en parallèle à l’aide de la tâche de test Visual Studio. ✔️
Pipeline/
Pipelines
Propriétés d’un pipeline. ✔️ ✔️
PipelineJob/
PipelineJobs
Résultats d’exécution individuels pour un test spécifique associé à un TestRun ✔️ ✔️
PipelineRun/
PipelineRuns
Informations d’exécution pour les pipelines. Pour obtenir un exemple de rapport, consultez l’exemple de rapport de tendance du taux de transmission de pipeline. ✔️ ✔️
PipelineRunActivityResult/
PipelineRunActivityResults
Journal fusionné de toutes les étapes, étapes, travaux et tâches au sein d’une exécution de pipeline spécifique. Pour obtenir un exemple de rapport, consultez l’exemple de rapport de durée des tâches de pipeline. ✔️ ✔️
PipelineTask/
PipelineTasks
Propriétés des tâches utilisées dans un pipeline. ✔️ ✔️
TaskAgentPoolSizeSnapshot/
TaskAgentPoolSizeSnapshots
(Composite) Prend en charge la compréhension de la taille du pool, des travaux de pipeline et de la concurrence. Le graphique historique des pools d’agents illustre la façon dont cet ensemble d’entités peut être utilisé. ✔️
TaskAgentRequestSnapshot/
TaskAgentRequestSnapshots
(Composite) ✔️

Tester les types d’entités et les jeux d’entités

Les types d’entités et jeux d’entités suivants sont pris en charge avec la version v3.0-preview ou v4.0-preview Analytique. Pour obtenir une référence complète, consultez référence des métadonnées de test.

EntityType/EntitySet Description v3.0-preview v4.0-preview
TestConfiguration/
TestConfigurations
Informations de configuration du plan de test. Pour plus d’informations sur la configuration des tests, consultez Tester différentes configurations ✔️ ✔️
TestResult/
TestResults
Résultats d’exécution individuels pour un test spécifique associé à un TestRun. ✔️ ✔️
TestResultsDaily/
TestResultsDaily
Agrégat d’instantanés quotidiens des exécutions TestResult , regroupés par Test (et non TestRun). Pour obtenir un exemple de rapport, consultez l’exemple de rapport de tendance de résumé des tests. ✔️ ✔️
TestRun/
TestRuns
Informations d’exécution pour les tests exécutés sous un pipeline avec l’agrégat TestResult. ✔️ ✔️
Test/
Tests
Propriétés d’un cas de test, telles que le nom de test et le propriétaire de test. Pour plus d’informations sur la définition des cas de test, consultez Créer des cas de test manuels. ✔️ ✔️
TestPoint/
TestPoints
Informations d’exécution pour les points de test. Un point de test est une combinaison unique de cas de test, de suite de tests, de configuration et de testeur. Pour obtenir un exemple de rapport, consultez l’exemple de rapport État de progression. ✔️ ✔️
TestPointHistorySnapshot/
TestPointHistorySnapshots
(Composite) Résultats d’exécution individuels pour un test spécifique associé à un TestRun. Pour obtenir un exemple de rapport, consultez l’exemple de rapport de tendance d’exécution des tests manuels ✔️ ✔️
TestSuite/
TestSuites
Informations sur les suites de tests. Pour plus d’informations sur la définition des suites de test, consultez Créer des plans de test et des suites de test. ✔️ ✔️