Teilen über


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.

Hinweis

Der Analysedienst wird automatisch installiert und in der Produktion für alle neuen Projektsammlungen für Azure DevOps Server 2020 und höhere Versionen 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. Wenn Sie ein Upgrade von Azure DevOps Server 2019 durchgeführt haben, können Sie den Analysedienst während des Upgrades installieren.

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.

Hinweis

Der Analysedienst befindet sich in der Vorschau für Azure DevOps Server 2019. Sie können es für eine Projektsammlung aktivieren oder installieren. Die Power BI-Integration und der Zugriff auf den OData-Feed des Analytics-Diensts befinden sich in der Vorschau. 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.

Beziehungsdiagramm für das Analysedatenmodell.

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. ✔️ ✔️