Dela via


Skapa en Analytics-widget för Azure DevOps

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

Du kan skapa en egen Analytics-widget som ska visas på en instrumentpanel i Azure DevOps. Exempelwidgeten på github visar:

  • Så här renderar du trendlinjer som är associerade med arbetsobjekttillstånd
  • Så här kör du frågor mot en datauppsättning, vilket en användare konfigurerar via konfigurationsvyn för widgeten
  • Skapa och publicera widgeten på Azure DevOps Marketplace

Med den här informationen kan du skapa en egen Analytics-widget.

Vy över konfiguration med förhandsgranskning av widget

Anteckning

Analytics-tjänsten aktiveras automatiskt och stöds i produktion för alla Azure DevOps-tjänster. Power BI-integrering och åtkomst till OData-flödet för Analystjänsten är allmänt tillgängliga. Vi rekommenderar att du använder den och ger oss feedback. Tillgängliga data är versionsberoende. Den senaste versionen som stöds är v2.0och den senaste förhandsversionen är v4.0-preview. Mer information finns i OData API-versionshantering.

Anteckning

Analytics-tjänsten installeras automatiskt och stöds i produktion för alla nya projektsamlingar för Azure DevOps Server 2020 och senare versioner. Power BI-integrering och åtkomst till OData-flödet för Analystjänsten är allmänt tillgängliga. Vi rekommenderar att du använder den och ger oss feedback. Om du har uppgraderat från Azure DevOps Server 2019 kan du installera Analytics-tjänsten under uppgraderingen.

Tillgängliga data är versionsberoende. Den senaste versionen som stöds är v2.0och den senaste förhandsversionen är v4.0-preview. Mer information finns i OData API-versionshantering.

Anteckning

Analytics-tjänsten är i förhandsversion för Azure DevOps Server 2019. Du kan aktivera eller installera den för en projektsamling. Power BI-integrering och åtkomst till OData-flödet för Analystjänsten finns i förhandsversion. Vi rekommenderar att du använder den och ger oss feedback.

Tillgängliga data är versionsberoende. Den senaste versionen som stöds är v2.0och den senaste förhandsversionen är v4.0-preview. Mer information finns i OData API-versionshantering.

Förutsättningar

Det här exemplet innehåller en färdig widget som täcker grunderna från ämnen i Instrumentpaneler, Diagram och Analys. Följande dokument ger mer grund för information som visas i det här exemplet:

  1. Skapa ett Azure DevOps Widget-tillägg, referera till widgettilläggsexemplet
  2. Rendera en Azure DevOps-diagramkontroll, referera till Lägg till ett diagram
  3. Fråga OData från Analys

Ange en konfigurationsvy

  1. Kör enkla analysfrågor som krävs av gränssnittskontroller som används för att konfigurera en vy.
  2. Hantera tillståndet för konfigurationsgränssnittet, med uppdateringar baserat på användaråtgärder och med nya data från Analytics-frågor.
  3. Rendera konfigurationsgränssnittet med Typescript och React.

Rendera data i en widget

  1. Köra en användar konfigurerad fråga som en POST-begäran
  2. Tolka data från analys för att återge ett diagram

Nästa steg

För att undvika överflödig komplexitet i exemplet utelämnade vi vissa tekniker och metoder, som en produktionswidget säkert bör innehålla. Exemplet ui-fabric-react på github visar en byggprocess som använder den här informationen.

  1. JavaScript-paketering och innehållsminimering – Uppsättningen små, lösa skriptfiler i exemplet kan läsas in mycket snabbare när de kombineras till en enda fil och minimeras.
  2. Gränssnittskontroller för infrastrukturresurser – Kontroller för användargränssnittet i infrastrukturresurser tillhandahåller en omfattande uppsättning konfigurationsgränssnittskomponenter för React.