Condividi tramite

Creare report Power BI per visualizzare i dati di Dynamics 365 Business Central

  • Articolo

È possibile rendere disponibili i dati di Dynamics 365 Business Central come origine di dati in Power BI Desktop e sviluppare report efficaci sullo stato dell'attività.

Questo articolo descrive come iniziare a utilizzare Power BI Desktop per creare report che visualizzano i dati di Dynamics 365 Business Central. Dopo aver creato i report, è possibile pubblicarli nel servizio Power BI o condividerli con tutti gli utenti dell'organizzazione. Quando i report sono nel servizio Power BI, gli utenti configurati per il suo utilizzo possono visualizzare i report in Dynamics 365 Business Central.

Preparazione

Nota

Potresti ottenere i dati di varie società in un unico report con i servizi Web OData. Tuttavia, a partire dal secondo ciclo di rilascio 2021 di Business Central, è supportato solo ODataV4. ODataV4 non esporta dati da più società. La funzione $expand in Power BI che potrebbe essere un'alternativa per creare un report per più società, non può essere utilizzata. Crea una colonna con il nome della società ma non la popola con i dati della società dopo un aggiornamento.

Aggiungere Business Central come origine dati in Power BI Desktop

La prima attività della creazione di report è aggiungere Business Central come origine dati in Power BI Desktop. Una volta connesso, è possibile iniziare a creare il report.

  1. Avviare Power BI Desktop.

  2. Selezionare Ottieni dati.

    Se Ottieni dati non è visibile, selezionare il menu File, quindi Ottieni dati.

  3. Nella pagina Ottieni dati selezionare Servizi online.

  4. Nel riquadro Servizi online eseguire una delle seguenti operazioni:

    • Per connettersi a Business Central Online, selezionare Dynamics 365 Business Central, quindi Connetti.

  5. Accedi a Business Central (solo una tantum).

    Se non hai mai effettuato l'accesso a Business Central da Power BI Desktop, ti viene chiesto di accedere.

    • Per Business Central Online, seleziona Accedi, quindi scegli l'account pertinente. Utilizza lo stesso account utilizzato per accedere a Business Central. Al termine, seleziona Connetti.

    Nota

    Una volta eseguita la connessione a Business Central, non ti verrà richiesto di eseguire di nuovo l'accesso. Come posso modificare o cancellare l'account che sto utilizzando attualmente per connettermi a Business Central da Power BI Desktop?

  6. Una volta connesso, Power BI contatta il servizio Business Central. La finestra Navigatore visualizza le origini dati disponibili per la creazione di report. Seleziona una cartella per espanderla e vedere le origini dati disponibili.

    Le origini dati indicano tutti i servizi Web e le pagine API pubblicati per Business Central, raggruppate per ambienti e società. Con Business Central online, lo strumento di navigazione ha la seguente struttura:

    • Nome ambiente
      • Nome società

        • API avanzate

          Questa cartella elenca le API avanzate pubblicate da Microsoft, come le API di automazione Business Central e le API pubblicate da altre organizzazioni (queste API sono denominate API personalizzate). Le API personalizzate sono ulteriormente raggruppate in cartelle secondo le proprietà APIPublisher/APIGroup del codice sorgente della pagina API.

        • API standard v2.0

          Questa cartella elenca le API di dati esposte nell'API Business Central V2.0. Queste API possono essere utilizzate per leggere i dati dal database di Business Central, ad esempio l'anagrafica (cliente, fornitore, articolo e così via), le transazioni (movimenti contabilità generale, i movimenti clienti e così via) o i dati di impostazione (dimensioni, metodi di pagamento, unità di misura e così via).

        • Servizi Web (legacy)

          Questa cartella elenca le pagine, le codeunit e le query pubblicate come servizi Web in Business Central. Si sconsiglia di utilizzare questo metodo legacy per la lettura dei dati da Business Central. Ti consigliamo invece di utilizzare le API.

  7. Seleziona una o più origini dati che vuoi aggiungere al modello dati quindi scegli il pulsante Carica.

  8. Se in seguito vuoi aggiungere altri dati di Business Central, puoi ripetere i passaggi precedenti.

