Tutorial: Incorporar conteúdo do Power BI usando uma incorporação de exemplo para seu aplicativo da organização

A análise incorporada do Power BI permite incorporar conteúdo do Power BI, como relatórios, painéis e blocos, em seu aplicativo.

Neste tutorial, irá aprender a:

• Configure seu ambiente incorporado.
• Configure um aplicativo de exemplo de incorporação para sua organização (também conhecido como dados de proprietários do usuário).

Para usar seu aplicativo, seus usuários precisarão entrar no Power BI.

A solução de incorporação para sua organização é normalmente usada por empresas e grandes organizações e destina-se a usuários internos.

Importante

Se você estiver incorporando conteúdo para uma nuvem nacional/regional, as primeiras etapas deste tutorial serão diferentes. Consulte Incorporar conteúdo para nuvens nacionais/regionais para obter detalhes.

Especificações de exemplo de código

Este tutorial inclui instruções para configurar uma incorporação para seu aplicativo de exemplo da organização em uma das seguintes estruturas:

• .NET Framework
• .NET Core
• Reagir TypeScript

Nota

Os exemplos do .NET Core e do .NET Framework permitem que o usuário final exiba qualquer painel, relatório ou bloco do Power BI ao qual tenha acesso no serviço do Power BI. O exemplo React TypeScript permite incorporar apenas um relatório ao qual o usuário final já tem acesso no serviço do Power BI.

Os exemplos de código suportam os seguintes navegadores:

• Microsoft Edge
• Google Chrome
• Mozilla Firefox

Pré-requisitos

Antes de iniciar este tutorial, verifique se você tem as seguintes dependências do Power BI e do código:

• Dependências do Power BI

  • Seu próprio locatário do Microsoft Entra.

    • Uma das seguintes licenças:

      • Power BI Pro

      • Premium por usuário (PPU)

    Nota

    Para passar para a produção , você precisará de uma das seguintes configurações:

    • Todos os usuários com licenças Pro.
    • Todos os usuários com licenças PPU.
    • Um SKU equivalente ou superior a um SKU F64. Esta configuração permite que todos os usuários tenham licenças livres.

• Dependências de código

  .NET Core

  • SDK do .NET Core 3.1 (ou superior)

  • Um ambiente de desenvolvimento integrado (IDE). Recomendamos o uso de um dos seguintes IDEs:

    • Visual Studio

    • Visual Studio Code

  .NET Framework

  • .NET Framework 4.8

  • Visual Studio

  Reagir TypeScript

  • Um editor de texto

  • Terminal de linha de comando (ou PowerShell)

---

Método

Para criar uma incorporação para o aplicativo de exemplo da sua organização , siga estas etapas:

1. Registre um aplicativo Microsoft Entra.

2. Crie um espaço de trabalho do Power BI.

3. Crie e publique um relatório do Power BI.

4. Obtenha os valores dos parâmetros de incorporação.

5. Incorpore o seu conteúdo.

Etapa 1 - Registrar um aplicativo Microsoft Entra

Registrar seu aplicativo com o Microsoft Entra ID permite que você estabeleça uma identidade para seu aplicativo.

Para registar a sua candidatura com o Microsoft Entra ID, siga as instruções em Registar a sua candidatura.

Etapa 2 - Criar um espaço de trabalho do Power BI

O Power BI mantém seus relatórios, painéis e blocos em um espaço de trabalho. Para incorporar esses itens, você precisará criá-los e carregá-los em um espaço de trabalho.

Gorjeta

Se já tiver um espaço de trabalho, pode ignorar este passo.

Para criar um espaço de trabalho, faça o seguinte:

1. Inicie sessão no Power BI.

2. Selecione Áreas de trabalho.

3. Selecione Criar uma área de trabalho.

4. Nomeie seu espaço de trabalho e selecione Salvar.

Etapa 3 - Criar e publicar um relatório do Power BI

Sua próxima etapa é criar um relatório e carregá-lo em seu espaço de trabalho. Você pode criar seu próprio relatório usando o Power BI Desktop e publicá-loem seu espaço de trabalho. Ou, você pode carregar um relatório de exemplo para seu espaço de trabalho.

Gorjeta

Se já tiver uma área de trabalho com um relatório, pode ignorar este passo.

Para baixar um relatório de exemplo e publicá-lo em seu espaço de trabalho, siga estas etapas:

1. Abra a pasta de exemplos do GitHub Power BI Desktop.

2. Selecione Código e, em seguida, selecione Baixar zip.

   

3. Extraia o ZIP baixado e navegue até a pasta Relatórios de exemplo .

4. Selecione um relatório para incorporar e publique-o no seu espaço de trabalho.

Etapa 4 - Obter os valores dos parâmetros de incorporação

Para incorporar seu conteúdo, você precisará obter alguns valores de parâmetro. Os valores dos parâmetros dependem do idioma do aplicativo de exemplo que você deseja usar. A tabela abaixo lista quais valores de parâmetros são necessários para cada amostra.

