Creare un report di Power BI con una query OData

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

Con Power BI Desktop è possibile iniziare facilmente a creare report per il progetto in Azure DevOps.

Se Power BI Desktop non è disponibile, è possibile scaricarlo e installarlo gratuitamente.

Seguire la procedura per creare un report in Power BI Desktop che mostra una tendenza giornaliera di bug.

• Creare una query di Power BI
• Creare trasformazioni di Power BI
• Creare un report di tendenza Open Bugs

Prerequisiti

Per creare un report di Power BI, è necessario soddisfare i criteri seguenti:

• È necessario essere membri di un progetto. Se non si ha ancora un progetto, crearne uno. Vedere Iscriversi gratuitamente.
• Se non è stato aggiunto come membro del progetto, viene aggiunto ora. Chiunque abbia accesso al progetto, ad eccezione degli stakeholder, può visualizzare le visualizzazioni di Analisi.
• Impostare l'autorizzazione Visualizza analisi su Consenti. Vedere Concedere le autorizzazioni per accedere ad Analytics.
• Le schede devono essere abilitate. Per riabilitarlo, vedere Attivare o disattivare un servizio Azure DevOps.
• È stato installato l'aggiornamento di ottobre 2018 di Power BI Desktopo versione successiva. È possibile scaricare questa applicazione client dalla pagina di download ufficiale di Power BI Desktop.
• Sono stati rilevati elementi di lavoro per un certo periodo di tempo in cui generare un report di tendenza.

Creare una query di Power BI

Creare una query di Power BI per eseguire il pull dei dati in Power BI come indicato di seguito:

1. Scegliere Recupera dati e quindi Query vuota.

   

2. Nell'editor di Power BI Query scegliere Editor avanzato.

   

3. Verrà visualizzata la finestra Editor avanzato.

   

4. Sostituire il contenuto con la query seguente.

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

   

5. Sostituire i valori all'interno della query di esempio.

   La query di esempio include stringhe che è necessario sostituire con i valori:

   • {organization} - Nome dell'organizzazione
   • {project} - Nome del progetto team. Oppure omettere /{project} completamente, per una query tra progetti
   • {areapath} - Il percorso dell'area. Formato: Project\Level1\Level2
   • {startdate} - Data in cui iniziare il report di tendenza. Formato: AAAA-MM-GG. Esempio: 2022-09-01Z rappresenta 2022-settembre-01. Non racchiudere tra virgolette.

   

6. Scegliere Fine per eseguire la query.

   Se non si è mai connessi all'account, Power BI potrebbe richiedere l'autenticazione. Per altre informazioni, vedere Opzioni di autenticazione client.

Espandere Le colonne Area, Iterazione, AssignedTo

La query restituisce diverse colonne che è necessario espandere prima di poterle usare in Power BI. Qualsiasi entità estratta tramite un'istruzione $expand restituisce un record con potenzialmente diversi campi. È necessario espandere il record per rendere flat l'entità nei relativi campi. Esempi di tali entità sono: AssignedTo, Iteratione Area.

Dopo aver chiuso il Editor avanzato e mentre rimangono nella editor di Power Query, selezionare il pulsante espandi sulle entità da rendere flat.

1. Ad esempio, scegliere il pulsante espandi per Area, selezionare le proprietà da espandere e scegliere OK. Qui, scegliamo AreaName e AreaPath per appiattire. La AreaName proprietà è simile al campo Nome nodo.

   

   Nota

   Le proprietà disponibili da selezionare dipendono dalle proprietà richieste per la restituzione nella query. Se non si specificano proprietà, tutte le proprietà sono disponibili. Per altre informazioni su queste proprietà, vedere i riferimenti ai metadati seguenti: Aree, Iterazioni e Utenti.

2. La tabella contiene ora i campi dell'entità.

   

3. Ripetere i passaggi da 1 a 3 per tutti i campi che rappresentano entità che richiedono l'espansione. Questi vengono visualizzati con Record elencato nella colonna della tabella quando non è espanso.

Rinominare campi e query, quindi Chiudi e applica

Al termine, è possibile scegliere di rinominare le colonne.

1. Fare clic con il pulsante destro del mouse su un'intestazione di colonna e scegliere Rinomina...

   

2. È anche possibile rinominare la query da Query1 predefinita in un valore più significativo.

   

3. Al termine, scegliere Chiudi e applica per salvare la query e tornare a Power BI.

   

Creare il report

Power BI mostra i campi su cui è possibile creare report.

Nota

Nell'esempio seguente si presuppone che nessuno abbia rinominato alcuna colonna.

Per un report semplice, seguire questa procedura:

1. Selezionare Grafico a linee di visualizzazione di Power BI.
2. Aggiungere il campo "DateValue" all'asse
   • Fare clic con il pulsante destro del mouse su "DateValue" e selezionare "DateValue" anziché "Date Hierarchy" (Gerarchia date)
3. Aggiungere il campo "State" alla legenda
4. Aggiungere il campo "Count" ai valori
   • Fare clic con il pulsante destro del mouse sul campo WorkItemId e verificare che Sum sia selezionato

Report di esempio:

Passaggi successivi

Creare un report Apri bug

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