Condividi tramite


Connettere Analisi con Power BI Data Connector

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

Questo articolo illustra come stabilire una connessione senza problemi tra Power BI e Azure DevOps usando Power BI Data Connector. È possibile usare questa integrazione per estrarre informazioni dettagliate preziose dai dati di Azure DevOps e creare report accattivanti all'interno di Power BI. Power BI Data Connector usa le visualizzazioni di Analisi.

Importante

Le visualizzazioni di Analisi supportano solo i dati di Azure Boards (elementi di lavoro). Le viste di analisi non supportano altri tipi di dati, ad esempio le pipeline. Le viste forniscono un elenco semplice di elementi di lavoro e non supportano le gerarchie degli elementi di lavoro. A questo punto, non sono previsti piani per aggiornare il connettore per supportare altri tipi di dati. Per informazioni su altri approcci, vedere Informazioni sull'integrazione di Power BI.

Prerequisiti

Categoria Requisiti
Livelli di accesso - Membro del progetto
Almeno l'accesso di base
Autorizzazioni Autorizzazioni di analisi. Se si è membri del gruppo Collaboratori per il progetto, si dispone dell'autorizzazione.
Strumenti - abilitata per Azure Boards
- Power BI Desktop
Attività - Familiarità con Che cos'è l'analisi e la base di conoscenza degli articoli di Power BI
- Visualizzazione analisi da usare in un report di Power BI
Categoria Requisiti
Livelli di accesso - Membro del progetto
Almeno l'accesso di base
Autorizzazioni Autorizzazioni di analisi. Se si è membri del gruppo Collaboratori per il progetto, si dispone dell'autorizzazione.
Strumenti - Analisi installata e abilitata. I proprietari dell'account o i membri del gruppo Amministratori della raccolta progetti possono aggiungere estensioni o abilitare il servizio.
- Azure Boards abilitato.
- Power BI Desktop.
Attività - Familiarità con Che cos'è l'analisi e la base di conoscenza degli articoli di Power BI
- Visualizzazione analisi da usare in un report di Power BI

Importante

Azure DevOps non supporta l'autenticazione delle credenziali alternative. Se si usano ancora credenziali alternative, è consigliabile passare a un metodo di autenticazione più sicuro.

Connettersi a una visualizzazione di Analisi

Seguire questa procedura per connettersi a una visualizzazione di Analisi:

  1. Apri Power BI Desktop.

  2. Accedere al servizio. L'accesso per la prima volta richiede l'accesso e l'autenticazione delle credenziali. Power BI Desktop salva le credenziali, quindi è necessario eseguire l'accesso una sola volta.

    Nota

    Azure DevOps non supporta scenari tra tenant che usano Open Authorization (OAuth). Invece, utilizzare principali di servizio e identità gestite.

  3. Selezionare Connetti.

    Screenshot che mostra la finestra di dialogo Connessione a Power BI con un messaggio relativo all'accesso e al pulsante Connetti evidenziato.

  4. Selezionare Ottieni dati>Servizi Online, e quindi selezionare Azure DevOps (solo Boards) per i servizi cloud o Azure DevOps Server (solo Boards) per un server locale. Selezionare Connetti. Le viste di analisi supportano le query solo sugli elementi di lavoro e sui test case.

    Screenshot di Power BI con Recupera dati, Online Services e i servizi Azure DevOps evidenziati.

  5. Specificare i parametri di base per connettersi ai dati.

    Screenshot della finestra di dialogo Azure DevOps (solo Boards). I campi Progetto organizzazione e team sono evidenziati.

    Screenshot della finestra di dialogo Azure DevOps Server (solo Boards). I campi URL della raccolta e Progetto del team e il pulsante OK sono evidenziati.

    • URL raccolta: immettere l'URL in cui è ospitata l'istanza di Azure DevOps Server. Un URL di esempio è https://fabrikam-server/AzureDevOpsServer/fabrikam-collection.
    • Progetto team: immettere solo il nome del progetto. Ad esempio, immettere Fabrikam-Fiber se l'URL dell'istanza di Azure DevOps Server è https://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber.

    Importante

    Non confondere il nome del team con il nome del progetto, che è un errore comune. Ad esempio, se l'URL usato è https://fabrikam-server/AzureDevOpsServer/fabrikam-collection/Fabrikam-Fiber-Git/Device, Fabrikam-Fiber-Git è il nome del progetto e Device è il nome del team.

    Dopo l'accesso, Power BI verifica che le credenziali abbiano le autorizzazioni necessarie per accedere al progetto specificato. Se si verificano errori, vedere le domande frequenti per le soluzioni ai problemi comuni.

