Condividi tramite

Aprire i report di esempio di bug o storie utente

  • Articolo

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

Per generare un report che elenca bug aperti o storie utente, selezionare il report Matrice in Power BI e usare una query simile a quella fornita in questo articolo. Il report generato elenca i bug aperti o le storie utente suddivise in base ai campi State e Assigned To , come illustrato nell'immagine seguente.

Screenshot del report della matrice di esempio dei bug aperti.

Nota

Questo articolo presuppone che si possa leggere Panoramica dei report di esempio usando le query OData e avere una conoscenza di base di Power BI.

Categoria Requisiti
Livelli di accesso - membro del gruppo di progetto.
- Accesso almeno di livello di base.
Autorizzazioni Per impostazione predefinita, i membri del progetto dispongono dell'autorizzazione per eseguire query su Analisi e creare viste. 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.

Esempi di query

Vengono fornite diverse query che filtrano bug o storie utente in base al percorso dell'area, al percorso di iterazione o al team. Tutte queste query specificano il WorkItems set di entità perché restituiscono dati correnti e non cronologici.

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 le proprietà utilizzando uno qualsiasi dei valori Property sotto un EntityType o i valori NavigationPropertyBinding Path disponibili con un 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.

Bug filtrati in base al percorso dell'area

Copia e incolla la seguente query di Power BI direttamente nella finestra Recupera dati>Query vuota. 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/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

Stringhe di sostituzione e scomposizione delle query

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

  • {organization} - Nome dell'organizzazione
  • {project} - Nome del progetto del team o omettere completamente "/{project}" per confrontare più progetti
  • {areapath} - Il tuo percorso dell'area. Formato di esempio: Project\Level1\Level2

Suddivisione delle query

La tabella seguente descrive ogni parte della query.

Parte di ricerca

Descrizione

$filter=WorkItemType eq 'Bug'

Restituisce bug.

and StateCategory ne 'Completed'

Filtrare gli elementi completati. Per ulteriori informazioni sulle categorie di stato, consultare How workflow category states are used in Azure Boards backlogs and boards.

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

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

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

Selezionare i campi da restituire.

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

Selezionare campi AssignedTodelle proprietà espandibili , Iteration, Area.

Storie degli utenti filtrate per team

È possibile cercare i bug aperti da uno o più team anziché in base al Percorso area.

Copia e incolla la seguente query di Power BI direttamente nella finestra Recupera dati>Query vuota. 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/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

Storie utente in un percorso di area specifico e un percorso di iterazione specifico

La query seguente supporta il filtro delle storie utente per un percorso di area e un percorso di iterazione specifici.

Copiare e incollare la seguente query di Power BI direttamente nella finestra Recupera datiQuery vuota. 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/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

(Facoltativo) Rinominare la query

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

Screenshot delle opzioni del menu query di Power BI, rinominare la query.

Espandi le colonne nell'Editor di Power Query

La &$expand=AssignedTo($select=UserName), Iteration($select=IterationPath), Area($select=AreaPath) clausola restituisce record che contengono diversi campi. Prima di creare il report, è necessario espandere il record per trasformarlo in determinati campi. In questa istanza è necessario espandere i record seguenti:

  • AssignedTo
  • AreaPath
  • IterationPath

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.

Screenshot dell'opzione Chiudi e applica nell'editor di Power Query.

Creare il report della matrice

  1. In Power BI scegliere il report Matrice in Visualizzazioni.

    Screenshot delle visualizzazioni di Power BI e delle selezioni di campi per il report sui bug aperti.

  2. Aggiungi Assigned To a Righe.

  3. Aggiungi State a Colonne.

  4. Aggiungere 1WorkItemId1 a Valori e fare clic con il pulsante destro del mouse su 1WorkItemId' e verificare che Count sia selezionato.

Viene visualizzato il report di esempio.

Screenshot del report di esempio della matrice di Open Bugs.