Datenmodell für Analytics

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

Das Analysedatenmodell für Azure DevOps besteht aus Entitätssätzen, deren Member (Entitäten) Eigenschaften enthalten, die gefiltert, aggregiert und zusammengefasst werden können. Darüber hinaus enthalten sie Navigationseigenschaften , die Entitäten miteinander verknüpfen und Zugriff auf andere Eigenschaften zum Auswählen, Filtern und Gruppieren bieten.

Hinweis

Der Analysedienst wird automatisch aktiviert und in der Produktion für alle Azure DevOps-Dienste unterstützt. Power BI-Integration und Zugriff auf den OData-Feed des Analytics-Diensts sind allgemein verfügbar. Wir empfehlen Ihnen, sie zu verwenden und uns Feedback zu geben. Verfügbare Daten sind versionsabhängig. Die neueste unterstützte Version ist v2.0, und die neueste Vorschauversion ist v4.0-preview. Weitere Informationen finden Sie unter OData-API-Versionsverwaltung.

Schemanamespaces

Das Analysedatenmodell basiert auf zwei Schemanamespaces:

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

Entitätssätze und Entitätstypen

Entitätstypen sind benannte strukturierte Typen mit einem Schlüssel. Sie definieren die benannten Eigenschaften und Beziehungen jeder Entität. Der Schlüssel eines Objekts EntityType wird aus einer Teilmenge der primitiven Eigenschaften gebildet, z. B. WorkItemId, PipelineId, ReleasePipelineId und mehr des Entitätstyps.

Entitätssätze sind benannte Auflistungen von Entitäten. Ist beispielsweise ein Entitätssatz, WorkItems der Entitäten enthält WorkItem . Der Schlüssel einer Entität identifiziert die Entität innerhalb eines Entitätssatzes eindeutig. Wenn mehrere Entitätssätze denselben Entitätstyp verwenden, kann dieselbe Kombination von Schlüsselwerten in mehr als einem Entitätssatz angezeigt werden und unterschiedliche Entitäten identifiziert werden, eine pro Entitätsgruppe, in der diese Tastenkombination angezeigt wird. Jede dieser Entitäten weist eine andere Entitäts-ID auf. Entitätssätze stellen Einstiegspunkte in das Datenmodell bereit.

Entitätssätze werden in OData-Metadaten beschrieben und variieren je nach Projekt. Sie können die vollständige Liste der Entitätssätze, Entitätstypen und Eigenschaften untersuchen, indem Sie die OData-Metadaten für Ihr Projekt anfordern. Informationen dazu finden Sie unter Erstellen von OData-Abfragen für Analytics.

Zusammengesetzte Entität

Zusammengesetzte Entitäten unterstützen bestimmte Szenarien. Sie bestehen aus einfacheren Entitäten, erfordern häufig mehr Computerressourcen zum Generieren und geben möglicherweise größere Resultsets zurück. Um die beste Leistung zu erzielen und unnötige Drosselung zu vermeiden, stellen Sie sicher, dass Sie die richtige Entität für Ihr Szenario abfragen.

Kombiniert WorkItemRevisions beispielsweise und Dates so, WorkItemSnapshot dass jedes Datum eine Überarbeitung für jede Arbeitsaufgabe hat. Diese Darstellung unterstützt OData-Abfragen, die sich auf Trenddaten für einen gefilterten Satz von Arbeitsaufgaben konzentrieren. Sie sollten diese zusammengesetzte Entität jedoch nicht verwenden, um den aktuellen Status von Arbeitsaufgaben abzufragen. Stattdessen sollten Sie den WorkItems Entitätssatz verwenden, um eine schneller ausgeführte Abfrage zu generieren.

Ebenso können einige Entitäten alle historischen Werte enthalten, während andere nur aktuelle Werte enthalten können. WorkItemRevisions enthält den gesamten Arbeitsaufgabenverlauf, den Sie nicht in Szenarien verwenden sollten, in denen die aktuellen Werte von Interesse sind.

Beziehungen

Um komplexere Abfrageergebnisse zu generieren, können Sie Entitäten mithilfe von Beziehungen kombinieren. Sie können Beziehungen verwenden, um Daten zu erweitern, zu filtern oder zusammenzufassen.

Einige Navigationseigenschaften führen zu einer einzelnen Entität, während andere zu einer Sammlung von Entitäten führen. Das folgende Diagramm zeigt ausgewählte Entitäten und deren Navigationseigenschaften. Aus Gründen der Klarheit wurden einige zusammengesetzte Entitäten und Beziehungen weggelassen.

Beziehungsschlüssel

Entitätsbeziehungen werden auch als Fremdschlüssel dargestellt, sodass externe Tools Entitäten verbinden können. Diese Eigenschaften weisen das Suffix "SK" auf und sind entweder ganzzahlige oder GUID-Datentypen. Datumseigenschaften weisen die entsprechenden ganzzahligen Datumsschlüsseleigenschaften mit dem folgenden Format auf: JJJJMMD.

