Voorbeeldrapport voor het voortgangsoverzicht van functionaliteiten

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

In dit artikel leest u hoe u een gestapeld staafrapport maakt om de voortgang van functies weer te geven op basis van voltooide onderliggende gebruikersverhalen. In het rapport wordt het percentage voltooid weergegeven door het samenvouwen van verhaalpunten voor een bepaalde set actieve functies. U kunt vergelijkbare voortgangsdiagrammen uit uw backlog bekijken door een roll-upkolom toe te voegen. Zie Voortgang van samenvouwen of totalen weergeven om te leren hoe.

Wanneer u rollup rapporten maakt met Power BI, kunnen er problemen optreden met betrekking tot geneste data in uw datasets. Met name als u probeert een tabel te draaien die kolommen met geneste gegevens bevat, kan dit een foutbericht geven. Zie de sectie over het verwerken van geneste gegevens voor meer informatie.

Vereiste voorwaarden

Voorbeeldqueries

Functievoortgang raadpleegt de WorkItems entiteit om de huidige voortgangsstatus op te halen.

De voortgang van de functie controleren op basis van een gebiedspad

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'Feature' "
            &"and State ne 'Removed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and Descendants/any()"
            &"&$select=WorkItemId,Title,Area,Iteration,AssignedTo,WorkItemType,State,AreaSK"
            &"&$expand=Descendants( "
            &"$apply=filter(WorkItemType eq 'User Story') " 
                &"/groupby((StateCategory), "
                &"aggregate(StoryPoints with sum as TotalStoryPoints)) "
            &")  "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'Feature'
            and State ne 'Removed'
            and startswith(Area/AreaPath,'{areapath}')
            and Descendants/any()
        &$select=WorkItemId,Title,Area,Iteration,AssignedTo,WorkItemType,State,AreaSK
        &$expand=Descendants(
            $apply=filter(WorkItemType eq 'User Story')
                /groupby((StateCategory),
                aggregate(StoryPoints with sum as TotalStoryPoints))
            ) 

Substitutie van tekenreeksen en uitsplitsing van queries

Vervang de volgende tekenreeksen door uw waarden. Voeg de accolades {} niet toe in uw vervanging. Als de naam van uw organisatie bijvoorbeeld Fabrikam is, vervangt u deze {organization}door Fabrikam , niet {Fabrikam}.

• {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. Voorbeeldindeling: Project/Level1/Level2.

Uitsplitsing van queries

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

$filter=endswith(Area/AreaPath,'suffix')
&$select=WorkItemId,Title,WorkItemType,State,Area, Descendants
&$expand=Descendants($select=WorkItemId)

$filter=endswith(Area/AreaPath, 'suffix')and Descendants/any()
&$select=WorkItemId,Title,WorkItemType,State,Area, Descendants
&$expand=Descendants($select=WorkItemId)

De voortgang van de functieontwikkeling voor een team beoordelen

De volgende query is hetzelfde als de query die u eerder hebt gebruikt, maar filtert op teamnaam in plaats van op gebiedspad.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?"
        &"$filter=WorkItemType eq 'Feature' "
            &"and State ne 'Cut' "
            &"and (Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}')) "
            &"and Descendants/any() "
        &"&$select=WorkItemId,Title,WorkItemType,State,AreaSK "
        &"&$expand=Descendants( "
            &"$apply=filter(WorkItemType eq 'User Story') "
                &"/groupby((StateCategory), "
                &"aggregate(StoryPoints with sum as TotalStoryPoints)) "
            &")  "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItems?
        $filter=WorkItemType eq 'Feature'
            and State ne 'Cut'
            and (Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}') or Teams/any(x:x/TeamName eq '{teamname}'))
            and Descendants/any()
        &$select=WorkItemId,Title,WorkItemType,State,AreaSK
        &$expand=Descendants(
            $apply=filter(WorkItemType eq 'User Story')
                /groupby((StateCategory),
                aggregate(StoryPoints with sum as TotalStoryPoints))
            ) 

De gegevens in Power Query-editor transformeren

De query retourneert verschillende kolommen die u moet uitvouwen voordat u ze kunt gebruiken om een rapport te maken. Elke entiteit die u ophaalt met behulp van een OData-instructie $expand retourneert een record met mogelijk meerdere velden. Breid de record uit om de entiteit te detailleren in de velden.

Voer voor het rapport Voortgang van onderdelen de volgende transformaties uit:

• Vouw de Descendants kolom uit in twee kolommen: Descendants.StateCategory en Descendants.TotalStoryPoints.
• Pas de transformatie van de draaikolom op de Descendants.StateCategory kolom toe om afzonderlijke statuscategorieën te scheiden.
• Vervang nulwaarden in alle gedraaide kolommen.
• Voeg een aangepaste kolom toe die het percentage voltooid weergeeft. In de aangepaste kolom worden fouten weergegeven als er null-kolommen zijn in de gepivoteerde status-kolommen.

Zie Transform Analytics-gegevens om Power BI rapporten te genereren voor meer informatie.

Omgaan met geneste gegevens

Voordat u een draaitabelbewerking uitvoert, moet u ervoor zorgen dat uw dataset geen kolommen met geneste gegevens bevat. Volg deze stappen:

1. Geneste kolommen identificeren: controleer uw gegevensset op kolommen die lijsten, records of tabellen in één cel kunnen bevatten.
2. Geneste gegevens vergroten of verwijderen: Verwijder de geneste kolommen of maak ze plat door ze uit te vouwen in afzonderlijke kolommen met behulp van de functie Expand in Power Query.
3. Voer de draaibewerking uit: Nadat u de geneste gegevens hebt opgelost, kunt u doorgaan met de draaibewerking zonder dat er fouten optreden.

Sluit de query en pas uw wijzigingen toe

Wanneer u alle gegevenstransformaties hebt voltooid, selecteert u Sluiten en toepassen in het menu Start . Met deze actie wordt de query opgeslagen en wordt u geretourneerd naar het tabblad Rapport in Power BI.

Het gestapelde staafdiagramrapport maken

1. Selecteer in Power BI Stacked staafdiagram onder Visualisaties.

   

2. Voeg Title toe aan Y-as.

3. Voeg PercentComplete toe aan de X-as, klik met de rechtermuisknop en selecteer Som.

Het voorbeeldrapport wordt weergegeven.

Verwante inhoud

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