Gegevensmodel voor analyse

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

Het analysegegevensmodel voor Azure DevOps bestaat uit entiteitensets, waarvan de leden (entiteiten) eigenschappen bevatten die kunnen worden gefilterd, geaggregeerd en samengevat. Bovendien bevatten ze navigatie-eigenschappen die entiteiten aan elkaar koppelen, waardoor ze toegang hebben tot andere eigenschappen voor selecteren, filteren en groeperen.

Notitie

De Analytics-service wordt automatisch ingeschakeld en ondersteund in productie voor alle Azure DevOps-services. Power BI-integratie en toegang tot de OData-feed van de Analytics-service zijn algemeen beschikbaar. We raden u aan deze te gebruiken en ons feedback te geven. Beschikbare gegevens zijn afhankelijk van de versie. De meest recente ondersteunde versie is v2.0en de meest recente preview-versie is v4.0-preview. Zie OData API-versiebeheer voor meer informatie.

Schemanaamruimten

Het analysegegevensmodel is gebaseerd op twee schemanaamruimten:

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

Entiteitssets en entiteitstypen

Entiteitstypen worden gestructureerde typen met een sleutel genoemd. Ze definiëren de benoemde eigenschappen en relaties van elke entiteit. De sleutel van een EntityType wordt gevormd uit een subset van de primitieve eigenschappen, bijvoorbeeld WorkItemId, PipelineId, ReleasePipelineId en meer van het entiteitstype.

Entiteitensets zijn benoemde verzamelingen entiteiten. is bijvoorbeeld WorkItems een entiteitsset die entiteiten bevat WorkItem . De sleutel van een entiteit identificeert de entiteit binnen een entiteitsset op unieke wijze. Als meerdere entiteitssets hetzelfde entiteitstype gebruiken, kan dezelfde combinatie van sleutelwaarden worden weergegeven in meer dan één entiteitsset en worden verschillende entiteiten geïdentificeerd, één per entiteitsset waar deze sleutelcombinatie wordt weergegeven. Elk van deze entiteiten heeft een andere entiteits-id. Entiteitssets bieden toegangspunten in het gegevensmodel.

Entiteitssets worden beschreven in OData-metagegevens en variëren per project. U kunt de volledige lijst met entiteitssets, entiteitstypen en eigenschappen verkennen door de OData-metagegevens voor uw project op te vragen. Zie OData-query's maken voor Analytics voor meer informatie.

Samengestelde entiteiten

Samengestelde entiteiten ondersteunen specifieke scenario's. Ze zijn samengesteld uit eenvoudigere entiteiten, hebben vaak meer rekenresources nodig om te genereren en kunnen grotere resultatensets retourneren. Als u de beste prestaties wilt bereiken en onnodige beperking wilt voorkomen, moet u ervoor zorgen dat u de juiste entiteit voor uw scenario opvraagt.

Combineert WorkItemRevisions bijvoorbeeld WorkItemSnapshot en Dates zodanig dat elke datum één revisie voor elk werkitem heeft. Deze weergave ondersteunt OData-query's die gericht zijn op trendgegevens voor een gefilterde set werkitems. U moet deze samengestelde entiteit echter niet gebruiken om een query uit te voeren op de huidige status van werkitems. In plaats daarvan moet u de WorkItems entiteitsset gebruiken om een sneller uitgevoerde query te genereren.

Op dezelfde manier kunnen sommige entiteiten alle historische waarden bevatten, terwijl andere alleen huidige waarden bevatten. WorkItemRevisions bevat alle geschiedenis van werkitems, die u niet mag gebruiken in scenario's waarin de huidige waarden van belang zijn.

Relaties

Als u complexere queryresultaten wilt genereren, kunt u entiteiten combineren met behulp van relaties. U kunt relaties gebruiken om gegevens uit te breiden, te filteren of samen te vatten.

Sommige navigatie-eigenschappen resulteren in één entiteit, terwijl andere resulteren in een verzameling entiteiten. In het volgende diagram ziet u geselecteerde entiteiten en de bijbehorende navigatie-eigenschappen. Voor de duidelijkheid zijn sommige samengestelde entiteiten en relaties weggelaten.

Relatiesleutels

Entiteitsrelaties worden ook weergegeven als refererende sleutels, zodat externe hulpprogramma's entiteiten kunnen koppelen. Deze eigenschappen hebben het achtervoegsel 'SK' en zijn een geheel getal of een GUID-gegevenstype. Datumeigenschappen hebben overeenkomstige datumsleuteleigenschappen voor gehele getallen met de volgende notatie: JJJJMMDD.

