Modèle de données pour Analytics

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

Le modèle de données Analytics pour Azure DevOps se compose d’ensembles 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 relient des entités les unes aux autres, ce qui permet d’accéder à d’autres propriétés pour la sélection, le filtrage et le regroupement.

Notes

Le service Analytics est automatiquement activé et pris en charge en production pour tous les Azure DevOps Services. L’intégration power BI et l’accès au flux OData du service Analytics sont en disponibilité générale. 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 préversion 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 Analytics 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 nommées et les relations de chaque entité. La clé d’un 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 est un jeu d’entités contenant des WorkItem entités. La clé d’une entité identifie de manière 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 identifier des entités différentes, une par jeu d’entités où cette combinaison de clés apparaît. 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 métadonnées OData et varient selon le projet. Vous pouvez explorer la liste complète des ensembles d’entités, des types d’entités et des propriétés en demandant les métadonnées OData pour votre projet. Pour savoir comment procéder, consultez Construire des requêtes OData pour Analytics.

Entités composites

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

Par exemple, WorkItemSnapshot combine WorkItemRevisions et Dates de telle sorte que chaque date ait 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 le WorkItems jeu 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 uniquement contenir des valeurs actuelles. WorkItemRevisions contient tout 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 résumer des données.

Certaines propriétés de navigation aboutissent à une seule entité, tandis que d’autres aboutissent à 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.

Clés de relation

Les relations d’entité sont également représentées sous forme de 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 date ont des propriétés de clé de date entière correspondantes au format suivant : AAAAMMJJ.

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

Les types d’entités et 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 Informations de référence sur les métadonnées de suivi du travail pour Azure Boards Analytics.

EntityType/EntitySet	Description	v1.0	v2.0	v3.0-preview	v4.0-preview
Zone/ Zones (Areas)	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 tableau Kanban, tels qu’identifiés par la colonne de tableau, le couloir de bain et le fractionnement, incluent les paramètres historiques du tableau. Pour obtenir une description de chaque champ de tableau Kanban, consultez Workflow et Champs de tableau Kanban.	✔️	✔️	✔️	✔️
CalendarDate/ Dates	Dates utilisées pour filtrer et regrouper d’autres entités à l’aide de relations.	✔️	✔️	✔️	✔️
Project/ Projets	Tous les projets définis pour une collection de projets organization (cloud) ou locale.	✔️	✔️	✔️	✔️
Processus/ Processus	Informations de backlog utilisées pour développer ou filtrer les éléments de travail et les types d’éléments de travail. Pour obtenir un exemple qui utilise des processus pour filtrer un rapport, consultez Exemple de rapport de suivi des exigences.		✔️	✔️	✔️
Étiquette/ Balises	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 mise en production.	✔️	✔️	✔️	✔️
Équipe/ Équipes	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.	✔️	✔️	✔️	✔️
Utilisateur/ Utilisateurs	Informations utilisateur utilisées pour développer ou filtrer diverses propriétés d’élément de travail, par exemple Affecté à, Créé par.	✔️	✔️	✔️	✔️
WorkItemBoardSnapshot/ WorkItemBoardSnapshot	(Composite) État de chaque élément de travail à chaque date de calendrier, y compris l’emplacement du tableau Kanban, utilisé pour générer des rapports de tendance. Pour obtenir un exemple de rapport, consultez Exemple de rapport de diagramme de flux cumulé (CFD).	✔️	✔️	✔️	✔️
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 Cumul des valeurs d’élément de travail enfant sur 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 création de rapports.	✔️	✔️	✔️	✔️

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

Les types d’entités et les jeux d’entités suivants sont pris en charge avec la version d’analyse v3.0-preview ou v4.0-preview . Pour obtenir une référence complète, consultez Informations de référence sur les 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 Progression status exemple de rapport.	✔️	✔️
ParallelPipelineJobsSnapshot/ ParallelPipelineJobsSnapshot	(Composite) Prend en charge la compréhension de la consommation de pipelines parallèles. Pour en savoir plus 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 Exemple de rapport sur la tendance du taux de réussite du 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 Exemple de rapport sur la durée de la tâche 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 comment ce jeu 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 les jeux d’entités suivants sont pris en charge avec la version d’analyse v3.0-preview ou v4.0-preview . 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/ RésultatsTest	Résultats d’exécution individuels pour un test spécifique associé à un TestRun.	✔️	✔️
TestResultsDaily/ TestResultsDaily	Un instantané’agrégat quotidien des exécutions de TestResult, regroupés par Test (et non Par TestRun). Pour obtenir un exemple de rapport, consultez Exemple de rapport sur les tendances résumées 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 du test et le propriétaire du test. Pour plus d’informations sur la définition de 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 Progression status exemple de rapport.	✔️	✔️
TestPointHistorySnapshot/ TestPointHistorySnapshots	(Composite) Résultats d’exécution individuels pour un test spécifique associé à un TestRun. Pour obtenir un exemple de rapport, consultez Exemple de rapport sur les tendances d’exécution manuelle des tests.	✔️	✔️
Testsuite/ TestSuites	Informations sur les suites de tests. Pour plus d’informations sur la définition des suites de tests, consultez Créer des plans de test et des suites de tests.	✔️	✔️

Articles connexes

• Instructions relatives aux requêtes OData Analytics
• Analytique WIT
• Agréger des données
• Exploration des métadonnées OData Analytics
• Limites du suivi du travail, des processus et des projets
• Analyse de la conception du jeu de données