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 Power BI Desktop niet hebt, downloadt en installeert u deze gratis.

Vereisten

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

• Wees een projectlid. Als u dat niet doet, wordt u nu toegevoegd. Iedereen met toegang tot het project, met uitzondering van belanghebbenden, kan analyseweergaven bekijken.
• Zorg ervoor dat de machtiging View Analytics is ingesteld op Toestaan. Zie Machtigingen verlenen voor analytics-toegang.
• Schakel borden in. Zie Een Azure DevOps-service in- of uitschakelen om boards opnieuw in of uit te schakelen.
• Power BI Desktop- of latere versie van oktober 2018 hebben.
• Werkitems gedurende een bepaalde periode bijhouden waarop een trendrapport moet worden gegenereerd.

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.

   

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

   

3. Het venster Geavanceerde editor wordt geopend.

   

4. Vervang de inhoud door de volgende query:

   let
      The query you provided has a syntax issue due to the placement of double quotes. Specifically, the `$apply` and `$orderby` parameters should be part of the URL string, but they are not correctly concatenated. Here is the corrected version:
   
   

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

1. 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.

   

2. Kies Gereed om de query uit te voeren.

   Voor Power BI moet u zich mogelijk verifiëren. 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 .

   

   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.

   

3. Herhaal stap 1 tot en met 3 voor alle velden die entiteiten vertegenwoordigen die moeten worden uitgebreid. Deze velden 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...

   

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

   

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

   

Het rapport maken

Power BI toont u de velden waarop u kunt rapporteren.

Notitie

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

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

Voorbeeldrapport:

Volgende stappen

Een rapport fouten openen maken

Verwante artikelen:

• Voorbeeldrapporten verkennen met OData-query's
• OData-query's maken voor Analyse
• Verbinding maken met Power BI met behulp van OData-query's
• Raadpleeg metagegevens voor Azure Boards Analytics
• Voorbeeldrapporten en snelzoekindex openen
• Een teamslicer toevoegen aan een bestaand rapport