Creare un report di Power BI con una query OData

  • Articolo

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, scaricarlo e installarlo gratuitamente.

Prerequisiti

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

  • Essere un membro del progetto. In caso contrario, viene aggiunto ora. Chiunque abbia accesso al progetto, ad eccezione degli stakeholder, può visualizzare le visualizzazioni di Analisi.
  • Abilitare o installare Analytics. Per aggiungere estensioni o abilitare il servizio, è necessario essere un proprietario dell'account o un membro del gruppo Project Collection Administrators.
  • Abilitare Boards. Per riabilitare le bacheche, vedere Attivare o disattivare un servizio Azure DevOps.
  • Impostare l'autorizzazione Visualizza analisi su Consenti. Vedere Concedere le autorizzazioni per l'accesso ad Analisi.
  • Disporre dell'aggiornamento di Power BI Desktop di ottobre 2018 o versione successiva.
  • Tenere traccia degli elementi di lavoro per un determinato 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.

    Screenshot che mostra Power BI - Query vuota.

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

    Screenshot che mostra Power BI - Selezionare Editor avanzato.

  3. Verrà visualizzata la finestra Editor avanzato.

    Screenshot che mostra Power BI - Editor avanzato.

  4. Sostituire il contenuto con la query seguente:

    let
   The query you provided has a syntax issue due to the placement of double quotes. Specifically, the `$apply` and `$orderby` parameters should be part of the URL string, but they are not correctly concatenated. Here is the corrected version:


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

Screenshot di Power BI, Editor avanzato, Query incollata.

  1. 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.

    Screenshot di Power BI, Editor avanzato, Stringhe sostituite nella query.

  2. Scegliere Fine per eseguire la query.

    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.

    Screenshot della trasformazione dei dati di Power BI, espandere la colonna AreaPath.

    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 campi di entità.

    Screenshot delle colonne area espanse.

  3. Ripetere i passaggi da 1 a 3 per tutti i campi che rappresentano le entità che devono essere espanse. Questi campi 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...

    Screenshot della trasformazione dei dati di Power BI, Rinomina colonne.

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

    Screenshot della trasformazione dei dati di Power BI, Rinomina query.

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

    Screenshot di Power BI editor di Power Query, Chiudi e applica.

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. Screenshot delle visualizzazioni di Power BI e delle selezioni campi per il report Tendenze dei bug.

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 data)
  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:

Screenshot del report grafico a linee Tendenze bug di esempio.

Passaggi successivi

Creare un report Apri bug