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 deze weer te geven in een dashboard in Azure DevOps. De voorbeeldwidget op github laat het volgende zien:

  • Trendlijnen weergeven die zijn gekoppeld aan werkitemstatussen
  • Een query uitvoeren op een gegevensset, waarna 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 analysewidget 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 de versie. De meest recente ondersteunde versie is v2.0en de meest recente 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 latere 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 tijdens de upgrade installeren.

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

Notitie

De Analytics-service is in preview voor Azure DevOps Server 2019. U kunt deze functie inschakelen of installeren voor een projectverzameling. Power BI-integratie en toegang tot de OData-feed van de Analytics-service zijn in preview. We raden u aan deze te gebruiken en ons feedback te geven.

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

Vereisten

Dit voorbeeld biedt een kant-en-klare widget, die de basisbeginselen van onderwerpen in Dashboards, Grafieken en Analyse behandelt. De volgende documenten bieden meer basisinformatie over details die in dit voorbeeld worden weergegeven:

  1. Een Azure DevOps-widgetextensie maken, verwijzen naar het voorbeeld van widgetextensies
  2. Een Azure DevOps-grafiekbeheer weergeven, verwijzing Een grafiek toevoegen
  3. Query's uitvoeren op OData vanuit Analytics

Een configuratieweergave opgeven

  1. Eenvoudige analysequery's uitvoeren die vereist zijn voor ui-besturingselementen die worden gebruikt voor het configureren van een weergave.
  2. Beheer de gebruikersinterface voor de configuratiestatus, met updates op basis van gebruikersacties en met nieuwe gegevens uit Analytics-query's.
  3. De gebruikersinterface van de configuratie weergeven met Behulp van 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 overmatige complexiteit in de steekproef te voorkomen, hebben we bepaalde technologieën en procedures weggelaten, die zeker in een productiewidget moeten worden opgenomen. Het voorbeeld ui-fabric-react op github markeert een bouwproces waarin deze details worden toegepast.

  1. JavaScript-bundeling en inhoudsminificatie : de set kleine, losse scriptbestanden in het voorbeeld kan veel sneller worden geladen wanneer het wordt gecombineerd tot één bestand en verkleind.
  2. Besturingselementen voor infrastructuurgebruikersinterface: besturingselementen van de infrastructuurinterface bieden een uitgebreide set configuratie-UI-onderdelen voor React.