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:


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.

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. 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.

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.

    Uma captura de tela mostrando a opção de download ZIP no GitHub de exemplos de área de trabalho do Power B I

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

    Uma captura de tela mostrando o GUID da ID do espaço de trabalho na URL do serviço do Power BI

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.

    Uma captura de tela mostrando o GUID do ID do relatório no serviço Power B I U R L

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.

    Uma captura de tela mostrando a opção de download ZIP no GitHub de exemplos de desenvolvedor do Power B I

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

  1. 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 .

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.

  1. 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.

  2. Guardar as suas alterações.

Captura de tela da janela do portal do Azure, que mostra as configurações de autenticação do aplicativo e o URI de redirecionamento da Web para o exemplo de aplicativo .NET core.

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:

  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.

  1. 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.

  2. 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.

    Captura de ecrã a mostrar a aplicação de exemplo de incorporação do Power BI.

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.

Pergunte à Comunidade do Power BI