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

  • Articolo

Informazioni su come incorporare contenuti analitici all'interno delle applicazioni di processo aziendale per il cloud nazionale/regionale. Usare Power BI .NET SDK con l'API JavaScript di Power BI per incorporare un report, un dashboard o un riquadro nelle applicazioni Web.

Power BI supporta i cloud nazionali/regionali seguenti:

  • U.S. Government Community Cloud (GCC)

  • U.S. Government Community Cloud High (GCC High)

  • Appaltatori militari statunitensi (DoDCON)

  • Esercito degli Stati Uniti (DoD)

  • Cloud di Power BI per la Cina

Screenshot showing the Embed a dashboard feature.

Per iniziare a usare questa procedura dettagliata, è necessario un account Power BI. Se non si dispone di un account configurato, a seconda del tipo di governo o paese/area geografica, è possibile scegliere il cloud nazionale/regionale appropriato per l'utente. Iscriversi per ottenere un account Power BI per enti pubblici degli Stati Uniti o un account cloud di Power BI per la 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 di Power BI e un token di accesso all'autorizzazione di Microsoft Entra per ottenere un dashboard. Caricare il dashboard usando un token di incorporamento. L'API di Power BI fornisce l'accesso a livello di codice a risorse di Power BI specifiche. Per altre informazioni, vedere API REST di Power BI, Power BI .NET SDK e l'API JavaScript di Power BI.

Scaricare l'esempio

Questo articolo illustra il codice per l'esempio App Owns Data in GitHub. Per seguire questa procedura dettagliata, scaricare l'esempio. Viene usata la .NET Framework/Embed for your customers directory .

Importante

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

A screenshot that shows downloading the App Owns Data sample.

A screenshot that shows the App Owns Data directory.

  • Government Community Cloud (GCC):

    1. Nel file Web.config aggiornare applicationId (app applicationIdnativa), 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/" />

  • Contractor militari (DoDCON):

    1. Nel file Web.config aggiornare applicationId (app applicationIdnativa), 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/" />

  • Militare (DoD):

    1. Nel file Web.config aggiornare applicationId (app applicationIdnativa), 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 cloud di Power BI per la Cina

    1. Nel file Web.config aggiornare applicationId (app applicationIdnativa), 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 con Microsoft Entra ID per effettuare chiamate API REST. Per altre informazioni, vedere Registrare un'app Microsoft Entra per incorporare il contenuto di Power BI. Poiché esistono diverse affiliazioni cloud nazionali/regionali, esistono URL distinti per registrare l'applicazione.

  • Government Community Cloud (GCC) - https://app.powerbigov.us/apps

  • Appaltatori militari (DoDCON) - https://app.high.powerbigov.us/apps

  • Militare (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, si userà l'oggetto applicationId che si ottiene, in modo che l'esempio possa eseguire l'autenticazione in Microsoft Entra ID. Per configurare l'esempio, modificare nel applicationIdfile 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, prima di poter effettuare chiamate all'API REST di Power BI. Per altre informazioni, vedere Autenticare gli utenti e ottenere un token di accesso Microsoft Entra per l'app Power BI. Poiché esistono diverse affiliazioni cloud nazionali/regionali, esistono URL distinti per ottenere un token di accesso per l'applicazione.

  • Government Community Cloud (GCC) - https://login.microsoftonline.com

  • Appaltatori militari (DoDCON) - https://login.microsoftonline.us

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

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

È possibile visualizzare esempi di questi token di accesso all'interno di ogni attività dell'elemento di contenuto 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

Esempio di incorporamento per i clienti

Power BI JavaScript API

Altre domande? Chiedere al Community di Power BI