Delen via


Een analytics-widget maken voor Azure DevOps

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

U kunt uw eigen Analytics-widget maken om weer te geven in een dashboard in Azure DevOps. De voorbeeldwidget op github demonstreert:

  • Trendlijnen weergeven die zijn gekoppeld aan statussen van werkitems
  • Hoe een dataset te bevragen wanneer een gebruiker deze configureert via de configuratieweergave van de widget.
  • De widget bouwen en publiceren naar de Azure DevOps Marketplace

Met deze informatie kunt u uw eigen Analytics-widget maken.

weergave van configuratie met preview van widget

Notitie

De Analytics-service wordt automatisch ingeschakeld en ondersteund in productie voor alle Azure DevOps-services. Power BI-integratie en -toegang tot de OData-feed van de Analytics-service zijn algemeen beschikbaar. We raden u aan deze te gebruiken en ons feedback te geven. Beschikbare gegevens zijn afhankelijk van versie. De meest recente ondersteunde versie is v2.0en de nieuwste preview-versie is v4.0-preview. Zie OData API-versiebeheer voor meer informatie.

Notitie

De Analytics-service wordt automatisch geïnstalleerd en ondersteund in productie voor alle nieuwe projectverzamelingen voor Azure DevOps Server 2020 en nieuwere versies. Power BI-integratie en -toegang tot de OData-feed van de Analytics-service zijn algemeen beschikbaar. We raden u aan deze te gebruiken en ons feedback te geven. Als u een upgrade hebt uitgevoerd van Azure DevOps Server 2019, kunt u de Analytics-service installeren tijdens de upgrade.

Beschikbare gegevens zijn afhankelijk van versie. De meest recente ondersteunde versie is v2.0en de nieuwste preview-versie is v4.0-preview. Zie OData API-versiebeheer voor meer informatie.

Benodigdheden

Categorie Vereisten
Toegangsniveaus - een projectlid.
- Tenminste Basic toegang.
toestemmingen Projectleden zijn standaard gemachtigd om query's uit te voeren op Analytics en weergaven te maken. Zie Machtigingen en vereisten voor toegang tot Analyticsvoor meer informatie over andere vereisten met betrekking tot het inschakelen van services en functies en algemene activiteiten voor het bijhouden van gegevens.

Het voorbeeld in dit artikel bevat een kant-en-klare widget met basisbeginselen van onderwerpen in Dashboards, Grafieken en Analyse. In de volgende documenten vindt u meer informatie over de details die in dit voorbeeld worden weergegeven:

  1. Maak een Azure DevOps Widget-extensie en verwijs naar het voorbeeld van Widget-extensies
  2. Weergave van een Azure DevOps-grafiekcontrole, verwijzen naar voeg een grafiek toe.
  3. Query's uitvoeren op OData vanuit Analytics-

Een configuratieweergave opgeven

  1. Eenvoudige analysequery's uitvoeren vereist voor ui-besturingselementen die worden gebruikt voor het configureren van een weergave.
  2. Beheer de toestand van de configuratie gebruikersinterface, met updates op basis van gebruikersacties en met nieuwe gegevens afkomstig van Analytics-query's.
  3. Rendere gebruikersinterface met Typescript en React.

Gegevens weergeven in een widget

  1. Een door de gebruiker geconfigureerde query uitvoeren als een POST-aanvraag
  2. Gegevens uit analyses interpreteren om een grafiek weer te geven

Volgende stappen

Om overtollige complexiteit in het voorbeeld te voorkomen, hebben we bepaalde technologieën en procedures weggelaten, die een productiewidget zeker moet bevatten. Het ui-fabric-react-voorbeeld op GitHub markeert een buildproces waarin deze details worden uitgevoerd.

  1. JavaScript-bundeling en inhoudsminificatie: de set kleine, losse scriptbestanden in het voorbeeld kan veel sneller worden geladen wanneer deze worden gecombineerd in één bestand en geminimificeerd.
  2. Fabric UI Controls - Fabric UI-besturingselementen bieden een uitgebreide set configuratie-UI-onderdelen voor React.