Parâmetro	.NET Core	.NET Framework	Reagir TypeScript
ID de Cliente
Segredo do cliente
ID do espaço de trabalho
ID do relatório

ID de Cliente

Gorjeta

Aplica-se a: .NET Core .NET Framework React TypeScript

Para obter o GUID da ID do cliente (também conhecido como ID do aplicativo), siga estas etapas:

1. Faça logon no Microsoft Azure.

2. Pesquise por Registos de aplicações e selecione a ligação Registos de aplicações.

3. Selecione o aplicativo Microsoft Entra que você está usando para incorporar seu conteúdo do Power BI.

4. Na seção Visão geral, copie o GUID do ID do aplicativo (cliente).

Segredo do cliente

Gorjeta

Aplica-se a: .NET Core .NET Framework React TypeScript

Para obter o segredo do cliente, siga estes passos:

1. Faça logon no Microsoft Azure.

2. Pesquise por Registos de aplicações e selecione a ligação Registos de aplicações.

3. Selecione o aplicativo Microsoft Entra que você está usando para incorporar seu conteúdo do Power BI.

4. Em Gerenciar, selecione Certificados & segredos.

5. Em Segredos do cliente, selecione Novo segredo do cliente.

6. Na janela pop-up Adicionar um segredo do cliente, forneça uma descrição para o segredo do aplicativo, selecione quando o segredo do aplicativo expira e selecione Adicionar.

7. Na seção Segredos do cliente, copie a cadeia de caracteres na coluna Valor do segredo do aplicativo recém-criado. O valor secreto do cliente é o ID do cliente.

Nota

Certifique-se de copiar o valor secreto do cliente quando ele aparecer pela primeira vez. Depois de navegar para fora desta página, o segredo do cliente será oculto e você não poderá recuperar seu valor.

ID da área de trabalho

Gorjeta

Aplica-se a: .NET Core .NET Framework React TypeScript

Para obter o GUID do ID do espaço de trabalho, siga estas etapas:

1. Iniciar sessão no serviço Power BI.

2. Abra o relatório que pretende incorporar.

3. Copie o GUID do URL. O GUID é o número entre /groups/ e /reports/.

   

ID do relatório

Gorjeta

Aplica-se a: .NET Core .NET Framework ReactTypeScript

Para obter o GUID de ID de relatório, siga estas etapas:

1. Iniciar sessão no serviço Power BI.

2. Abra o relatório que pretende incorporar.

3. Copie o GUID do URL. O GUID é o número entre /reports/ e /ReportSection.

   

Etapa 5 - Incorporar seu conteúdo

O aplicativo de exemplo incorporado do Power BI permite que você crie uma incorporação para seu aplicativo Power BI da organização .

Siga estas etapas para modificar a incorporação do aplicativo de exemplo da sua organização , para incorporar seu relatório do Power BI.

1. Abra a pasta de exemplos do desenvolvedor do Power BI.

2. Selecione Código e, em seguida, selecione Baixar zip.

   

3. Extraia o ZIP baixado e navegue até a pasta PowerBI-Developer-Samples-master .

4. Abra uma das seguintes pastas, dependendo do idioma que você deseja que seu aplicativo use:

   • .NET Core
   • .NET Framework
   • React-TS

   Nota

   Os aplicativos de exemplo de incorporação para sua organização suportam apenas as estruturas listadas anteriormente. Os aplicativos de exemplo Java, Node JS e Python suportam apenas a solução embed for your customers .

.NET Core

Configurar seu aplicativo Microsoft Entra

1. Inicie sessão no Portal do Azure.

2. Selecione Registos de aplicações. Se não conseguir ver esta opção, pesquise-a.

3. Abra o aplicativo Microsoft Entra que você criou na Etapa 1 - Registrar um aplicativo Microsoft Entra.

4. No menu Gerenciar, selecione Autenticação.

5. Em Configurações de plataforma, abra sua plataforma Web e, na seção Redirecionar URIs, adicione https://localhost:5000/signin-oidc.

   Nota

   Se você não tiver uma plataforma Web, selecione Adicionar uma plataforma e, na janela Configurar plataformas, escolha Web.

6. Guardar as suas alterações.

Configurar o aplicativo de incorporação de exemplo

1. Abra a pasta Incorporar para sua organização .

2. Abra a incorporação para seu aplicativo de exemplo da organização usando um destes métodos:

   • Se você estiver usando o Visual Studio, abra o arquivo UserOwnsData.sln .

   • Se você estiver usando o Visual Studio Code, abra a pasta UserOwnsData .

3. Abra appsettings.json e preencha os seguintes valores de parâmetro:

   • ClientId- Use o GUID do ID do cliente

   • ClientSecret - Use o segredo do cliente

Execute a aplicação de exemplo