Selezionare la visualizzazione Analisi

Seguire questa procedura per selezionare la visualizzazione Analisi:

  1. Espandere Visualizzazioni condivise. Il connettore dati presenta un elenco delle visualizzazioni di Analisi disponibili. Ogni visualizzazione rappresenta un set di dati di cui è possibile eseguire il pull in Power BI. È anche possibile creare visualizzazioni di Analisi personalizzate.

    L'immagine seguente mostra le visualizzazioni predefinite di Analytics. L'elenco di visualizzazioni può variare in base al modello di processo usato per creare il progetto. Tutte le visualizzazioni elencate, ad eccezione delle visualizzazioni aggiunte a Today, forniscono dati cronologici sulle tendenze.

    Screenshot della finestra di dialogo Strumento di navigazione. La cartella Visualizzazioni condivise è evidenziata ed espansa, con diverse visualizzazioni predefinite visibili.

  2. Selezionare la visualizzazione Elementi di lavoro - Ultimi 30 giorni e attendere il caricamento dell'anteprima. Questa visualizzazione usa un filtro per visualizzare gli ultimi 30 giorni di cronologia per tutti gli elementi di lavoro nel progetto.

    Nota

    Se verifichi la visualizzazione quando la crei, la visualizzazione deve essere caricata. Se la visualizzazione non viene caricata, è molto probabile che il set di dati sia troppo grande. Tornare alla pagina Visualizzazioni analisi nel portale Web e aprire la visualizzazione per la modifica. Modificare i filtri per ridurre le dimensioni del set di dati.

    Screenshot della finestra di dialogo Strumento di navigazione. La visualizzazione Elementi di lavoro - Ultimi 30 giorni è selezionata e evidenziata e la relativa anteprima è visibile.

    Nota

    • L'anteprima visualizzata per qualsiasi visualizzazione selezionata nello strumento di navigazione può essere troncata a seconda del numero di campi selezionati e delle dimensioni del set di dati. I dati vengono troncati solo per l'anteprima e non influiscono sull'aggiornamento completo dei dati.
    • Le viste di analisi non applicano filtri definiti tramite Power BI nel server. Tutti i filtri applicati in Power BI limitano i dati visualizzati agli utenti finali, ma non riducono la quantità di dati recuperati da Analytics. Se il filtro è destinato a ridurre le dimensioni del set di dati, applicarlo personalizzando la visualizzazione.
  3. Selezionare la casella di controllo accanto alla visualizzazione Storie - Ultimi 30 giorni e quindi selezionare Carica. Attendere il caricamento dei dati. Monitora il progresso attraverso i messaggi di stato visualizzati sotto il nome della tabella. Se si verificano errori, vedere la sezione Domande frequenti per le soluzioni ai problemi comuni.

    Screenshot della finestra Carica per la visualizzazione Storie - Ultimi 30 giorni. Sono visibili un anello di stato parziale e un messaggio di valutazione.

  4. Esaminare il modello di dati. Durante il caricamento del modello, esaminare la progettazione del set di dati per Power BI Data Connector.

Creare un report

Al termine dell'operazione di caricamento, è possibile esplorare i dati e creare report personalizzati. Per esempi di report comuni, vedere Report di esempio basati sulle visualizzazioni di Analisi.

Screenshot che mostra la visualizzazione report di Power BI Desktop.

Domande frequenti

In questa sezione è possibile trovare le risposte alle domande comuni sui messaggi di errore di Power BI Data Connector e Analytics.

D: Come leggere i messaggi di errore provenienti dal connettore?

Un: È possibile che si verifichi un problema durante la lettura dei messaggi di errore provenienti dal connettore perché in genere contengono informazioni contestuali aggiuntive. Se l'operazione di caricamento non riesce, il messaggio inizia con "Impossibile salvare le modifiche nel server". Se viene visualizzato questo messaggio, cercare [DataSource.Error] all'interno del testo del messaggio per trovare il motivo dell'errore e i passaggi suggeriti.

