Gegevensmodel voor analyse

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

Het analysegegevensmodel voor Azure DevOps bestaat uit entiteitssets, waarvan de leden (entiteiten) eigenschappen bevatten die kunnen worden gefilterd, samengevoegd en samengevat. Daarnaast bevatten ze navigatie-eigenschappen die entiteiten aan elkaar koppelen en toegang bieden tot andere eigenschappen voor het 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 versie. De meest recente ondersteunde versie is v2.0en de nieuwste 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 zijn benoemde gestructureerde typen met een sleutel. 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.

Entiteitssets zijn benoemde verzamelingen entiteiten. Bijvoorbeeld, WorkItems is een verzameling die WorkItem entiteiten bevat. De sleutel van een entiteit identificeert de entiteit in een entiteitsset op unieke wijze. Als meerdere entiteitssets hetzelfde entiteitstype gebruiken, kan dezelfde combinatie van sleutelwaarden in meer dan één entiteitsset worden weergegeven en verschillende entiteiten worden geïdentificeerd, één per entiteitsset waarin deze toetsencombinatie wordt weergegeven. Elk van deze entiteiten heeft een andere entiteits-id. Entiteitssets bieden invoerpunten 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 aan te vragen. Zie OData-query's maken voor analyse voor meer informatie.

Samengestelde entiteiten

Samengestelde entiteiten ondersteunen specifieke scenario's. Ze bestaan uit eenvoudigere entiteiten, vereisen vaak meer rekenresources om te genereren en kunnen grotere resultatensets retourneren. Om de beste prestaties te bereiken en onnodige capaciteitsbeperking te voorkomen, moet u ervoor zorgen dat u de juiste entiteit voor uw scenario opvraagt.

Combineert WorkItemSnapshot bijvoorbeeld WorkItemRevisions en Dates zodanig dat elke datum één revisie heeft voor elk werkitem. Deze weergave ondersteunt OData-query's die zich richten 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 moet 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 vouwen, 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 de geselecteerde entiteiten en de bijbehorende navigatie-eigenschappen. Voor de duidelijkheid zijn enkele samengestelde entiteiten en relaties weggelaten.

Relatiesleutels

Entiteitsrelaties worden ook weergegeven als vreemde sleutels, zodat externe hulpprogramma's entiteiten kunnen koppelen. Deze eigenschappen hebben het achtervoegsel SK en zijn geheel getal- of GUID-gegevenstypen. Datumeigenschappen hebben overeenkomende datumsleuteleigenschappen met de volgende notatie: JJJJMMDD.

Entiteitstypen en entiteitssets voor werktracering

De volgende entiteitstypen en entiteitssets worden ondersteund met de aangegeven API-versies. Zie de naslaginformatie over metagegevens voor het bijhouden van werk voor Azure Boards Analytics voor een volledige naslaginformatie.

EntityType/EntitySet	Beschrijving	v1.0	v2.0	v3.0-preview	v4.0-preview
Gebied/ Gebieden	De werkitemgebiedpaden, met eigenschappen voor het groeperen en filteren op gebiedshiërarchie.	✔️	✔️	✔️	✔️
Herhaling/ Iteraties	De iteratiepaden voor werkitems, met eigenschappen voor het groeperen en filteren op iteratiehiërarchie.	✔️	✔️	✔️	✔️
BoardLocation/ BoardLocations	De locaties van de bordcellen, zoals geïdentificeerd door bordkolom, swimlane en split, bevatten historische bordinstellingen. Zie Werkstroom- en bordvelden voor een beschrijving van elk bordveld.	✔️	✔️	✔️	✔️
CalendarDate/ Datums	De datums die worden gebruikt om andere entiteiten te filteren en te groeperen met behulp van relaties.	✔️	✔️	✔️	✔️
Project/ Projecten	Alle projecten die zijn gedefinieerd voor een organisatie (cloud) of projectverzameling (on-premises).	✔️	✔️	✔️	✔️
Verwerken/ Processen	Achterstandsgegevens die worden gebruikt om werkitems en werkitemstypen uit te vouwen of te filteren. Zie de voorbeeldrapportage voor het bijhouden van vereisten als een voorbeeld dat processen gebruikt om een rapport te filteren.		✔️	✔️	✔️
Tag/ Tags	Alle werkitemtags voor elk project. Voor een voorbeeld waarin Tags worden gebruikt om een rapport te filteren, zie het Release burndown-voorbeeldrapport.	✔️	✔️	✔️	✔️
Team/ Teams	Alle teams die zijn gedefinieerd voor het project. 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 om verschillende eigenschappen van werkitems uit te vouwen of te filteren, bijvoorbeeld Toegewezen aan, Gemaakt door.	✔️	✔️	✔️	✔️
WorkItemBoardSnapshot/ WorkItemBoardSnapshot	(Samengesteld) De status van elk werkitem op elke kalenderdatum, inclusief bordlocatie, die wordt gebruikt om trendrapporten te genereren. Zie het voorbeeldrapport van het cumulatief stroomdiagram (CFD) voor een voorbeeldrapport.	✔️	✔️	✔️	✔️
WorkItemLink/ WorkItemLinks	De koppelingen tussen werkitems, bijvoorbeeld Kind, Ouder, en Gerelateerd. Bevat alleen de meest recente revisie van koppelingen, geen geschiedenis. Hyperlinks zijn niet opgenomen.	✔️	✔️	✔️	✔️
WorkItemRevision/ WorkItemRevisions	Alle revisies van historische werkitems, inclusief de huidige revisie. Bevat geen verwijderde werkitems.	✔️	✔️	✔️	✔️
WorkItemSnapshot/ WorkItemSnapshot	(Samengesteld) De status van elk werkitem op elke kalenderdatum, die wordt gebruikt ter ondersteuning van trendrapportage. Zie Bug trends voorbeeldrapport voor een voorbeeldrapport.	✔️	✔️	✔️	✔️
WorkItem/ WorkItems	De huidige status van werkitems. Wordt gebruikt ter ondersteuning van statusrapporten. Zie Rollup van waarden van onderliggende werkitems naar bovenliggend voorbeeldrapport voor een voorbeeldrapport.	✔️	✔️	✔️	✔️
WorkItemTypeField/ WorkItemTypeFields	De eigenschappen van het werkitem voor elk type werkitem en elk proces. Wordt gebruikt om het bouwen van rapporten te ondersteunen.	✔️	✔️	✔️	✔️