1. Execute o projeto selecionando a opção apropriada:

   • Se você estiver usando o Visual Studio, selecione IIS Express (reproduzir).

   • Se você estiver usando o Visual Studio Code, selecione Executar > Iniciar Depuração.

2. Entre no aplicativo de exemplo de incorporação.

   Nota

   Durante o seu primeiro início de sessão, ser-lhe-á pedido que permita permissões do Microsoft Entra para a aplicação.

3. Quando o aplicativo de exemplo de incorporação for carregado, selecione o conteúdo do Power BI que você deseja incorporar e, em seguida, selecione Incorporar.

   

.NET Framework

Configurar seu aplicativo Microsoft Entra

1. Inicie sessão no Portal do Azure.

2. Selecione Registos de aplicações. Se não conseguir ver esta opção, pesquise-a.

3. Abra o aplicativo Microsoft Entra que você criou na Etapa 1 - Registrar um aplicativo Microsoft Entra.

4. No menu Gerenciar, selecione Autenticação.

5. Em Configurações de plataforma, configure as seguintes opções:

   1. Em sua plataforma Web , na seção Redirecionar URIs , adicione https://localhost:44300/.

      Nota

      Se você não tiver uma plataforma Web, selecione Adicionar uma plataforma e, na janela Configurar plataformas, selecione Web.

   2. Em Concessão implícita e fluxos híbridos, habilite a opção de tokens de ID.

6. Guardar as suas alterações.

Configurar o aplicativo de incorporação de exemplo

1. Abra a pasta Incorporar para sua organização .

2. Usando o Visual Studio, abra o arquivo UserOwnsData.sln .

3. Abra Web.config e preencha os seguintes valores de parâmetro:

   • clientId- Use o GUID do ID do cliente

   • clientSecret - Use o segredo do cliente

Execute a aplicação de exemplo

1. Execute o projeto selecionando IIS Express (play).

2. Entre no aplicativo de exemplo de incorporação.

   Nota

   Durante o seu primeiro início de sessão, ser-lhe-á pedido que permita permissões do Microsoft Entra para a aplicação.

3. Quando o aplicativo de exemplo de incorporação for carregado, selecione o conteúdo do Power BI que você deseja incorporar e, em seguida, selecione Incorporar.

   

Reagir TypeScript

Configurar seu aplicativo Microsoft Entra

1. Inicie sessão no Portal do Azure.

2. Selecione Registos de aplicações. Se não conseguir ver esta opção, pesquise-a.

3. Abra o aplicativo Microsoft Entra que você criou na Etapa 1 - Registrar um aplicativo Microsoft Entra.

4. No menu Gerenciar, selecione Autenticação.

5. Em Configurações de plataforma, configure sua plataforma Web da seguinte maneira:

   1. Em Redirecionar URIs, adicione https://localhost:3000 e selecione Configurar.

      Nota

      Se você não tiver uma plataforma Web, selecione Adicionar uma plataforma e, na janela Configurar plataformas, escolha Web.

   2. Em Concessão implícita e fluxos híbridos, habilite ambas as opções:

      • Tokens de acesso
      • Tokens de ID

6. Guardar as suas alterações.

Configurar o aplicativo de incorporação de exemplo

1. Abra a pasta Incorporar para sua organização>UserOwnsData>src.

2. Usando um editor de texto, abra o arquivo Config.ts e preencha os seguintes valores de parâmetro:

   • clientId- Use o GUID do ID do cliente

   • workspaceId - Use o ID do espaço de trabalho

   • reportId - Use o ID do relatório

3. Guarde o ficheiro.

Execute a aplicação de exemplo

1. Abra um terminal e navegue até Incorporar para sua organização>UserOwnsData.

2. Instale as dependências necessárias inserindo o seguinte comando:

   npm install

3. Execute o aplicativo digitando o seguinte comando:

   npm run start

   Nota

   Durante o seu primeiro início de sessão, ser-lhe-á pedido que permita permissões do Microsoft Entra para a aplicação.

Desenvolva a sua aplicação

Depois de configurar e executar a incorporação para seu aplicativo de exemplo de clientes, você pode começar a desenvolver seu próprio aplicativo.

Atualizar permissões de usuário

Os usuários precisam de permissão para acessar a pasta do Power BI na qual o relatório está. Quando você concede permissão a um usuário para acessar uma pasta, a alteração geralmente entra em vigor somente depois que o usuário faz logon no Portal do Power BI. Para que as novas permissões entrem em vigor imediatamente, no cenário incorporado, faça uma chamada explícita para a API REST de permissões RefreshUser na inicialização. Esta chamada de API atualizará as permissões e evitará falhas de autorização para usuários com permissões recém-concedidas.

Conteúdos relacionados

Tutorial: Incorporar conteúdo do Power BI usando uma incorporação de exemplo para o aplicativo de seus clientes

Incorporar relatórios paginados

Pergunte à Comunidade do Power BI