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 in Beziehung setzen und zugriff auf andere Eigenschaften zum Auswählen, Filtern und Gruppieren ermöglichen.
Hinweis
Der Analytics-Dienst wird automatisch aktiviert und in der Produktion für alle Azure DevOps Services unterstützt. Die Power BI-Integration und der Zugriff auf den OData-Feed des Analytics-Diensts sind allgemein verfügbar. Wir empfehlen Ihnen, es 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 Analytics-Dienst wird automatisch installiert und in der Produktion für alle neuen Projektsammlungen für Azure DevOps Server 2020 und höhere Versionen unterstützt. Die Power BI-Integration und der Zugriff auf den OData-Feed des Analytics-Diensts sind allgemein verfügbar. Wir empfehlen Ihnen, es zu verwenden und uns Feedback zu geben. Wenn Sie ein Upgrade von Azure DevOps Server 2019 durchgeführt haben, können Sie den Analytics-Dienst 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 Analytics-Dienst befindet sich in der Vorschau für Azure DevOps Server 2019. Sie können sie 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, es 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 Analytics-Datenmodell basiert auf zwei Schemanamespaces:
Microsoft.VisualStudio.Services.Analytics.ModelMicrosoft.VisualStudio.Services.Analytics.
Entitätssätze und Entitätstypen
Entitätstypen werden als strukturierte Typen mit einem Schlüssel bezeichnet. Sie definieren die benannten Eigenschaften und Beziehungen jeder Entität. Der Schlüssel eines EntityType wird aus einer Teilmenge der primitiven Eigenschaften gebildet, z. B. WorkItemId, PipelineId, ReleasePipelineId und mehr des Entitätstyps.
Entitätssätze sind benannte Sammlungen von Entitäten. Beispielsweise ist ein Entitätssatz, WorkItems der Entitäten enthält WorkItem . Der Schlüssel einer Entität identifiziert die Entität innerhalb einer Entitätsgruppe 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 identifizieren, eine pro Entitätsgruppe, in der diese Tastenkombination angezeigt wird. Jede dieser Entitäten weist eine andere Entitäts-ID auf. Entitätssätze bieten Einstiegspunkte in das Datenmodell.
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äten
Zusammengesetzte Entitäten unterstützen bestimmte Szenarien. Sie bestehen aus einfacheren Entitäten, erfordern häufig mehr Rechenressourcen für die Generierung 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.
Beispielsweise kombiniert WorkItemRevisions und Dates so, WorkItemSnapshot dass jedes Datum eine Revision für jedes Arbeitselement hat. Diese Darstellung unterstützt OData-Abfragen, die sich auf Trenddaten für einen gefilterten Satz von Arbeitselementen konzentrieren. Sie sollten diese zusammengesetzte Entität jedoch nicht verwenden, um den aktuellen Status von Arbeitselementen abzufragen. Stattdessen sollten Sie den Entitätssatz WorkItems verwenden, um eine schneller ausgeführte Abfrage zu generieren.
Ebenso können einige Entitäten alle Verlaufswerte enthalten, während andere nur aktuelle Werte enthalten. WorkItemRevisions enthält den gesamten Arbeitselementverlauf, 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. Zur Übersichtlichkeit wurden einige zusammengesetzte Entitäten und Beziehungen weggelassen.
Beziehungsschlüssel
Entitätsbeziehungen werden auch als Fremdschlüssel dargestellt, sodass externe Tools Entitäten verknüpfen können. Diese Eigenschaften haben das Suffix "SK" und sind entweder ganzzahlige oder GUID-Datentypen. Date-Eigenschaften verfügen über entsprechende ganzzahlige Datumsschlüsseleigenschaften im folgenden Format: JJJJMMDD.
Entitätstypen und Entitätsgruppen zur Arbeitsnachverfolgung
Die folgenden Entitätstypen und Entitätssätze werden mit den angegebenen API-Versionen unterstützt. Eine vollständige Referenz finden Sie unter Referenz zu Metadaten zur Arbeitsnachverfolgung für Azure Boards Analytics.
EntityType/EntitySet |
BESCHREIBUNG | v1.0 | v2.0 | v3.0-preview | v4.0-preview |
|---|---|---|---|---|---|
| Bereich/ Bereiche |
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 Zellenstandorte des Kanban-Boards, die durch Boardspalte, Swimlane und Split identifiziert werden, enthalten historische Boardeinstellungen. Eine Beschreibung der einzelnen Kanban-Boardfelder finden Sie unter Workflow- und Kanban-Boardfelder. | ✔️ | ✔️ | ✔️ | ✔️ |
| CalendarDate/ Datumsangaben |
Die Datumsangaben, die zum Filtern und Gruppieren anderer Entitäten mithilfe von Beziehungen verwendet werden. | ✔️ | ✔️ | ✔️ | ✔️ |
| Project/ 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. | ✔️ | ✔️ | ✔️ | |
| Etikett/ Tags |
Alle Arbeitselementtags für jedes Projekt. Ein Beispiel, das Tags zum Filtern eines Berichts verwendet, finden Sie unter Release Burndown-Beispielbericht. | ✔️ | ✔️ | ✔️ | ✔️ |
| Team/ Teams |
Alle teams, die für das Projekt definiert sind. Ein Beispiel, das Teams zum Filtern eines Berichts verwendet, 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 Zustand jedes Arbeitselements für jedes Kalenderdatum, einschließlich des Standorts des Kanban-Boards, der zum Generieren von Trendberichten verwendet wird. Einen Beispielbericht finden Sie unter Cfd-Beispielbericht (Kumulatives Flussdiagramm). | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemLink/ WorkItemLinks |
Die Verknüpfungen zwischen Arbeitselementen, z. B . untergeordneter, übergeordneter und verwandter Elemente. Enthält nur die neueste Revision von Links, keinen Verlauf. Hyperlinks sind nicht enthalten. | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemRevision/ WorkItemRevisions |
Alle historischen Überarbeitungen von Arbeitselementen, einschließlich der aktuellen Überarbeitung. Enthält keine gelöschten Arbeitselemente. | ✔️ | ✔️ | ✔️ | ✔️ |
| WorkItemSnapshot/ WorkItemSnapshot |
(Zusammengesetzt) Der Status jedes Arbeitselements an jedem Kalenderdatum, der zur Unterstützung der Trendberichterstattung verwendet wird. Einen Beispielbericht finden Sie unter Beispielbericht zu Fehlertrends. | ✔️ | ✔️ | ✔️ | ✔️ |
| Workitem/ WorkItems |
Der aktuelle Status der Arbeitselemente. 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 zur Unterstützung von Erstellungsberichten verwendet. | ✔️ | ✔️ | ✔️ | ✔️ |
Pipelines-Entitätstypen und Entitätssätze
Die folgenden Entitätstypen und Entitätssätze werden mit der Analytics-Version v3.0-preview oder v4.0-preview unterstützt. Eine vollständige Referenz finden Sie unter Referenz zu Pipelinemetadaten .
| EntityType/EntitySet | BESCHREIBUNG | v3.0-preview | v4.0-preview |
|---|---|---|---|
| Zweig/ Branches |
Grundlegende Informationen zu Branches, die in Tests oder Pipelines verwendet werden. Einen Beispielbericht finden Sie unter Status status Beispielberichts. | ✔️ | ✔️ |
| ParallelPipelineJobsSnapshot/ ParallelPipelineJobsSnapshot |
(Zusammengesetzt) Unterstützt das Verständnis der parallelen Pipelinenutzung. Weitere Informationen zu parallelen Pipelinetests finden Sie unter Paralleles Ausführen von Tests mit dem Visual Studio-Testtask. | ✔️ | |
| 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 unter Beispielbericht zum Trend der Pipelinedurchlaufrate. | ✔️ | ✔️ |
| PipelineRunActivityResult/ PipelineRunActivityResults |
Zusammengeführtes Protokoll aller Phasen, Schritte, Aufträge und Aufgaben innerhalb einer bestimmten Pipelineausführung. Einen Beispielbericht finden Sie unter Beispielbericht zur Dauer des Pipelinetasks. | ✔️ | ✔️ |
| PipelineTask/ PipelineTasks |
Eigenschaften für Aufgaben, die innerhalb 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ätsgruppen
Die folgenden Entitätstypen und Entitätssätze werden mit der Analytics-Version v3.0-preview oder v4.0-preview unterstützt. Eine vollständige Referenz finden Sie unter Referenz zu Testmetadaten.
EntityType/EntitySet |
BESCHREIBUNG | v3.0-preview | v4.0-preview |
|---|---|---|---|
| Testconfiguration/ TestConfigurations |
Testen Sie Plankonfigurationsinformationen. Ausführliche Informationen zum Konfigurieren von Tests finden Sie unter Testen verschiedener Konfigurationen. | ✔️ | ✔️ |
| Testresult/ TestResults |
Einzelne Ausführungsergebnisse für einen bestimmten Test , der einer TestRun zugeordnet ist. | ✔️ | ✔️ |
| TestResultsDaily/ TestResultsDaily |
Ein tägliches Momentaufnahme Aggregat von TestResult-Ausführungen, gruppiert nach Test (nicht TestRun). Einen Beispielbericht finden Sie unter Test summary trend sample report. | ✔️ | ✔️ |
| 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. Einen Beispielbericht finden Sie unter Status status Beispielberichts. | ✔️ | ✔️ |
| TestPointHistorySnapshot/ TestPointHistorySnapshots |
(Zusammengesetzt) Einzelne Ausführungsergebnisse für einen bestimmten Test , der einer TestRun zugeordnet ist. Einen Beispielbericht finden Sie unter Trendbeispielbericht zur manuellen Testausführung. | ✔️ | ✔️ |
| Testsuite/ TestSuites |
Testsammlungsinformationen. Ausführliche Informationen zum Definieren von Testsammlungen finden Sie unter Erstellen von Testplänen und Testsammlungen. | ✔️ | ✔️ |
Verwandte Artikel
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Tickets als Feedbackmechanismus für Inhalte auslaufen lassen und es durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter: https://aka.ms/ContentUserFeedback.
Einreichen und Feedback anzeigen für