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 Desktop o 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.
- È necessario essere membri di un progetto. Se non si ha ancora un progetto, crearne uno.
- 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.
- Avere abilitato o installato Analytics. Per aggiungere estensioni o abilitare il servizio, è necessario essere un proprietario dell'account o un membro del gruppo Project Collection Administrators.
- Le schede devono essere abilitate. Per riabilitarlo, vedere Attivare o disattivare un servizio Azure DevOps.
- Impostare l'autorizzazione Visualizza analisi su Consenti. Vedere Concedere le autorizzazioni per accedere ad Analytics.
- È stato installato l'aggiornamento di ottobre 2018 di Power BI Desktop o 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:
Scegliere Recupera dati e quindi Query vuota.
Nell'editor di Power BI Query scegliere Editor avanzato.
Verrà visualizzata la finestra Editor avanzato.
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
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.
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
, Iteration
e Area
.
Dopo aver chiuso il Editor avanzato e mentre rimangono nella editor di Power Query, selezionare il pulsante espandi sulle entità da rendere flat.
Ad esempio, scegliere il pulsante espandi per Area, selezionare le proprietà da espandere e scegliere OK. Qui, scegliamo
AreaName
eAreaPath
per appiattire. LaAreaName
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.
La tabella contiene ora i campi dell'entità.
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.
Fare clic con il pulsante destro del mouse su un'intestazione di colonna e scegliere Rinomina...
È anche possibile rinominare la query da Query1 predefinita in un valore più significativo.
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:
- Selezionare Grafico a linee di visualizzazione di Power BI.
- Aggiungere il campo "DateValue" all'asse
- Fare clic con il pulsante destro del mouse su "DateValue" e selezionare "DateValue" anziché "Date Hierarchy" (Gerarchia date)
- Aggiungere il campo "State" alla legenda
- 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
Articoli correlati
- Panoramica dei report di esempio che usano query OData
- Costruire query OData per Analytics
- Connettersi usando Power BI e query 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