Entiteitstypen en entiteitssets voor werktracering

De volgende entiteitstypen en entiteitensets worden ondersteund met de aangegeven API-versies. Zie Naslaginformatie over werktraceringsmetagegevens voor Azure Boards Analytics voor een volledig overzicht.

EntityType/EntitySet	Description	v1.0	v2.0	v 3.0-preview	v4.0-preview
Gebied/ Gebieden	Het werkitem Gebiedspaden, met eigenschappen voor groeperen en filteren op gebiedshiërarchie.	✔️	✔️	✔️	✔️
Iteratie/ Iteraties	De iteratiepaden voor werkitems, met eigenschappen voor groeperen en filteren op iteratiehiërarchie.	✔️	✔️	✔️	✔️
BoardLocation/ BoardLocations	De kanbanbordcellocaties, zoals aangegeven aan boordkolom, zwembaan en split, bevatten historische bordinstellingen. Zie Werkstroom- en Kanbanbordvelden voor een beschrijving van elk kanbanbordveld.	✔️	✔️	✔️	✔️
CalendarDate/ Datums	De datums die worden gebruikt voor het filteren en groeperen van andere entiteiten met behulp van relaties.	✔️	✔️	✔️	✔️
Project/ Projecten	Alle projecten die zijn gedefinieerd voor een organisatie (cloud) of projectverzameling (on-premises).	✔️	✔️	✔️	✔️
Proces/ Processen	Backlog-informatie die wordt gebruikt om werkitems en typen werkitems uit te vouwen of te filteren. Zie Voorbeeldrapport Vereisten bijhouden voor een voorbeeld waarin Processen worden gebruikt om een rapport te filteren.		✔️	✔️	✔️
Tag/ Tags	Alle werkitemlabels voor elk project. Zie Burndown-voorbeeldrapport vrijgeven voor een voorbeeld waarin tags worden gebruikt om een rapport te filteren.	✔️	✔️	✔️	✔️
Team/ Teams	Alle teams die voor het project zijn gedefinieerd. Zie Een teamslicer toevoegen aan een Power BI-rapport voor een voorbeeld waarin Teams wordt gebruikt om een rapport te filteren.	✔️	✔️	✔️	✔️
Gebruiker/ Gebruikers	Gebruikersgegevens die worden gebruikt voor het uitvouwen of filteren van verschillende eigenschappen van werkitems, bijvoorbeeld Toegewezen aan, Gemaakt door.	✔️	✔️	✔️	✔️
WorkItemBoardSnapshot/ WorkItemBoardSnapshot	(Samengesteld) De status van elk werkitem op elke kalenderdatum, inclusief kanbanbordlocatie, die wordt gebruikt om trendrapporten te genereren. Zie het voorbeeldrapport cumulatief stroomdiagram (CFD) voor een voorbeeldrapport.	✔️	✔️	✔️	✔️
WorkItemLink/ WorkItemLinks	De koppelingen tussen werkitems, bijvoorbeeld Onderliggend, Bovenliggend en Gerelateerd. Bevat alleen de meest recente revisie van koppelingen, geen geschiedenis. Hyperlinks worden niet opgenomen.	✔️	✔️	✔️	✔️
WorkItemRevision/ WorkItemRevisions	Alle historische revisies van werkitems, inclusief de huidige revisie. Bevat geen verwijderde werkitems.	✔️	✔️	✔️	✔️
WorkItemSnapshot/ WorkItemSnapshot	(Samengesteld) De status van elk werkitem op elke kalenderdatum, gebruikt ter ondersteuning van trendrapportage. Zie Voorbeeldrapport bugtrends voor een voorbeeldrapport.	✔️	✔️	✔️	✔️
WorkItem/ WorkItems	De huidige status van werkitems. Wordt gebruikt ter ondersteuning van statusrapporten. Zie Waarden van onderliggende werkitems samengetelde naar bovenliggend voorbeeldrapport voor een voorbeeldrapport.	✔️	✔️	✔️	✔️
WorkItemTypeField/ WorkItemTypeFields	De eigenschappen van het werkitem voor elk type werkitem en -proces. Wordt gebruikt ter ondersteuning van het maken van rapporten.	✔️	✔️	✔️	✔️

Entiteitstypen en entiteitssets voor pijplijnen