Entitätstypen und Entitätssätze für die Arbeitsnachverfolgung

Die folgenden Entitätstypen und Entitätssätze werden mit den angegebenen API-Versionen unterstützt. Eine vollständige Referenz finden Sie unter Arbeitsverfolgungsmetadatenreferenz für Azure Boards Analytics.

EntityType/EntitySet	Beschreibung	v1.0	v2.0	v3.0-preview	v4.0-preview
Bereich/ Bereichen	Das Arbeitselement Bereichspfade mit Eigenschaften zum Gruppieren und Filtern nach Bereichshierarchie.	✔️	✔️	✔️	✔️
Iteration/ Iterationen	Das Arbeitselement Iterationspfade mit Eigenschaften zum Gruppieren und Filtern nach Iterationshierarchie.	✔️	✔️	✔️	✔️
BoardLocation/ BoardLocations	Die Boardzellenpositionen, wie durch Boardspalte, Verantwortlichkeitsbereich und Split identifiziert, umfassen historische Boardeinstellungen. Eine Beschreibung der einzelnen Tafelfelder finden Sie unter Workflow- und Board-Felder.	✔️	✔️	✔️	✔️
CalendarDate/ Datumsangaben	Die Datumsangaben, die zum Filtern und Gruppieren anderer Entitäten mithilfe von Beziehungen verwendet werden.	✔️	✔️	✔️	✔️
Projekt/ Projekte	Alle Projekte, die für eine organization (Cloud) oder Projektsammlung (lokal) definiert sind.	✔️	✔️	✔️	✔️
Prozess/ Prozesse	Backloginformationen, die zum Erweitern oder Filtern von Arbeitselementen und Arbeitselementtypen verwendet werden. Ein Beispiel, das Prozesse zum Filtern eines Berichts verwendet, finden Sie unter Beispielbericht zur Anforderungsnachverfolgung.		✔️	✔️	✔️
Tag/ Tags	Alle Arbeitselementtags für jedes Projekt. Ein Beispiel, das Tags zum Filtern eines Berichts verwendet, finden Sie unter Release burndown sample report.	✔️	✔️	✔️	✔️
Team/ Teams	Alle Teams, die für das Projekt definiert sind. Ein Beispiel, in dem Teams zum Filtern eines Berichts verwendet wird, finden Sie unter Hinzufügen eines Team-Slicers zu einem Power BI-Bericht.	✔️	✔️	✔️	✔️
Benutzer/ Benutzer	Benutzerinformationen, die zum Erweitern oder Filtern verschiedener Arbeitselementeigenschaften verwendet werden, z. B . Zugewiesen an, Erstellt von.	✔️	✔️	✔️	✔️
WorkItemBoardSnapshot/ WorkItemBoardSnapshot	(Zusammengesetzt) Der Status jeder Arbeitsaufgabe an jedem Kalenderdatum, einschließlich des Boardstandorts, der zum Generieren von Trendberichten verwendet wird. Einen Beispielbericht finden Sie unter Cfd-Beispielbericht (Cumulative Flow Diagram).	✔️	✔️	✔️	✔️
WorkItemLink/ WorkItemLinks	Die Verknüpfungen zwischen Arbeitselementen, z. B . Untergeordnete Elemente, Übergeordnete Elemente und Verwandte Elemente. Enthält nur die neueste Revision von Links, keinen Verlauf. Hyperlinks sind nicht enthalten.	✔️	✔️	✔️	✔️
WorkItemRevision/ WorkItemRevisions	Alle überarbeitungen von historischen Arbeitselementen, einschließlich der aktuellen Revision. Enthält keine gelöschten Arbeitsaufgaben.	✔️	✔️	✔️	✔️
WorkItemSnapshot/ WorkItemSnapshot	(Zusammengesetzt) Der Status der einzelnen Arbeitselemente an jedem Kalenderdatum, der zur Unterstützung der Trendberichterstattung verwendet wird. Einen Beispielbericht finden Sie unter Beispielbericht zu Fehlertrends.	✔️	✔️	✔️	✔️
Workitem/ WorkItems	Der aktuelle Status von Arbeitselementen. Wird verwendet, um status Berichte zu unterstützen. Einen Beispielbericht finden Sie unter Rollup untergeordneter Arbeitselementwerte in einen übergeordneten Beispielbericht.	✔️	✔️	✔️	✔️
WorkItemTypeField/ WorkItemTypeFields	Die Arbeitselementeigenschaften für jeden Arbeitselementtyp und -prozess. Wird verwendet, um das Erstellen von Berichten zu unterstützen.	✔️	✔️	✔️	✔️

Pipelines-Entitätstypen und Entitätssätze

