Voorbeeldrapporten voor bugs of gebruikersverhalen openen

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

Als u een rapport wilt genereren met geopende bugs of gebruikersverhalen, selecteert u het matrixrapport in Power BI en gebruikt u een query die vergelijkbaar is met de query die in dit artikel is opgegeven. Het rapport dat u genereert, bevat geopende bugs of gebruikersverhalen, onderverdeeld in state en toegewezen aan velden, zoals wordt weergegeven in de volgende afbeelding.

Notitie

In dit artikel wordt ervan uitgegaan dat u overzicht van voorbeeldrapporten leest met behulp van OData-query's en basiskennis hebt van Power BI.

Vereisten

• Toegang: Wees lid van een project met ten minste basistoegang .
• Machtigingen: projectleden zijn standaard gemachtigd om query's uit te voeren op Analytics en weergaven te maken.
• Zie Machtigingen en vereisten voor toegang tot Analyse voor meer informatie over andere vereisten met betrekking tot het inschakelen van services en functies en algemene activiteiten voor het bijhouden van gegevens.

Voorbeeldquery's

Er zijn verschillende query's beschikbaar die bugs of gebruikersverhalen filteren op gebiedspad, iteratiepad of team. Al deze query's geven de WorkItems entiteitsset op wanneer ze huidige en niet historische gegevens retourneren.

Notitie

Als u de beschikbare eigenschappen voor filter- of rapportdoeleinden wilt bepalen, raadpleegt u de naslaginformatie over metagegevens voor Azure Boards. U kunt uw query's filteren of eigenschappen retourneren met behulp van een van de Property waarden onder een EntityType of NavigationPropertyBinding Path waarden die beschikbaar zijn met een EntitySet. Elk EntitySet komt overeen met een EntityType. Raadpleeg voor meer informatie over het gegevenstype van elke waarde de metagegevens die voor de bijbehorende EntityTypewaarde zijn opgegeven.

Fouten gefilterd op gebiedspad

Power BI-query

Kopieer en plak de volgende Power BI-query rechtstreeks in het venster Lege query ophalen>. Zie Overzicht van voorbeeldrapporten met behulp van OData-query's voor meer informatie.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'Bug' "
            &"and StateCategory ne 'Completed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
        &"&$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

OData-query

U kunt de volgende OData-querycode gebruiken om de query te wijzigen of te testen voordat u deze in Power BI gebruikt. Zie Verbinding maken met Power BI- en OData-query's voor meer informatie.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'Bug'
            and StateCategory ne 'Completed'
            and startswith(Area/AreaPath,'{areapath}')
        &$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK
        &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath)

Uitsplitsing van tekenreeksen en query's vervangen

Vervang de volgende tekenreeksen door uw waarden. Neem geen vierkante haken {} op bij uw vervanging. Als de naam van uw organisatie bijvoorbeeld Fabrikam is, vervangt u door {organization} Fabrikam, niet {Fabrikam}.

• {organization} - Naam van uw organisatie
• {project} - De naam van uw teamproject of laat '/{project}' volledig weg voor een query voor meerdere projecten
• {areapath} - Uw gebiedspad. Voorbeeldindeling: Project\Level1\Level2

Uitsplitsing van query's

In de volgende tabel wordt elk deel van de query beschreven.

Queryonderdeel

Beschrijving

$filter=WorkItemType eq 'Bug'

Fouten retourneren.

and StateCategory ne 'Completed'

Items filteren die zijn voltooid. Zie Hoe statussen van werkstroomcategorieën worden gebruikt in achterstanden en borden in Azure Boards voor meer informatie over statuscategorieën.

and startswith(Area/AreaPath,'{areapath}')