De volgende entiteitstypen en entiteitssets worden ondersteund met de versie v3.0-preview of v4.0-preview Analytics. Zie Naslaginformatie over pijplijnmetagegevens voor een volledig overzicht.

EntityType/EntitySet	Description	v 3.0-preview	v4.0-preview
Branch/ Vertakkingen	Basisinformatie over vertakkingen die worden gebruikt in tests of pijplijnen. Zie Voorbeeldrapport Voortgangsstatus voor een voorbeeldrapport.	✔️	✔️
ParallelPipelineJobsSnapshot/ ParallelPipelineJobsSnapshot	(Samengesteld) Ondersteunt inzicht in het verbruik van parallelle pijplijnen. Zie Tests parallel uitvoeren met behulp van de Visual Studio Test-taak voor meer informatie over parallelle pijplijntests.		✔️
Pijpleiding/ Pijplijnen	Eigenschappen voor een pijplijn.	✔️	✔️
Pijplijntaak/ Pijplijntaken	Afzonderlijke uitvoeringsresultaten voor een specifieke test die is gekoppeld aan een TestRun	✔️	✔️
PijplijnUitvoeren/ PipelineRuns	Uitvoeringsinformatie voor pijplijnen. Zie Voorbeeldrapport trend voor pijplijnpassage voor een voorbeeldrapport.	✔️	✔️
PipelineRunActivityResult/ PipelineRunActivityResults	Samengevoegd logboek van alle fasen, stappen, taken en taken binnen een specifieke pijplijnuitvoering. Zie Voorbeeldrapport Duur pijplijntaak voor een voorbeeldrapport.	✔️	✔️
PipelineTask/ Pijplijntaken	Eigenschappen voor taken die binnen een pijplijn worden gebruikt.	✔️	✔️
TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots	(Samengesteld) Ondersteunt inzicht in poolgrootte, pijplijntaken en gelijktijdigheid. De historische grafiek voor agentpools laat zien hoe deze entiteitsset kan worden gebruikt.		✔️
TaskAgentRequestSnapshot/ TaskAgentRequestSnapshots	(Samengesteld)		✔️

Entiteitstypen en entiteitssets testen

De volgende entiteitstypen en entiteitssets worden ondersteund met de versie v3.0-preview of v4.0-preview Analytics. Zie Naslaginformatie over metagegevens testen voor een volledig overzicht.

EntityType/EntitySet	Description	v 3.0-preview	v4.0-preview
TestConfiguration/ TestConfiguraties	Configuratiegegevens van het testplan. Zie Verschillende configuraties testen voor meer informatie over het configureren van tests	✔️	✔️
TestResult/ TestResults	Afzonderlijke uitvoeringsresultaten voor een specifieke test die is gekoppeld aan een TestRun.	✔️	✔️
TestResultsDaily/ TestResultsDaily	Een dagelijkse momentopnameaggregatie van TestResult-uitvoeringen , gegroepeerd op Test (niet TestRun). Zie Voorbeeldrapport testoverzicht trendvoorbeeld voor een voorbeeldrapport.	✔️	✔️
TestUitvoeren/ TestRuns	Uitvoeringsinformatie voor tests wordt uitgevoerd onder een pijplijn met aggregate TestResult.	✔️	✔️
Test/ Testen	Eigenschappen voor een testcase, zoals testnaam en testeigenaar. Zie Handmatige testcases maken voor meer informatie over het definiëren van testcases.	✔️	✔️
TestPoint/ Testpoints	Uitvoeringsinformatie voor testpunten. Een testpunt is een unieke combinatie van testcase, testsuite, configuratie en tester. Zie Voorbeeldrapport Voortgangsstatus voor een voorbeeldrapport.	✔️	✔️
TestPointHistorySnapshot/ TestPointHistorySnapshots	(Samengesteld) Afzonderlijke uitvoeringsresultaten voor een specifieke test die is gekoppeld aan een TestRun. Zie Voorbeeldrapport handmatige testuitvoeringstrend voor een voorbeeldrapport	✔️	✔️
Testsuite/ TestSuites	Informatie over testsuites. Zie Testplannen en testsuites maken voor meer informatie over het definiëren van testsuites.	✔️	✔️

Verwante artikelen:

• Richtlijnen voor OData Analytics-query's
• WIT-analyse
• Gegevens samenvoegen
• OData-metagegevens van Analytics verkennen
• Limieten voor processen, projecten en het bijhouden van werk
• Ontwerp van gegevensset met analyseweergaven