Dopo che i dati sono stati caricati puoi vederli nel riquadro di spostamento destro nella pagina. A questo punto, è stata stabilita la connessione ai dati di Business Central e puoi iniziare a creare il tuo report Power BI.

Gratifica

Per ulteriori informazioni sull'uso di Power BI Desktop, vedere Introduzione a Power BI Desktop.

Creazione di report accessibili

È importante rendere i tuoi report utilizzabili per il maggior numero di persone possibile. Prova a progettare report in modo che non richiedano adattamenti speciali per soddisfare esigenze specifiche di utenti diversi. Assicurati che il design consenta agli utenti di sfruttare le tecnologie per l'accessibilità, come le utilità per la lettura dello schermo. Power BI include varie funzioni di accessibilità, strumenti e linee guida per aiutarti. Per altre informazioni, vai a Progettare report Power BI per l'accessibilità nella documentazione di Power BI.

Creazione di report per visualizzare i dati associati a un elenco in Business Central

È possibile creare report che vengono visualizzati in un riquadro Dettaglio informazioni in una pagina di elenco Business Central e modificarli quando vengono selezionate righe diverse nell'elenco. La creazione di questi report è simile ad altri report, tranne che per alcune cose che è necessario eseguire per assicurarsi che i report vengano visualizzati come previsto. Per altre informazioni, vai a Creazione dei report Power BI per la visualizzazione dei dati di elenco in Business Central.

Utilizzo del tema del report Business Central (opzionale)

Prima di creare il report, è consigliabile scaricare e importare il file del tema Business Central. Il file del tema crea una tavolozza dei colori in modo da creare report con lo stesso stile cromatico delle app Business Central senza dover definire i colori personalizzati per ogni elemento grafico.

Nota

Questa attività è facoltativa. È sempre possibile creare i report e quindi scaricare e applicare il modello di stile in un secondo momento.

Scaricare il tema

Il file del tema è disponibile come file json nella raccolta dei temi di Microsoft Power BI Community. Per scaricare il file del tema, procedere nel seguente modo:

  1. Andare alla raccolta dei temi di Microsoft Power BI Community per Microsoft Dynamics 365 Business Central.
  2. Selezionare l'allegato Microsoft Dynamics Business Central.json del download.

Importare il tema in un report

Dopo aver scaricato il tema del report Business Central è possibile importarlo nei report. Per importare il tema, selezionare Visualizza>Temi>Cerca temi. Per ulteriori informazioni, vedi Power BI Desktop - Importare temi di report personalizzati.

Pubblicare i report

Dopo aver creato o modificato un report puoi pubblicarlo nel servizio Power BI e condividerlo anche con altre persone nell'organizzazione. Dopo aver pubblicato un report, questo è disponibile in Business Central. Il report diventa anche disponibile per la selezione in Business Central.

Per pubblicare un report, selezionare Pubblica nella scheda Home della barra multifunzione o dal menu File. Se è stato effettuato l'accesso al servizio Power BI il report viene pubblicato in questo servizio. In caso contrario, verrà richiesto di accedere.

Distribuire o condividere un report

Esistono due metodi per condividere i report:

  • Condividere un report dal servizio Power BI (scelta consigliata)

    Se hai una licenza Power BI Pro o ugtilizzi la capacità Power BI Premium, puoi condividere il report con altre persone direttamente dal servizio Power BI. Per altre informazioni, vai a Power BI - Condividere una dashboard o un report.

  • Distribuire report come file .pbix.

    I report vengono archiviati sul computer come file .pbix. È possibile distribuire il file .pbix agli utenti, come qualsiasi altro file. Quindi, le persone con cui hai condiviso il file possono caricarlo sul loro servizio Power BI. Per altre informazioni, vedi Caricare report dai file

    Nota

    La distribuzione dei report in questo modo comporta che l'aggiornamento dei dati per i report venga eseguito individualmente da ciascun utente. Questa situazione potrebbe avere un impatto sulle prestazioni di Business Central.

