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:

• 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

  • 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

  .NET Framework

  • .NET Framework 4.8

  • Visual Studio

  React TypeScript

  • Um editor de texto

  • Terminal de linha de comando (ou PowerShell)

---

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.

Dica

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

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.

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.

   

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

   

ID do Relatório

Dica

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

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 .

.NET Core

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.

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

6. Salve suas alterações.

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:

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

   • Se 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 de ID do cliente

   • ClientSecret – use o segredo do cliente

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.

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

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

   

.NET Framework

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.

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

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

      Observação

      Se você não tiver uma plataforma da 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 Tokens de ID.

6. Salve suas alterações.

Configurar o aplicativo de inserção de exemplo

1. Abra a pasta Inserir para a 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 de ID do cliente

   • clientSecret – use o segredo do cliente

Executar o aplicativo de exemplo

1. Execute o projeto selecionando IIS Express (reprodução).

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

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

   

React TypeScript

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.

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

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

      Observação

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

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

      • Tokens de acesso
      • Tokens de ID

6. Salve suas alterações.

Configurar o aplicativo de inserção de exemplo

1. Abra a pasta Inserir para a 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 de ID do cliente

   • workspaceId – use a ID do workspace

   • reportId – use a ID do relatório

3. Salve o arquivo.

Executar o aplicativo de exemplo

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

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

   npm install

3. Execute o aplicativo inserindo o seguinte comando:

   npm run start

   Observação

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

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