Die folgenden Entitätstypen und Entitätssätze werden mit der Version v3.0-preview oder v4.0-preview Analytics unterstützt. Eine vollständige Referenz finden Sie unter Pipelinemetadatenreferenz .

EntityType/EntitySet	Beschreibung	v3.0-preview	v4.0-preview
Branch/ Branches	Grundlegende Informationen zu Verzweigungen, die in Tests oder Pipelines verwendet werden. Ein Beispielbericht finden Sie im Statusstatus-Beispielbericht.	✔️	✔️
ParallelPipelineJobsSnapshot/ ParallelPipelineJobsSnapshot	(Zusammengesetzt) Unterstützt das Verständnis der parallelen Pipelinenutzung. Weitere Informationen zu parallelen Pipelinetests finden Sie unter Paralleles Ausführen von Tests mithilfe der Visual Studio Test-Aufgabe.		✔️
Pipeline/ Pipelines	Eigenschaften für eine Pipeline.	✔️	✔️
PipelineJob/ PipelineJobs	Einzelne Ausführungsergebnisse für einen bestimmten Test, der einem TestRun zugeordnet ist	✔️	✔️
PipelineRun/ PipelineRuns	Ausführungsinformationen für Pipelines. Einen Beispielbericht finden Sie im Beispielbericht zur Pipelinedurchlaufrate.	✔️	✔️
PipelineRunActivityResult/ PipelineRunActivityResults	Zusammengeführtes Protokoll aller Phasen, Schritte, Aufträge und Aufgaben innerhalb einer bestimmten Pipelineausführung. Einen Beispielbericht finden Sie im Beispielbericht zu Pipelineaufgabendauer.	✔️	✔️
PipelineTask/ PipelineTasks	Eigenschaften für Aufgaben, die in einer Pipeline verwendet werden.	✔️	✔️
TaskAgentPoolSizeSnapshot/ TaskAgentPoolSizeSnapshots	(Zusammengesetzt) Unterstützt das Verständnis von Poolgröße, Pipelineaufträgen und Parallelität. Das Verlaufsdiagramm für Agentpools veranschaulicht, wie dieser Entitätssatz verwendet werden kann.		✔️
TaskAgentRequestSnapshot/ TaskAgentRequestSnapshots	(Zusammengesetzt)		✔️

Testen von Entitätstypen und Entitätssätzen

Die folgenden Entitätstypen und Entitätssätze werden mit der Version v3.0-preview oder v4.0-preview Analytics unterstützt. Eine vollständige Referenz finden Sie unter Testmetadatenreferenz.

EntityType/EntitySet	Beschreibung	v3.0-preview	v4.0-preview
TestConfiguration/ TestConfigurations	Testplankonfigurationsinformationen. Ausführliche Informationen zum Konfigurieren von Tests finden Sie unter "Testen verschiedener Konfigurationen".	✔️	✔️
TestResult/ TestResults	Einzelne Ausführungsergebnisse für einen bestimmten Test , der einem TestRun zugeordnet ist.	✔️	✔️
TestResultsDaily/ TestResultsDaily	Ein tägliches Snapshot-Aggregat von TestResult-Ausführungen , gruppiert nach Test (nicht TestRun). Einen Beispielbericht finden Sie im Bericht "Testzusammenfassung des Trendbeispiels".	✔️	✔️
TestRun/ TestRuns	Ausführungsinformationen für Tests, die unter einer Pipeline mit aggregiertem TestResult ausgeführt werden.	✔️	✔️
Test/ Tests	Eigenschaften für einen Testfall, z. B. Testname und Testbesitzer. Ausführliche Informationen zum Definieren von Testfällen finden Sie unter Erstellen manueller Testfälle.	✔️	✔️
TestPoint/ TestPoints	Ausführungsinformationen für Testpunkte. Ein Testpunkt ist eine einzigartige Kombination aus Testfall, Testsammlung, Konfiguration und Tester. Ein Beispielbericht finden Sie im Statusstatus-Beispielbericht.	✔️	✔️
TestPointHistorySnapshot/ TestPointHistorySnapshots	(Zusammengesetzt) Einzelne Ausführungsergebnisse für einen bestimmten Test , der einem TestRun zugeordnet ist. Ein Beispielbericht finden Sie im Trendbericht zur manuellen Testausführung	✔️	✔️
TestSuite/ TestSuites	Informationen zu Testsammlungen. Ausführliche Informationen zum Definieren von Testsuiten finden Sie unter Erstellen von Testplänen und Testsuiten.	✔️	✔️

Verwandte Artikel

• OData Analytics-Abfragerichtlinien
• WIT-Analyse
• Aggregatdaten
• Untersuchen von OData-Metadaten für Analysen
• Einschränkungen für Arbeitsnachverfolgung, Prozesse und Projekte
• Entwurf des Datasets für Analyseansichten