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 samengetelde rapporten maakt met Power BI, kunt u problemen tegenkomen met betrekking tot geneste gegevens in uw gegevenssets. Met name als u probeert een tabel te draaien die kolommen met geneste gegevens bevat, kan dit resulteren in een foutbericht. 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. Gebruik geen haken {} in 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} 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 eerder is gebruikt, behalve dat deze wordt gefilterd 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 wordt opgehaald met behulp van een OData $expand instructie retourneert een record met mogelijk meerdere velden. Breid de record uit om de entiteit te detailleren in de velden.

Voor het voortgangsrapport van de functie moet u de volgende transformaties uitvoeren:

• Vouw de Descendants kolom uit in twee kolommen: Descendants.StateCategory en Descendants.TotalStoryPoints
• Toepassen van de Pivot Column-transformatie op de kolom Descendants.StateCategory om afzonderlijke state-categorieë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 gedraaide statuskolommen .

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

Omgaan met geneste gegevens

Voordat u een draaibewerking uitvoert, moet u ervoor zorgen dat uw gegevensset 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 afvlakken of verwijderen: u kunt de geneste kolommen verwijderen of ze afvlakken door ze uit te vouwen tot afzonderlijke kolommen met behulp van de functie 'Uitvouwen' in Power Query.
3. Voer de draaibewerking uit: Zodra u de geneste gegevens hebt geadresseerd, kunt u doorgaan met de draaibewerking zonder fouten tegen te komen.

Sluit de query en pas uw wijzigingen toe

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

Het gestapelde staafdiagramrapport maken

1. Kies in Power BI een gestapeld staafdiagramrapport onder Visualisaties.

   

2. Voeg Title toe aan Y-as.

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

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