Report di esempio di tendenze di bug

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

I report sulle tendenze dei bug sono utili per vedere come un team sta chiudendo i bug attivi. Questo articolo illustra come visualizzare il numero di bug in uno stato specifico in un determinato periodo di tempo. L'immagine seguente mostra un esempio di report sulle tendenze dei bug.

Nota

Questo articolo presuppone di avere letto Panoramica dei report di esempio usando query OData e avere una conoscenza di base di Power BI.

Prerequisiti

• Per visualizzare i dati di Analisi ed eseguire query sul servizio, è necessario essere membri di un progetto con accesso basic o superiore. Per impostazione predefinita, a tutti i membri del progetto vengono concesse le autorizzazioni per eseguire query su Analisi e definire le visualizzazioni di Analisi.
• Per altre informazioni sugli altri prerequisiti relativi all'abilitazione di servizi e funzionalità e alle attività generali di rilevamento dei dati, vedere Autorizzazioni e prerequisiti per l'accesso ad Analytics.

Query di esempio

Le query seguenti restituiscono dati dal WorkItemSnapshot set di entità per supportare la generazione di report di tendenza.

Nota

Per determinare le proprietà disponibili a scopo di filtro o report, vedere Informazioni di riferimento sui metadati per Azure Boards. È possibile filtrare le query o restituire proprietà usando uno qualsiasi dei Property valori in un EntityType oggetto o NavigationPropertyBinding Path i valori disponibili con un oggetto EntitySet. Ognuno EntitySet corrisponde a un oggetto EntityType. Per altre informazioni sul tipo di dati di ogni valore, esaminare i metadati forniti per l'oggetto corrispondente EntityType.

Tendenza bug filtrata in base al percorso area

Le query seguenti filtrano i bug in base al percorso dell'area e a una data di inizio.

Query di Power BI

È possibile incollare la query di Power BI elencata di seguito direttamente nella finestra Recupera query vuota dati>. Per altre informazioni, vedere Panoramica dei report di esempio che usano query OData.

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

Query OData

È possibile usare il codice di query OData seguente per modificare o testare la query prima di usarla in Power BI. Per altre informazioni, vedere Connessione usando Power BI e query OData.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? 
        $apply=filter(
            WorkItemType eq 'Bug'
            and State ne 'Closed'
            and startswith(Area/AreaPath,'{areapath}')
            and DateValue ge {startdate} 
            )
        /groupby(
            (DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK),
            aggregate($count as Count)
            )

Stringhe di sostituzione e scomposizione delle query

Sostituire le stringhe seguenti con i valori. Non includere parentesi quadre {} con la sostituzione. Ad esempio, se il nome dell'organizzazione è "Fabrikam", sostituire {organization} con Fabrikam, non {Fabrikam}.

• {organization} - Nome dell'organizzazione
• {project} - Nome del progetto team o omettere completamente "/{project}" per una query tra progetti
• {areapath} - Il percorso dell'area. Formato di esempio: Project\Level1\Level2
• {startdate} - Avviare il report per gli elementi completati in o dopo una data specifica con il formato : YYYY-MM-DDZ. Ad esempio: 2022-04-01Z rappresenta il 2022-aprile-01. Non racchiudere tra virgolette.

Suddivisione delle query

La tabella seguente descrive ogni parte della query.

Parte della query

Descrizione

$apply=filter(

Inizio della clausola dell'istruzione di filtro.

WorkItemType eq 'Bug'

Restituisce bug.

and State ne 'Closed'

Omettere bug in uno stato Chiuso.

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

Restituisce elementi di lavoro in un percorso di area specifico specificato in'{areapath}' . Per filtrare in base al nome del team, usare l'istruzione Teams/any(x:x/TeamName eq '{teamname})'filter .

and DateValue ge {startdate}

Inizio tendenza dopo o dopo la data specificata. Esempio: 2021-04-01Z rappresenta il 2021-aprile-01.

)

Clausola Close filter() .

/groupby(

Clausola Start groupby() .

(DateValue, State, WorkItemType, Priority, Severity, Area/AreaPath, Iteration/IterationPath),

Raggruppa per DateValue, usato per la tendenza e per tutti gli altri campi su cui si desidera creare report.

aggregate($count as Count)

Aggregare conteggiando i bug che corrispondono ai criteri in ogni data.

)

Clausola Close groupby() .

Tendenza di bug filtrata in base a Teams

È possibile eseguire una query per individuare le tendenze di bug in base al nome del team anziché al percorso area.

Query di Power BI

È possibile incollare la query di Power BI elencata di seguito direttamente nella finestra Recupera query vuota dati>. Per altre informazioni, vedere Panoramica dei report di esempio che usano query OData.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"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 DateValue ge {startdate}  "
            &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
            &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Query OData

È possibile usare il codice di query OData seguente per modificare o testare la query prima di usarla in Power BI. Per altre informazioni, vedere Connessione usando Power BI e query OData.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? 
        $apply=filter(
            WorkItemType eq 'Bug'
            and State ne 'Closed'
            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 DateValue ge {startdate} 
            )
        /groupby(
            (DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK),
            aggregate($count as Count)
            )

