Tutorial: Inserir conteúdo do Power BI usando um aplicativo de exemplo inserir para a organização

A análise integrada do Power BI permite que você insira conteúdo do Power BI, como relatórios, dashboards e blocos, em seu aplicativo.

Neste tutorial, você aprenderá como:

  • Configure o seu ambiente inserido.
  • Configure um aplicativo de exemplo inserir para a organização (também conhecido como usuário proprietário dos dados).

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

Geralmente, a solução de inserção para a organização é usada por empresas e grandes organizações e é destinada a usuários internos.

Importante

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

Especificações de exemplo de código

Este tutorial inclui instruções para configurar um aplicativo de exemplo inserir para a organização em um dos seguintes frameworks:

  • .NET Framework
  • .NET Core
  • React TypeScript

Observação

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

Os exemplos de código dão suporte aos 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 listadas:


Método

Para criar um aplicativo de exemplo inserir para a organização, siga estas etapas:

  1. Registrar um aplicativo do Microsoft Entra.

  2. Crie um workspace do Power BI.

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

  4. Obtenha os valores de parâmetro de inserção.

  5. Insira o conteúdo.

Etapa 1 - Registrar um aplicativo do Microsoft Entra

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

Para registrar o seu aplicativo com o Microsoft Entra ID, siga as instruções em Registrar o seu aplicativo.

Etapa 2 – Criar um workspace do Power BI

O Power BI mantém os seus relatórios, dashboards e blocos em um workspace. Para inserir esses itens, você precisará criá-los e carregá-los em um workspace.

Dica

Se você já tiver um workspace, pule esta etapa.

Para criar um workspace, faça o seguinte:

  1. Entre no Power BI.

  2. Selecione Workspaces.

  3. Selecione Criar um workspace.

  4. Nomeie o seu workspace e selecione Salvar.

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

A próxima etapa é criar um relatório e carregá-lo no seu workspace. Você pode criar o próprio relatório usando o Power BI Desktop e, em seguida, publicá-lo no seu workspace. Ou pode carregar um relatório de exemplo no seu workspace.

Dica

Se você já tiver um workspace com um relatório, pule esta etapa.

Para baixar um relatório de exemplo e publicá-lo no seu workspace, siga estas etapas:

  1. Abra a pasta Exemplos do Power BI Desktop do GitHub.

  2. Selecione Código e Baixar zip.

    A screenshot showing the ZIP download option in the Power B I desktop samples GitHub

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

  4. Selecione um relatório a ser inserido e publique-o no seu workspace.

Etapa 4 – Obter os valores de parâmetro de inserção

Para inserir seu conteúdo, você precisará obter alguns valores de parâmetro. Os valores de parâmetro dependem da linguagem do aplicativo de exemplo que você deseja usar. A tabela a seguir lista quais valores de parâmetro são necessários para cada exemplo.

Parâmetro .NET Core .NET Framework React TypeScript
ID do Cliente
Segredo do cliente
ID do Workspace
ID do Relatório

ID do Cliente

Dica

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. Entre no Microsoft Azure.

  2. Pesquise Registros de aplicativo e selecione o link Registros de aplicativo.

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

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

Segredo do cliente

Dica

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

Para obter o segredo do cliente, siga estas etapas:

  1. Entre no Microsoft Azure.

  2. Pesquise Registros de aplicativo e selecione o link Registros de aplicativo.

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

  4. Em Gerenciar, selecione Certificados e 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 do 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 do segredo do cliente é a sua ID do cliente.

Observação

Copie o valor do segredo do cliente quando aparecer pela primeira vez. Depois de navegar para fora dessa página, o segredo do cliente ficará oculto e você não poderá recuperar seu valor.

ID do workspace

Dica

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

Para obter o GUID da ID do workspace, siga estas etapas:

  1. Entre no serviço do Power BI.

  2. Abra o relatório que deseja inserir.

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

    A screenshot showing workspace ID GUID in the Power B I service U R L

ID do Relatório

Dica

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

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

  1. Entre no serviço do Power BI.

  2. Abra o relatório que deseja inserir.

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

    A screenshot showing report ID GUID in the Power B I service U R L

Etapa 5 – Inserir seu conteúdo

O aplicativo de exemplo inserido do Power BI permite que você crie um aplicativo inserir para a organização do Power BI.

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

  1. Abra a pasta Exemplos de desenvolvedores do Power BI.

  2. Selecione Código e Baixar zip.

    A screenshot showing the ZIP download option in the Power B I developer samples GitHub

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

  1. Abra uma das pastas a seguir, dependendo do idioma que você deseja que o seu aplicativo use:

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

    Observação

    Os aplicativos de exemplo inserir para a organização dão suporte apenas aos frameworks listados anteriormente. Os aplicativos de exemplo Java, Node JS e Python dão suporte apenas à solução inserir para os clientes .

Configurar seu aplicativo do Microsoft Entra

  1. Entre no Portal do Azure.

  2. Selecione Registros do Aplicativo. Se não vir essa opção, pesquise por ela.

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

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

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

    Observação

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

  2. Salve suas alterações.

Screenshot of the Azure portal window, which shows the app authentication configurations and the web redirect URI for the .NET core app sample.

Configurar o aplicativo de inserção de exemplo

  1. Abra a pasta Inserir para a organização.

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

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

Executar o aplicativo de exemplo

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

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

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

  1. Entre no aplicativo de exemplo de integração.

    Observação

    Na primeira vez em que entrar, você receberá um prompt para conceder permissões do Microsoft Entra para o aplicativo.

  2. Quando o aplicativo de exemplo de integração for carregado, selecione o conteúdo do Power BI que deseja integrar e, em seguida, selecione Integrar.

    Screenshot showing the Power BI embedding sample app.

Desenvolver seu aplicativo

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

Atualizar permissões de usuário

Os usuários precisam de permissão para acessar a pasta do Power BI em que o relatório está. Quando você concede a um usuário permissão 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 Integrado, faça uma chamada explícita para a API REST de Permissões do RefreshUser na inicialização. Essa chamada à API atualizará as permissões e evitará falhas de autorização para usuários com permissões recém-concedidas.