En filter werkitems onder een specifiek gebiedspad. Als u wilt filteren op teamnaam, gebruikt u de filterinstructie Teams/any(x:x/TeamName eq '{teamname})'.

&$select=WorkItemId, Title, WorkItemType, State, Priority, Severity, TagNames

Selecteer velden die u wilt retourneren.

&$expand=AssignedTo($select=UserName), Iteration($select=IterationPath), Area($select=AreaPath)

Selecteer uitvouwbare eigenschapsvelden AssignedTo, Iteration. Area

Gebruikersverhalen gefilterd op teams

U kunt query's uitvoeren op openstaande bugs door een of meer teams in plaats van gebiedspad.

Power BI-query

Kopieer en plak de volgende Power BI-query rechtstreeks in het venster Lege query ophalen>. Zie Overzicht van voorbeeldrapporten met behulp van OData-query's voor meer informatie.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'Bug' "
            &"and StateCategory ne 'Completed'' "
            &"and (Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}') "
        &"&$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

OData-query

U kunt de volgende OData-querycode gebruiken om de query te wijzigen of te testen voordat u deze in Power BI gebruikt. Zie Verbinding maken met Power BI- en OData-query's voor meer informatie.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'Bug'
            and StateCategory ne 'Completed'
            and (Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}')
        &$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK
        &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath)

Gebruikersverhalen in een specifiek gebiedspad en iteratiepad

De volgende query ondersteunt het filteren van gebruikersverhalen voor een specifiek gebiedspad en iteratiepad.

Power BI-query

Kopieer en plak de volgende Power BI-query rechtstreeks in het venster Lege query ophalen>. Zie Overzicht van voorbeeldrapporten met behulp van OData-query's voor meer informatie.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'User Story' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and startswith(Iteration/IterationPath,'{iterationpath}') "
        &"&$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK "
        &"&$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath) "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

OData-query

U kunt de volgende OData-querycode gebruiken om de query te wijzigen of te testen voordat u deze in Power BI gebruikt. Zie Verbinding maken met Power BI- en OData-query's voor meer informatie.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'User Story'
            and startswith(Area/AreaPath,'{areapath}')
            and startswith(Iteration/IterationPath,'{iterationpath}')
        &$select=WorkItemId,Title,WorkItemType,State,Priority,Severity,TagNames,AreaSK
        &$expand=AssignedTo($select=UserName),Iteration($select=IterationPath),Area($select=AreaPath)

(Optioneel) Naam van query wijzigen

U kunt de naam van het standaardquerylabel Query1 wijzigen in iets zinvoller. Voer gewoon een nieuwe naam in het deelvenster Queryinstellingen in.

Kolommen uitvouwen in Power Query-editor

De &$expand=AssignedTo($select=UserName), Iteration($select=IterationPath), Area($select=AreaPath) component retourneert records die meerdere velden bevatten. Voordat u het rapport maakt, moet u de record uitbreiden om deze af te vlakken in specifieke velden. In dit geval wilt u de volgende records uitbreiden:

• AssignedTo
• AreaPath
• IterationPath

Zie Transform Analytics-gegevens voor het genereren van Power BI-rapporten voor meer informatie.

(Optioneel) Naam van velden wijzigen

Zodra u de kolommen hebt uitgevouwen, kunt u de naam van een of meer velden wijzigen. U kunt bijvoorbeeld de naam van de kolom AreaPath wijzigen in Area Path. Zie Kolomvelden een andere naam geven.

Sluit de query en pas uw wijzigingen toe

Zodra u al uw gegevenstransformaties hebt voltooid, kiest u Sluiten en toepassen in het menu Start om de query op te slaan en terug te keren naar het tabblad Rapport in Power BI.

Het matrixrapport maken

1. Kies in Power BI het matrixrapport onder Visualisaties.

   

2. Toevoegen Assigned To aan rijen.

3. Toevoegen State aan kolommen.

4. Voeg 1WorkItemId1 toe aan waarden en klik met de rechtermuisknop op 1WorkItemId en zorg ervoor dat Aantal is geselecteerd.

Het voorbeeldrapport wordt weergegeven.

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