L'esempio seguente mostra un messaggio di errore restituito dal connettore. Le parti più importanti sono le affermazioni sul fatto che il risultato della query supera le dimensioni massime e il suggerimento di ridurre il numero di record applicando più filtri.

Screenshot che mostra un messaggio di errore relativo al risultato della query che supera le dimensioni massime, con informazioni aggiuntive.

D: Ricerca per categorie risolvere il messaggio "Il risultato della query supera le dimensioni massime. Si prega di ridurre il numero di record applicando filtri aggiuntivi. (Errore)

Un: Se il numero di record recuperati da Analytics supera 250.000, viene visualizzato l'errore seguente:

"Impossibile salvare le modifiche apportate al server. Errore restituito: 'OLE DB o errore ODBC: [DataSource.Error] Visual Studio Team Services: Richiesta fallita: Il server remoto ha restituito un errore: (400) Richiesta non valida. Il risultato della query supera le dimensioni massime. Ridurre il numero di record applicando filtri aggiuntivi"."

Questo errore si verifica in genere quando il progetto ha un numero elevato di elementi di lavoro. Ridurre le dimensioni del set di dati personalizzando la vista. Eseguire questo passaggio prima di usare la visualizzazione in Power BI.

Screenshot che mostra un messaggio di errore relativo al risultato della query che supera le dimensioni massime.

D: Come si risolve un errore relativo all'utente che non è autorizzato?

Un: Questo errore potrebbe verificarsi se si tenta di accedere a un progetto per cui non si dispone delle autorizzazioni. Potrebbe essere visualizzato anche se Power BI non riconosce le credenziali. Per controllare i tuoi permessi, vedere Impostare i permessi per accedere ad Analytics e alle viste Analytics. Se il problema riguarda le credenziali, rivolgersi all'amministratore per risolvere il problema. Per altre informazioni, vedere Sicurezza di Power BI, autenticazione utente e Risoluzione dei problemi di accesso per Power BI.

Screenshot che mostra un errore relativo a un tentativo di autenticazione non riuscito.

Nota

Power BI usa Microsoft Entra ID per autenticare gli utenti che accedono al servizio Power BI. A sua volta, Power BI usa le credenziali di accesso di Power BI ogni volta che un utente tenta di accedere alle risorse che richiedono l'autenticazione. Gli utenti accedono al servizio Power BI usando l'indirizzo di posta elettronica usato per stabilire l'account Power BI. Power BI usa il messaggio di posta elettronica di accesso come nome utente effettivo, che viene passato alle risorse ogni volta che un utente tenta di connettersi ai dati. Il nome utente effettivo viene quindi mappato a un principal name utente e viene associato all'account di dominio Windows corrispondente, su cui viene applicata l'autenticazione.

D: Ricerca per categorie risolvere l'errore "Accesso alla risorsa non consentita"?

A: Questo errore potrebbe verificarsi se si ha accesso a un progetto specifico, ma non si dispone dell'autorizzazione Visualizza analisi. Collaborare con l'amministratore del progetto per ottenere questa autorizzazione. Per ulteriori informazioni sul modello di sicurezza, consultare Configurare le autorizzazioni per accedere ad Analytics e alle viste di Analytics.

Screenshot che mostra un messaggio di errore relativo all'accesso alla risorsa non consentita.

D: Come si risolve l'errore "Project 'X' does not exist or you do not have permissions to access it" (Progetto 'X' non esiste o non si dispone delle autorizzazioni per accedervi)

A: Questo errore indica che il valore inserito per il progetto non corrisponde a nessun progetto. Un errore comune che gli utenti commettono consiste nel confondere il nome del progetto con un nome del team.

Ad esempio, se l'URL usato è https://dev.azure.com/fabrikam-fiber-inc/Fabrikam-Fiber-Git/Device, il nome del progetto è Fabrikam-Fiber-Git. È necessario immettere questo valore come parametro di progetto da usare per la connessione ai dati. Device è il nome della squadra.

Screenshot che mostra il messaggio di errore visualizzato quando un progetto non esiste o quando vengono fornite autorizzazioni insufficienti per accedervi.