Condividi tramite

Esercitazione Incorporare un contenuto di Power BI nell'applicazione per cloud nazionali/regionali

  • Articolo

Informazioni su come incorporare contenuto analitico all'interno di applicazioni aziendali per cloud nazionali/regionali. Usare Power BI .NET SDK con l'API JavaScript di Power BI per incorporare un report, un dashboard o un riquadro in applicazioni Web personalizzate.

Power BI supporta i cloud nazionali/regionali seguenti:

  • U.S. Government Community Cloud (GCC) (Cloud della community per enti pubblici)

  • U.S. Government Community Cloud High (GCC High) (Cloud della community per enti pubblici)

  • U.S. Military Contractors (DoDCON) (Contractor militari - DoDCON)

  • U.S. Military (DoD) (Esercito -DoD)

  • Power BI per il cloud Cina

Screenshot che mostra la funzionalità Incorpora un dashboard.

Per eseguire questa procedura dettagliata, è necessario un account Power BI. Se non si ha un account configurato, è possibile scegliere il cloud nazionale/regionale appropriato in base al tipo di ente pubblico o al paese/regione. Iscriversi per ottenere un account Power BI per enti governativi degli Stati Uniti o un account di Power BI per il cloud Cina.

Nota

Si vuole invece incorporare un dashboard per l'organizzazione? Vedere Integrare un dashboard in un'app per l'organizzazione.

Per integrare un dashboard in un'app Web, usare l'API Power BI e un token di accesso di autorizzazione di Microsoft Entra per ottenere un dashboard. Caricare il dashboard tramite un token di incorporamento. L'API di Power BI offre l'accesso a livello di codice a specifiche risorse di Power BI. Per altre informazioni, vedere API REST di Power BI, Power BI .NET SDK e API JavaScript di Power BI.

Scaricare l'esempio

Questo articolo illustra il codice usato nell'esempio I dati sono di proprietà dell'app su GitHub. Per proseguire con questa procedura dettagliata, scaricare l'esempio. Viene usata la directory .NET Framework/Embed for your customers.

Importante

È possibile incorporare il contenuto di Power BI solo da un GCC (Government Community Cloud) con un SKU di Microsoft 365. Altri clienti del cloud nazionale/regionale possono usare SKU di Microsoft 365 o di Azure.

Screenshot che mostra il download dell'esempio I dati sono di proprietà dell'app.

Screenshot che mostra la directory I dati sono di proprietà dell'app.

  • Government Community Cloud (GCC) (Cloud della community per enti pubblici):

    1. Nel file Web.config aggiornare applicationId (app nativa applicationId), workspaceId, il nome utente (l'utente master) e la password.

    2. Aggiungere quindi i parametri GCC come indicato di seguito.

      <add key="authorityUrl" value="https://login.microsoftonline.com/organizations/" />
<add key="scopeBase" value="https://analysis.usgovcloudapi.net/powerbi/api/.default" />
<add key="urlPowerBiServiceApiRoot" value="https://api.powerbigov.us/" />

  • Military Contractors (DoDCON) (Contractor militari - DoDCON):

    1. Nel file Web.config aggiornare applicationId (app nativa applicationId), workspaceId, il nome utente (l'utente master) e la password.

    2. Aggiungere quindi i parametri DoDCON come indicato di seguito.

      <add key="authorityUrl" value="https://login.microsoftonline.us/organizations/" />
<add key="scopeBase" value="https://high.analysis.usgovcloudapi.net/powerbi/api/.default" />
<add key="urlPowerBiServiceApiRoot" value="https://api.high.powerbigov.us/" />

  • Military (DoD) (Esercito -DoD):

    1. Nel file Web.config aggiornare applicationId (app nativa applicationId), workspaceId, il nome utente (l'utente master) e la password.

    2. Aggiungere quindi i parametri DoDCON come indicato di seguito.

      <add key="authorityUrl" value="https://login.microsoftonline.us/organizations/" />
<add key="scopeBase" value="https://mil.analysis.usgovcloudapi.net/powerbi/api/.default" />
<add key="urlPowerBiServiceApiRoot" value="https://api.mil.powerbigov.us/" />

  • Parametri di Power BI per il cloud Cina

    1. Nel file Web.config aggiornare applicationId (app nativa applicationId), workspaceId, il nome utente (l'utente master) e la password.

    2. Aggiungere quindi i parametri cloud di Power BI per la Cina come indicato di seguito.

      <add key="authorityUrl" value="https://login.chinacloudapi.cn/organizations/" />
<add key="scopeBase" value="https://analysis.chinacloudapi.cn/powerbi/api/.default" />
<add key="urlPowerBiServiceApiRoot" value="https://api.powerbi.cn/" />

Passaggio 1: Registrare un'app in Microsoft Entra ID

Registrare l'applicazione in Microsoft Entra ID per effettuare chiamate all'API REST. Per altre informazioni, vedere Registrare un'app di Microsoft Entra per incorporare il contenuto di Power BI. Poiché sono presenti affiliazioni per cloud nazionali/regionali diversi, esistono URL distinti per registrare l'applicazione.

  • Government Community Cloud (GCC) (Cloud della community per enti pubblici) - https://app.powerbigov.us/apps

  • Military Contractors (DoDCON) (Contractor militari - DoDCON) - https://app.high.powerbigov.us/apps

  • Military (DoD) (Esercito - DoD)- https://app.mil.powerbigov.us/apps

  • Power BI per il cloud Cina - https://app.powerbi.cn/apps

Se è stato scaricato l'esempio di incorporamento per il cliente, usare l'applicationId ottenuto in modo che l'esempio possa eseguire l'autenticazione in Microsoft Entra ID. Per configurare l'esempio, modificare applicationId nel file web.config.

Passaggio 2: Ottenere un token di accesso da Microsoft Entra ID

All'interno dell'applicazione è necessario ottenere un token di accesso da Microsoft Entra ID per poter effettuare chiamate all'API REST di Power BI. Per altre informazioni, vedere Autenticare gli utenti e ottenere un token di accesso di Microsoft Entra per l'app Power BI. Dato che sono presenti affiliazioni per cloud nazionali/regionali diversi, esistono URL distinti per ottenere un token di accesso per l'applicazione.

  • Government Community Cloud (GCC) (Cloud della community per enti pubblici) - https://login.microsoftonline.com

  • Military Contractors (DoDCON) (Contractor militari - DoDCON) - https://login.microsoftonline.us

  • Military (DoD) (Esercito - DoD)- https://login.microsoftonline.us

  • Power BI per il cloud Cina - https://login.chinacloudapi.cn

Esempi di questi token di accesso all'interno di ogni attività di elemento di contenuto sono disponibili nel file Controllers\HomeController.cs.

Passaggio 3: Incorporare il contenuto

Ora che si dispone di un token di accesso, è possibile continuare a incorporare come si farebbe in qualsiasi altra piattaforma.

Contenuto correlato

Altre domande? Inviare una domanda alla community di Power BI