Een Power BI-rapport maken met een OData-query

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

Met Power BI Desktop kunt u eenvoudig rapporten maken voor uw project in Azure DevOps.

Als u geen Power BI Desktop hebt, kunt u deze gratis downloaden en installeren.

Volg de stappen voor het maken van een rapport in Power BI Desktop met een dagelijkse trend van fouten.

  • Een Power BI-query maken
  • Power BI-transformaties maken
  • Een trendrapport voor open bugs maken

Vereisten

Als u een Power BI-rapport wilt maken, moet u voldoen aan de volgende criteria:

Een Power BI-query maken

Maak als volgt een Power BI-query om de gegevens in Power BI op te halen:

  1. Kies Gegevens ophalen en vervolgens Lege query.

    Power BI - Blank Query

  2. Kies in de Power BI Query-editor Geavanceerde editor.

    Power BI - Select Advanced Editor

  3. Het venster Geavanceerde editor wordt geopend.

    Power BI - Advanced Editor

  4. Vervang de inhoud door de volgende query.

    let
       Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v4.0-preview/WorkItemSnapshot? "
          $apply=filter(
              WorkItemType eq 'Bug'  
          AND StateCategory ne 'Completed'  
          AND startswith(Area/AreaPath,'{areapath}')  
          AND DateValue ge {startdate} )/
          groupby((DateValue,State,WorkItemType,Area/AreaPath), aggregate($count as Count))  
          &$orderby=DateValue"
         ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
    in
        Source
    

    Screenshot of Power BI, Advanced Editor, Pasted Query.

  5. Vervang uw waarden in de voorbeeldquery.

    De voorbeeldquery bevat tekenreeksen die u moet vervangen door uw waarden:

    • {organization} - Naam van uw organisatie
    • {project} - De naam van uw teamproject. Of laat /{project} deze volledig weg voor een query voor meerdere projecten
    • {areapath} - Uw gebiedspad. Indeling: Project\Level1\Level2
    • {startdate} - De datum waarop uw trendrapport moet worden gestart. Indeling: JJJJ-MM-DDZ. Voorbeeld: 2022-09-01Z vertegenwoordigt 2022-september-01. Plaats niet tussen aanhalingstekens.

    Screenshot of Power BI, Advanced Editor, Replaced Strings in Query.

  6. Kies Gereed om de query uit te voeren.

    Als u nog nooit verbinding hebt gemaakt met uw account, moet u mogelijk worden geverifieerd door Power BI. Zie Opties voor clientverificatie voor meer informatie.

Gebied, Iteratie, AssignedTo-kolommen uitvouwen

De query retourneert verschillende kolommen die u moet uitbreiden voordat u ze kunt gebruiken in Power BI. Elke entiteit die wordt opgehaald met behulp van een $expand instructie retourneert een record met mogelijk meerdere velden. U moet de record uitbreiden om de entiteit plat te maken in de velden. Voorbeelden van dergelijke entiteiten zijn: AssignedTo, Iterationen Area.

Nadat u de Geavanceerde editor hebt gesloten en terwijl u in de Power Query-editor blijft, selecteert u de uitvouwknop op de entiteiten die u wilt platmaken.

  1. Kies bijvoorbeeld de knop Uitvouwen voor Gebied, selecteer de eigenschappen die u wilt uitvouwen en kies OK. Hier kiezen AreaName we en AreaPath om plat te maken. De AreaName eigenschap is vergelijkbaar met het veld Node Name .

    Screenshot of Power BI transform data, Expand AreaPath column.

    Notitie

    De beschikbare eigenschappen die moeten worden geselecteerd, zijn afhankelijk van de eigenschappen die in de query moeten worden geretourneerd. Als u geen eigenschappen opgeeft, zijn alle eigenschappen beschikbaar. Zie de volgende metagegevensverwijzingen: Gebieden, Iteraties en Gebruikers voor meer informatie over deze eigenschappen.

  2. De tabel bevat nu entiteitsvelden.

    Screenshot of expanded Area columns.

  3. Herhaal stap 1 tot en met 3 voor alle velden die entiteiten vertegenwoordigen die moeten worden uitgebreid. Deze worden weergegeven met Record in de tabelkolom wanneer deze niet zijn uitgevouwen.

Naam van velden en query wijzigen en vervolgens sluiten en toepassen

Wanneer u klaar bent, kunt u ervoor kiezen om de naam van kolommen te wijzigen.

  1. Klik met de rechtermuisknop op een kolomkop en selecteer Naam wijzigen...

    Screenshot of Power BI transform data, Rename Columns.

  2. U kunt ook de naam van de query wijzigen van de standaardquery1 in iets zinvoller.

    Screenshot of Power BI transform data, Rename Query.

  3. Als u klaar bent, kiest u Sluiten en toepassen om de query op te slaan en terug te keren naar Power BI.

    Screenshot of Power BI Power Query Editor, Close & Apply.

Het rapport maken

Power BI toont u de velden waarop u kunt rapporteren.

Notitie

In het onderstaande voorbeeld wordt ervan uitgegaan dat niemand de naam van kolommen heeft gewijzigd.

Screenshot of Power BI Visualizations and Fields selections for Bug trends report.

Voor een eenvoudig rapport voert u de volgende stappen uit:

  1. Selecteer lijndiagram voor Power BI-visualisatie.
  2. Het veld DateValue toevoegen aan as
    • Klik met de rechtermuisknop op 'DateValue' en selecteer 'DateValue', in plaats van datumhiërarchie
  3. Voeg het veld 'Staat' toe aan legenda
  4. Het veld 'Aantal' toevoegen aan waarden
    • Klik met de rechtermuisknop op het veld WorkItemId en zorg ervoor dat Som is geselecteerd

Het voorbeeldrapport:

Screenshot of Sample Bug trends line chart report.

Volgende stappen