Come sviluppare report Power BI interaziendali o interambientali

Gli endpoint API Business Central hanno tutti il prefisso https://api.businesscentral.dynamics.com/v2.0/<environment_name>/api/v2.0 seguito da /companies({company_id})/accounts({id}) (qui usiamo l'API accounts come illustrazione). Puoi utilizzare questa struttura per creare query PowerQuery che caricano dati per più società o più ambienti se l'utente che sta leggendo i dati può accedervi.

Per impostare una query per caricare dati per più società, attieniti alla seguente procedura:

  1. Prendi la query PowerQuery che carica i dati per una singola società. Convertila in una funzione Power Query personalizzata che accetta come parametri l'ID società (o forse il nome dell'ambiente). Per saperne di più, vai a Utilizzo delle funzioni Power Query personalizzate.
  2. Ora utilizza la nuova funzione personalizzata in una query PowerQuery, in cui mappi la funzione su un elenco di società e quindi unisci i set di dati utilizzando la funzione Table.Combine di Power Query.

Avanzate: personalizza la lingua, il timeout, la replica del database o le dimensioni della pagina per l'origine dati di Business Central

Il connettore Power BI per Business Central supporta diverse proprietà avanzate per connettersi a un'origine dati Business Central che puoi impostare nelle tue query Power Query. Nella seguente tabella vengono illustrati i parametri.

Parametro Descrizione Predefinito Ulteriori informazioni in
AcceptLanguage Questo parametro consente di specificare le lingue preferite per le risposte, in modo che gli utenti ricevano messaggi e stringhe traducibili nella lingua desiderata. Consente di impostare la lingua in cui viene eseguita la sessione dell'API di Business Central. Influisce sulla lingua dei messaggi di errore, sui valori formattati in AL e su altri valori che dipendono dalla lingua o dalla cultura.

L'impostazione di questo parametro migliora la soddisfazione dell'utente e rende i dati più accessibili e pertinenti.		 non specificato Utilizzare i valori locali nei report Power BI multilingue.
ODataMaxPageSize Questo parametro limita il numero di entità per pagina dei risultati, consentendo maggiore flessibilità quando ci si connette a set di dati di grandi dimensioni o si utilizzano query complesse. Imposta il numero massimo di record da restituire per ogni pagina quando si chiama un'API. Ad esempio, se la tabella Clienti contiene 13.000 record e ODataMaxPageSize è impostato su 5.000, Power BI effettua 3 chiamate API per ottenere i clienti. La prima chiamata ottiene 5.000 record, la successiva ne ottiene altri 5.000 e l'ultima chiamata ottiene i restanti 3.000. Questa opzione non può essere superiore alla dimensione massima della pagina applicata da Business Central, che è 20.000.

L'impostazione di questo parametro garantisce un recupero dei dati efficiente e reattivo, consentendo di ottenere informazioni e prendere decisioni più rapidamente. Non è possibile superare la dimensione massima della pagina definita nel servizio.		 5000 Proprietà ODataPreferenceHeader.MaxPageSize
Timeout Questo parametro definisce la durata massima di una richiesta prima dell'annullamento. Imposta il timeout per ogni singola chiamata API a Business Central. Il suo valore non può superare il timeout applicato al servizio Business Central, che è attualmente di 10 minuti (00:10:00).

L'impostazione di questo parametro aiuta a gestire efficacemente le risorse di sistema e impedisce che le query di lunga durata influiscano sulle prestazioni complessive del sistema. Gli utenti riscontrano ritardi e interruzioni minimi, garantendo un flusso di lavoro più fluido.		 00:08:00 Feed OData
UseReadOnlyReplica Questo parametro determina se le richieste sono destinate al database primario o a una replica di sola lettura. Scaricando le operazioni di lettura dal database primario è possibile migliorare notevolmente le prestazioni.

