Tutorial: inserir conteúdos do Power BI em seu aplicativo para nuvens nacionais/regionais

Saiba como inserir conteúdos analíticos em seus aplicativos de processos de negócios para a nuvem nacional/regional. Use o SDK do .NET do Power BI com a API do JavaScript do Power BI para inserir um relatório, dashboard ou bloco, em seus aplicativos Web.

O Power BI tem suporte para as seguintes nuvens nacionais/regionais:

• (EUA) GCC (Government Community Cloud)

• (EUA) GCC High (Nuvem da Comunidade Governamental do EUA – Alta)

• (EUA) Militares prestadores de serviço (DoDCON)

• (EUA) Militar (DoD)

• Power BI para a nuvem da China

Para começar este passo a passo, você precisará de uma conta do Power BI. Se você não tiver uma conta configurada, dependendo do tipo de governo ou país/região, poderá escolher a nuvem nacional/regional certa para você. Inscreva-se para uma conta do Power BI do governo dos EUA ou uma conta do Power BI para a nuvem da China.

Observação

Você está buscando inserir um dashboard para sua organização? Confira Inserir um dashboard em um aplicativo para sua organização.

Para integrar um dashboard em um aplicativo Web, use a API do Power BI e um token de acesso de autorização do Microsoft Entra para obter um dashboard. Carregue o dashboard usando um token de inserção. A API do Power BI fornece acesso programático a recursos específicos do Power BI. Para obter mais informações, confira a API REST do Power BI, o SDK do .NET do Power BI e a API JavaScript do Power BI.

Baixe o exemplo

Este artigo mostra o código da amostra O Aplicativo Possui Dados no GitHub. Para acompanhar esse passo a passo, baixe a amostra. Usaremos o diretório .NET Framework/Embed for your customers.

Importante

Você só pode incorporar o conteúdo do Power BI de uma GCC (Nuvem da Comunidade Governamental) com um SKU do Microsoft 365. Outros clientes de nuvem nacionais/regionais podem usar SKUs do Microsoft 365 ou do Azure .

• GCC (Government Community Cloud):

  1. No arquivo Web.config, atualize applicationId (aplicativo nativoapplicationId), workspaceId, o nome de usuário (seu usuário mestre) e a senha.

  2. Em seguida, adicione os parâmetros GCC da seguinte maneira.

     <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/" />
     

• Militares prestadores de serviço (DoDCON):

  1. No arquivo Web.config, atualize applicationId (aplicativo nativoapplicationId), workspaceId, o nome de usuário (seu usuário mestre) e a senha.

  2. Em seguida, adicione os parâmetros DoDCON da maneira a seguir.

     <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/" />
     

• Militar (DoD):

  1. No arquivo Web.config, atualize applicationId (aplicativo nativoapplicationId), workspaceId, o nome de usuário (seu usuário mestre) e a senha.

  2. Em seguida, adicione os parâmetros DoDCON da maneira a seguir.

     <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/" />
     

• Parâmetros do Power BI para nuvem da China

  1. No arquivo Web.config, atualize applicationId (aplicativo nativoapplicationId), workspaceId, o nome de usuário (seu usuário mestre) e a senha.

  2. Em seguida, adicione os parâmetros para nuvem do Power BI para China da maneira a seguir.

     <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/" />
     

Etapa 1 - Registrar um aplicativo no Microsoft Entra ID

Registre o aplicativo no Microsoft Entra ID para fazer chamadas à API REST. Para obter mais informações, consulte Registrar um aplicativo do Microsoft Entra para inserir o conteúdo do Power BI. Como há diferentes afiliações nacionais/regionais à nuvem, há URLs diferentes para registrar sua inscrição.

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

• Militares prestadores de serviço (DoDCON) – https://app.high.powerbigov.us/apps

• Militar (DoD) – https://app.mil.powerbigov.us/apps

• Power BI para a nuvem da China – https://app.powerbi.cn/apps

Se você tiver baixado o Exemplo Inserindo para seu cliente, use a applicationId obtida, para que o exemplo possa ser autenticado no Microsoft Entra ID. Para configurar o exemplo, altere a applicationId no arquivo web.config.

Etapa 2 – Obter um token de acesso do Microsoft Entra ID

No aplicativo, primeiro você precisa obter um token de acesso do Microsoft Entra ID para que seja possível fazer chamadas à API REST do Power BI. Para obter mais informações, consulte Autenticar usuários e obter um token de acesso do Microsoft Entra para o aplicativo do Power BI. Como existem diferentes afiliações de nuvem nacionais/regionais, existem URLs distintas para obter um token de acesso para seu aplicativo.

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

• Militares prestadores de serviço (DoDCON) – https://login.microsoftonline.us

• Militar (DoD) – https://login.microsoftonline.us

• Power BI para a nuvem da China – https://login.chinacloudapi.cn

É possível ver exemplos desses tokens de acesso dentro de cada tarefa de item de conteúdo no arquivo Controllers\HomeController.cs.

Etapa 3 – inserir conteúdo

Agora que você tem um token de acesso, pode continuar inserindo conteúdo como faria em qualquer outra plataforma.

• Inserir o conteúdo para clientes
• Inserir o conteúdo para sua organização

Conteúdo relacionado

Amostra de inserção para seus clientes

API de JavaScript do Power BI

Mais perguntas? Perguntar à Comunidade do Power BI