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:

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.

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

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
  • .NET Framework
  • Reagir TypeScript

  • 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

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 Microsoft Fabric mantém seus relatórios, painéis e blocos em um espaço de trabalho. Para incorporar esses itens, você precisa criá-los e carregá-los em um espaço de trabalho.

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

1. Faça login no Fabric.

2. Selecione Áreas de trabalho.

3. Selecione + Novo espaço 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á-lo em seu espaço de trabalho. Ou, você pode carregar um relatório de exemplo para seu espaço de trabalho.

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

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

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.

ID da área de trabalho

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

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 .

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