Impostando questa proprietà si ottiene un recupero più rapido dei dati e una migliore stabilità del sistema, soprattutto durante i periodi di picco di utilizzo.		 true

Configura i parametri avanzati

  1. Avviare Power BI Desktop.

  2. Completa il passaggio più adatto allo scenario:

    1. Seleziona File>Apri.
    2. Individua e seleziona il report (.pbix).
    3. Nella barra multifunzione, seleziona Trasforma dati per aprire l'editor Power Query.

  1. In Editor di Power Query, seleziona Editor avanzato dalla barra multifunzione.

  2. Nell'Editor avanzato, individua la riga che inizia con Source =:

    Source = Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, null),

  3. Nella riga, sostituisci il quarto parametro di Dynamics365BusinessCentral.ApiContentsWithOptions con un elenco separato da virgole di proprietà e valori che desideri impostare, ad esempio:

    Source = Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, Dynamics365BusinessCentral.ApiContentsWithOptions(null, null, null, [UseReadOnlyReplica = true, Timeout = Duration.From("00:07:00"), ODataMaxPageSize = 10000, AcceptLanguage = "it-it"])

  4. Seleziona Fatto per chiudere l'Editor avanzato.

  5. Seleziona Chiudi e applica per salvare le modifiche e chiudere l'editor Power Query.

Risolvere i problemi

Errore "Expression.Error: l'ambiente 'Produzione' non esiste." quando si specifica un ambiente Business Central

APPLICABILE A: Business Central Online

Quando ti connetti a Business Central Online da Power BI o quando installi un'app Power BI Desktop da Microsoft AppSource che utilizza i dati di Business Central, potrebbe essere necessario immettere l'ambiente Business Central a cui desideri connetterti.

Se viene visualizzato un errore simile a "Expression.Error: l'ambiente 'Production' non esiste.", segui questi passaggi per risolvere il problema:

  1. Assicurati di utilizzare le credenziali corrette per accedere a Business Central. Queste credenziali potrebbero non essere le stesse credenziali utilizzate per accedere a Power BI. Come posso modificare o cancellare l'account che sto utilizzando attualmente per connettermi a Business Central da Power BI Desktop?
  2. Se l'ambiente è un ambiente ISV incorporato, è necessario specificare il nome ISV incorporato tra parentesi come parte del nome dell'ambiente. Ad esempio, se desideri connetterti a un ambiente denominato Produzione da un ISV incorporato denominato Fabrikam, è necessario specificare "PRODUCTION (fabrikam)" come nome dell'ambiente.

"Impossibile inserire un record. L'intento di connessione corrente è di sola lettura." errore durante la connessione alla pagina dell'API personalizzata

APPLICABILE A: Business Central Online

Per impostazione predefinita, i report che utilizzano i dati di Business Central si collegano a una replica di sola lettura del database di Business Central. In rari casi, a seconda della progettazione dell'API, potresti ricevere un errore quando tenti di connetterti e ottenere i dati dall'API. L'errore è simile a questo:

Dynamics365BusinessCentral: Request failed: The remote server returned an error: (400) Bad Request. (Can't insert a record. Current connection intent is Read-Only. CorrelationId: [...])".

Se usi un'API personalizzata, ti consigliamo di rielaborare il codice AL per assicurarti che non apporti modifiche al database quando sta solo leggendo i dati. Tuttavia, nel caso in cui lo scenario lo richieda, è possibile configurare il connettore per l'uso di una connessione di lettura/scrittura.

Abilitare i dati aziendali per Power BI
Business Intelligence
Prepararsi a fare affari
Importazione dei dati aziendali da altri sistemi contabili
Impostazione di Business Central
Dati finanziari
Avvio rapido: connettersi ai dati in Power BI Desktop

I moduli di e-learning gratuiti per Business Central sono disponibili qui