Tendenza di bug con uno snapshot ogni venerdì

L'uso di uno snapshot settimanale riduce la quantità di dati estratti in Power BI e aumenta le prestazioni delle query.

Query di Power BI

È possibile incollare la query di Power BI elencata di seguito direttamente nella finestra Recupera query vuota dati>. Per altre informazioni, vedere Panoramica dei report di esempio che usano query OData.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and DateValue ge {startdate} "
            &"and Date/DayName eq 'Friday'  "
        &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
        &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Query OData

È possibile usare il codice di query OData seguente per modificare o testare la query prima di usarla in Power BI. Per altre informazioni, vedere Connessione usando Power BI e query OData.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? 
        $apply=filter(
            WorkItemType eq 'Bug'
            and State ne 'Closed'
            and startswith(Area/AreaPath,'{areapath}')
            and DateValue ge {startdate}
            and Date/DayName eq 'Friday' 
        )
        /groupby(
            (DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK),
            aggregate($count as Count)
        )

Tendenza di bug con uno snapshot al primo di ogni mese

L'uso di uno snapshot mensile riduce la quantità di dati estratti in Power BI e aumenta le prestazioni delle query.

Query di Power BI

È possibile incollare la query di Power BI elencata di seguito direttamente nella finestra Recupera query vuota dati>. Per altre informazioni, vedere Panoramica dei report di esempio che usano query OData.

let
   Source = OData.Feed ("https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? "
        &"$apply=filter( "
            &"WorkItemType eq 'Bug' "
            &"and State ne 'Closed' "
            &"and startswith(Area/AreaPath,'{areapath}') "
            &"and DateValue ge {startdate} "
            &"and Date/DayOfMonth eq 1  "
        &") "
        &"/groupby( "
            &"(DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK), "
            &"aggregate($count as Count) "
        &") "
    ,null, [Implementation="2.0",OmitValues = ODataOmitValues.Nulls,ODataVersion = 4]) 
in
    Source

Query OData

È possibile usare il codice di query OData seguente per modificare o testare la query prima di usarla in Power BI. Per altre informazioni, vedere Connessione usando Power BI e query OData.

https://analytics.dev.azure.com/{organization}/{project}/_odata/v3.0-preview/WorkItemSnapshot? 
        $apply=filter(
            WorkItemType eq 'Bug'
            and State ne 'Closed'
            and startswith(Area/AreaPath,'{areapath}')
            and DateValue ge {startdate}
            and Date/DayOfMonth eq 1 
        )
        /groupby(
            (DateValue,State,WorkItemType,Priority,Severity,Area/AreaPath,Iteration/IterationPath,AreaSK),
            aggregate($count as Count)
        )

(Facoltativo) Rinominare la query

È possibile rinominare l'etichetta di query predefinita Query1 in qualcosa di più significativo. È sufficiente immettere un nuovo nome dal riquadro Query Impostazioni.

Espandere le colonne in Power BI

Espandere le Area/AreaPath colonne e Iteration/IterationPath . Espandendo le colonne il record viene appiattito in campi specifici. Per informazioni su come, vedere Trasformare i dati di Analisi per generare report di Power BI.

(Facoltativo) Rinominare i campi

Dopo aver espanso le colonne, è possibile rinominare uno o più campi. Ad esempio, è possibile rinominare la colonna AreaPath in Area Path. Per informazioni su come, vedere Rinominare i campi delle colonne.

Chiudere la query e applicare le modifiche

Dopo aver completato tutte le trasformazioni dei dati, scegliere Chiudi e applica dal menu Home per salvare la query e tornare alla scheda Report in Power BI.

Creare il report Grafico a linee

1. In Power BI scegliere il report Grafico a linee in Visualizzazioni.

   

2. Aggiungere DateValue" all'asse X e fare clic con il pulsante destro del mouse DateValue e scegliere DateValue anziché Date Hierarchy.

3. Aggiungi Count all'asse Y e fai clic con il pulsante destro del mouse Count e verifica che Sum sia selezionato.

4. Aggiungi State alla legenda.

Viene visualizzato il report di esempio.

Modificare gli oggetti visivi in formato report

• Per modificare gli elementi di formato del report, scegliere l'icona Formatta l'oggetto visivo (pennello) e modificare una o più impostazioni disponibili. Ad esempio, è possibile modificare i colori della linea utilizzati nel grafico di tendenza.

  

Per altre informazioni, vedere Introduzione al riquadro di formattazione.

Articoli correlati

• Panoramica dei report di esempio che usano query OData
• Costruire query OData per Analytics
• Connessione con le query di Power BI e OData
• Informazioni di riferimento sui metadati per Analisi di Azure Boards
• Report di esempio e indice di riferimento rapido
• Aggiungere un filtro dei dati team a un report esistente