Entiteitstypen en entiteitssets voor pijplijnen

De volgende entiteitstypen en entiteitssets worden ondersteund met de versie v3.0-preview of v4.0-preview Analytics. Zie Referentie voor pijplijnmetagegevens voor een volledige verwijzing.

EntiteitType/EntiteitSet	Beschrijving	v3.0-preview	v4.0-preview
Filiaal/ Vestigingen	Basisinformatie over vertakkingen die worden gebruikt in tests of pijplijnen. Zie het voorbeeldrapport Voortgangsstatus voor een voorbeeld.	✔️	✔️
ParallelPipelineJobsSnapshot/ ParallelPipelineJobsSnapshot	(Samengesteld) Ondersteunt inzicht in het gebruik van parallelle pijplijnen. Zie Testtests parallel uitvoeren met behulp van de Visual Studio-testtaak voor meer informatie over parallelle pijplijntests.		✔️
Pijplijn/ Pijplijnen	Eigenschappen voor een pijplijn.	✔️	✔️
PipelineJob/ PipelineJobs	Afzonderlijke uitvoeringsresultaten voor een specifieke test die is gekoppeld aan een TestRun	✔️	✔️
PipelineRun/ PipelineRuns	Uitvoeringsinformatie voor pijplijnen. Voor een voorbeeldrapport, zie voorbeeldrapport trends in slagingspercentage van de pijplijn.	✔️	✔️
PipelineRunActivityResult/ PipelineRunActivityResults	Samengevoegd logboek van alle fasen, stappen, opdrachten en taken binnen een specifieke pijplijnuitvoering. Zie voor een voorbeeldrapport het voorbeeldrapport voor de duur van pijplijntaken.	✔️	✔️
PipelineTask/ PipelineTasks	Eigenschappen voor taken die in een pijplijn worden gebruikt.	✔️	✔️
TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots	(Samengesteld) Ondersteunt inzicht in poolgrootte, pijplijntaken en gelijktijdigheid. In de historische grafiek voor agentpools ziet u 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. Raadpleeg de Naslaginformatie over testmetagegevens voor een volledige referentie.

EntityType/EntitySet	Beschrijving	v3.0-preview	v4.0-preview
TestConfiguration/ TestConfiguraties	Configuratie-informatie 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 het Voorbeeldrapport trendsamenvatting test.	✔️	✔️
TestRun/ TestRuns	Uitvoeringsinformatie voor tests die worden uitgevoerd onder een pijplijn met geaggregeerde TestResultaten.	✔️	✔️
Testen/ 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 voorbeeld.	✔️	✔️
TestPointHistorySnapshot/ TestPointHistorySnapshots	(Samengesteld) Afzonderlijke uitvoeringsresultaten voor een specifieke test die is gekoppeld aan een TestRun. Zie het voorbeeldrapport Voorbeeldrapport voor handmatige testuitvoeringstrend voor een voorbeeldrapport.	✔️	✔️
TestSuite/ TestSuites	Test suites informatie. Zie Testplannen en testsuites maken voor meer informatie over het definiëren van testsuites.	✔️	✔️

Verwante artikelen:

• OData Analytics-queryrichtlijnen
• WIT-analyse
• Geaggregeerde gegevens
• OData-metagegevens van Analytics verkennen
• Limieten voor processen, projecten en het bijhouden van werk
• Ontwerp van gegevensset voor analyseweergaven