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:

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.

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

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:

• Dependências do Power BI

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

    • Uma das seguintes licenças:

      • Power BI Pro

      • PPU (Premium Por Usuário)

    Observação

    Para mover 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.
    • Uma SKU que é equivalente ou superior a uma SKU F64. Essa configuração permite que todos os usuários tenham licenças gratuitas.

• Dependências de código

  • .NET Core
  • .NET Framework
  • React TypeScript

  • SDK do .NET Core 3.1 (ou superior)

  • Um IDE (ambiente de desenvolvimento integrado). É recomendável usar um dos seguintes IDEs:

    • Visual Studio

    • Visual Studio Code

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 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 workspace, faça o seguinte:

1. Entre no Fabric.

2. Selecione Espaços de trabalho.

3. Selecione + Novo espaço de trabalho.

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.

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.

   

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

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

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.

ID do workspace

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

   

ID do Relatório

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.

   

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.

   

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

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

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.

Conteúdo relacionado

• Tutorial: insira o conteúdo do Power BI usando um aplicativo de exemplo da solução inserir para seus clientes
• Repositórios paginados inseridos

Perguntar à Comunidade do Power BI