Freigeben über


Erstellen eines Analyse-Widgets für Azure DevOps

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

Sie können Ihr eigenes Analyse-Widget erstellen, um in einem Dashboard in Azure DevOps anzuzeigen. Das Beispiel-Widget auf github veranschaulicht:

  • Rendern von Trendlinien im Zusammenhang mit den Status von Arbeitselementen
  • So fragen Sie ein Dataset ab, wenn ein Benutzer es in der Widget-Konfigurationsansicht konfiguriert.
  • Erstellen und Veröffentlichen des Widgets auf dem Azure DevOps-Marketplace

Mit diesen Informationen können Sie Ihr eigenes Analyse-Widget erstellen.

Ansicht der Konfiguration mit Widget-Vorschau

Anmerkung

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 wird v4.0-preview. Weitere Informationen finden Sie unter OData-API-Versionsverwaltung.

Anmerkung

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 wird v4.0-preview. Weitere Informationen finden Sie unter OData-API-Versionsverwaltung.

Anmerkung

Der Analysedienst ist als Vorschau verfügbar für Azure DevOps Server 2019. Sie können es aktivieren oder installieren für eine Projektsammlung. Power BI-Integration und Zugriff auf den OData-Feed des Analysediensts sind in der Vorschau 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 wird v4.0-preview. Weitere Informationen finden Sie unter OData-API-Versionsverwaltung.

Voraussetzungen

Kategorie Anforderungen
Zugriffsebenen - Projektmitglied.
– Mindestens Basis--Zugriff.
Berechtigungen Standardmäßig verfügen Projektmitglieder über die Berechtigung zum Abfragen von Analysen und Erstellen von Ansichten. Weitere Informationen zu anderen Voraussetzungen für die Dienst- und Featureaktivierung und allgemeine Datenverfolgungsaktivitäten finden Sie unter Berechtigungen und Voraussetzungen für den Zugriff auf Analytics.

Das Beispiel in diesem Artikel enthält ein vorgefertigtes Widget, das grundlagen aus Themen in Dashboards, Diagrammen und Analysen behandelt. Die folgenden Dokumente enthalten weitere Grundlagen zu Details, die in diesem Beispiel veranschaulicht werden:

  1. Erstellen Sie eine Azure DevOps Widget-Erweiterung, verweisen Sie auf das Beispiel für Widget-Erweiterungen
  2. Rendern eines Azure DevOps-Diagrammsteuerelements, Referenz Hinzufügen eines Diagramms
  3. OData-Abfrage aus Analytics

Bereitstellen einer Konfigurationsansicht

  1. Ausführen einfacher Analyseabfragen, die von UI-Steuerelementen zum Konfigurieren einer Ansicht benötigt werden.
  2. Verwalten des Zustands der Konfigurations-Benutzeroberflächemit Aktualisierungen, die auf Benutzeraktionen basieren, sowie mit neuen Daten aus Analytics-Abfragen.
  3. Renderkonfigurations-UI mit Typescript und React.

Rendern von Daten in einem Widget

  1. Ausführen einer vom Benutzer konfigurierten Abfrage als POST Request
  2. Daten aus Analysen interpretieren, um ein Diagramm zu rendern

Nächste Schritte

Um übermäßige Komplexität in der Stichprobe zu vermeiden, haben wir bestimmte Technologien und Praktiken weggelassen, die ein Produktions-Widget sicherlich enthalten sollte. Das Beispiel ui-fabric-react auf GitHub hebt einen Buildprozess hervor, der diese Details veranschaulicht.

  1. JavaScript-Bündelung und Verkleinerung von Inhalten – Die Gruppe kleiner, loser Skriptdateien im Beispiel kann viel schneller geladen werden, wenn sie in eine einzelne Datei kombiniert und minimiert werden.
  2. Fabric UI-Steuerelemente – Fabric UI-Steuerelemente bieten eine umfangreiche Gruppe von Konfigurations-UI-Komponenten für React.