Tutorial: Inserir conteúdo do Power BI usando um aplicativo de exemplo inserir para a organizaçãoTutorial: Embed Power BI content using a sample embed for your organization application

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.Power BI embedded analytics allows you to embed Power BI content such as reports, dashboards and tiles, into your application.

Neste tutorial, você aprenderá como:In this tutorial, you'll learn how to:

  • Configure o seu ambiente inserido.Set up your embedded environment.
  • Configure um aplicativo de exemplo inserir para a organização (também conhecido como usuário proprietário dos dados).Configure an embed for your organization (also known as user owns data) sample application.

Para usar o aplicativo, os usuários precisarão entrar no Power BI.To use your application, your users will need to sign in to 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.The embed for your organization solution is usually used by enterprises and big organizations, and is intended for internal users.

Especificações de exemplo de códigoCode sample specifications

Este tutorial inclui instruções para configurar um aplicativo de exemplo inserir para a organização em um dos seguintes frameworks:This tutorial includes instructions for configuring an embed for your organization sample application in one of the following frameworks:

  • .NET Framework.NET Framework
  • .NET Core.NET Core
  • React TypeScriptReact TypeScript

Observação

Os exemplos de .NET Core e .NET Framework permitirão 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.The .NET Core and the .NET Framework samples will allow the end user to view any Power BI dashboard, report or tile they have access to in Power BI service. 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.The React TypeScript sample lets you embed only one report that your end user already has access to on Power BI service.

Os exemplos de código dão suporte aos seguintes navegadores:The code samples support the following browsers:

  • Microsoft EdgeMicrosoft Edge
  • Google ChromeGoogle Chrome
  • Mozilla FirefoxMozilla Firefox

Pré-requisitosPrerequisites

Antes de iniciar este tutorial, verifique se você tem as dependências do Power BI e do código listadas abaixo:Before you start this tutorial, verify that you have both the Power BI and code dependencies listed below:


MétodoMethod

Para criar um aplicativo de exemplo inserir para a organização, siga estas etapas:To create an embed for your organization sample app, follow these steps:

  1. Registre um aplicativo do Azure AD.Register an Azure AD application.

  2. Crie um workspace do Power BI.Create a Power BI workspace.

  3. Crie e publique um relatório do Power BI.Create and publish a Power BI report.

  4. Obtenha os valores de parâmetro de inserção.Get the embedding parameter values.

  5. Insira o conteúdo.Embed your content.

Etapa 1 – Registrar um aplicativo do Azure ADStep 1 - Register an Azure AD application

Registrar o aplicativo com o Azure AD permite que você estabeleça uma identidade para o aplicativo.Registering your application with Azure AD allows you to establish an identity for your app.

Para registrar o seu aplicativo com o Azure AD, siga as instruções em Registrar o seu aplicativo.To register your application with Azure AD, follow the instructions in Register your application.

Etapa 2 – Criar um workspace do Power BIStep 2 - Create a Power BI workspace

O Power BI mantém os seus relatórios, dashboards e blocos em um workspace.Power BI keeps your reports, dashboards, and tiles in a workspace. Para inserir esses itens, você precisará criá-los e carregá-los em um workspace.To embed these items, you'll need to create them and upload them into a workspace.

Dica

Se você já tiver um workspace, pule esta etapa.If you already have a workspace, you can skip this step.

Para criar um workspace, faça o seguinte:To create a workspace, do the following:

  1. Entre no Power BI.Sign in to Power BI.

  2. Selecione Workspaces.Select Workspaces.

  3. Selecione Criar um workspace.Select Create a workspace.

  4. Nomeie o seu workspace e selecione Salvar.Name your workspace and select Save.

Etapa 3 – Criar e publicar um relatório do Power BIStep 3 - Create and publish a Power BI report

A próxima etapa é criar um relatório e carregá-lo no seu workspace.Your next step is to create a report and upload it to your workspace. Você pode criar o próprio relatório usando o Power BI Desktop e, em seguida, publicá-lo no seu workspace.You can create your own report using Power BI Desktop, and then publish it to your workspace. Ou pode carregar um relatório de exemplo no seu workspace.Or, you can upload a sample report to your workspace.

Dica

Se você já tiver um workspace com um relatório, pule esta etapa.If you already have a workspace with a report, you can skip this step.

Para baixar um relatório de exemplo e publicá-lo no seu workspace, siga estas etapas:To download a sample report and publish it to your workspace, follow these steps:

  1. Abra a pasta Exemplos do Power BI Desktop do GitHub.Open the GitHub Power BI Desktop samples folder.

  2. Selecione Código e Baixar zip.Select Code and then select Download zip.

    Uma captura de tela que mostra a opção de download do ZIP no GitHub de exemplos no Power BI Desktop

  3. Extraia o ZIP baixado e navegue até a pasta Relatórios de Exemplos.Extract the downloaded ZIP and navigate to the Samples Reports folder.

  4. Selecione um relatório a ser inserido e publique-o no seu workspace.Select a report to embed, and publish it to your workspace.

Etapa 4 – Obter os valores de parâmetro de inserçãoStep 4 - Get the embedding parameter values

Para inserir seu conteúdo, você precisará obter alguns valores de parâmetro.To embed your content, you'll need to obtain a few parameter values. Os valores de parâmetro necessários dependem da linguagem do aplicativo de exemplo que você deseja usar.The parameter values you'll need depend on the language of the sample application you want to use. A tabela a seguir lista quais valores de parâmetro são necessários para cada exemplo.The table below lists which parameter values are required for each sample.

ParâmetroParameter .NET Core.NET Core .NET Framework.NET Framework React TypeScriptReact TypeScript
ID do ClienteClient ID Aplica-se a. Aplica-se a. Aplica-se a.
Segredo do clienteClient secret Aplica-se a. Aplica-se a. Não se aplica a.
ID do WorkspaceWorkspace ID Não se aplica a. Não se aplica a. Aplica-se a.
ID do RelatórioReport ID Não se aplica a. Não se aplica a. Aplica-se a.

ID do ClienteClient ID

Dica

Aplica-se a: Aplica-se a..NET Core Aplica-se a..NET Framework Aplica-se a.React TypeScriptApplies to: Applies to..NET Core Applies to..NET Framework Applies to.React TypeScript

Para obter o GUID da ID do cliente (também conhecido como ID do aplicativo), siga estas etapas:To get the client ID GUID (also know as application ID), follow these steps:

  1. Entre no Microsoft Azure.Log into Microsoft Azure.

  2. Pesquise Registros de aplicativo e selecione o link Registros de aplicativo.Search for App registrations and select the App registrations link.

  3. Selecione o aplicativo do Azure AD que você está usando para inserir o seu conteúdo do Power BI.Select the Azure AD app your using for embedding your Power BI content.

  4. Na seção Visão geral, copie o GUID da ID do aplicativo (cliente) .From the Overview section, copy the Application (client) ID GUID.

Segredo do clienteClient secret

Dica

Aplica-se a: Aplica-se a..NET Core Aplica-se a..NET Framework Não se aplica a.React TypeScriptApplies to: Applies to..NET Core Applies to..NET Framework Does not apply to.React TypeScript

Para obter o segredo do cliente, siga estas etapas:To get the client secret, follow these steps:

  1. Entre no Microsoft Azure.Log into Microsoft Azure.

  2. Pesquise Registros de aplicativo e selecione o link Registros de aplicativo.Search for App registrations and select the App registrations link.

  3. Selecione o aplicativo do Azure AD que você está usando para inserir o seu conteúdo do Power BI.Select the Azure AD app your using for embedding your Power BI content.

  4. Em Gerenciar, selecione Certificados e Segredos.Under Manage, select Certificates & secrets.

  5. Em Segredos do cliente, selecione Novo segredo do cliente.Under Client secrets, select New client secret.

  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.In the Add a client secret pop-up window, provide a description for your application secret, select when the application secret expires, and select Add.

  7. Na seção Segredos do cliente, copie a cadeia de caracteres na coluna Valor do segredo do aplicativo recém-criado.From the Client secrets section, copy the string in the Value column of the newly created application secret. O valor do segredo do cliente é a sua ID do cliente.The client secret value is your client ID.

Observação

Copie o valor do segredo do cliente quando aparecer pela primeira vez.Make sure you copy the client secret value when it first appears. Depois de navegar para fora dessa página, o segredo do cliente ficará oculto e você não poderá recuperar seu valor.After navigating away from this page, the client secret will be hidden and you'll not be able to retrieve its value.

ID do workspaceWorkspace ID

Dica

Aplica-se a: Não se aplica a..NET Core Não se aplica a..NET Framework Aplica-se a.React TypeScriptApplies to: Does not apply to..NET Core Does not apply to..NET Framework Applies to.React TypeScript

Para obter o GUID da ID do workspace, siga estas etapas:To get the workspace ID GUID, follow these steps:

  1. Entre no serviço do Power BI.Sign in to Power BI service.

  2. Abra o relatório que deseja inserir.Open the report you want to embed.

  3. Copie o GUID da URL.Copy the GUID from the URL. O GUID é o número entre /groups/ e /reports/ .The GUID is the number between /groups/ and /reports/.

    Uma captura de tela que mostra o GUID da ID do workspace na URL do serviço do Power BI

ID do RelatórioReport ID

Dica

Aplica-se a: Não se aplica a..NET Core Não se aplica a..NET Framework Aplica-se a.ReactTypeScriptApplies to: Does not apply to..NET Core Does not apply to..NET Framework Applies to.ReactTypeScript

Para obter o GUID da ID do relatório, siga estas etapas:To get the report ID GUID, follow these steps:

  1. Entre no serviço do Power BI.Sign in to Power BI service.

  2. Abra o relatório que deseja inserir.Open the report you want to embed.

  3. Copie o GUID da URL.Copy the GUID from the URL. O GUID é o número entre /reports/ e /ReportSection.The GUID is the number between /reports/ and /ReportSection.

    Uma captura de tela que mostra o GUID da ID do relatório na URL do serviço do Power BI

Etapa 5 – Inserir seu conteúdoStep 5 - Embed your content

O aplicativo de exemplo inserido do Power BI permite que você crie um aplicativo inserir para a organização do Power BI.The Power BI embedded sample application allows you to create an embed for your organization Power BI app.

Siga estas etapas para modificar o aplicativo de exemplo inserir para a organização, para inserir o seu relatório do Power BI.Follow these steps to modify the embed for your organization sample application, to embed your Power BI report.

  1. Abra a pasta Exemplos de desenvolvedores do Power BI.Open the Power BI developer samples folder.

  2. Selecione Código e Baixar zip.Select Code and then select Download zip.

    Uma captura de tela que mostra a opção de download do ZIP no GitHub de exemplos do desenvolvedor do Power BI

  3. Extraia o ZIP baixado e navegue até a pasta PowerBI-Developer-Samples-master.Extract the downloaded ZIP and navigate to the PowerBI-Developer-Samples-master folder.

  1. Dependendo do idioma que você deseja que o seu aplicativo use, abra uma destas pastas:Depending on the language you want your application to use, open one of these folders:

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

    Observação

    Os aplicativos de exemplo inserir para a organização dão suporte apenas aos frameworks listados acima.The embed for your organization sample applications only support the frameworks listed above. Os aplicativos de exemplo Java, Node JS e Python dão suporte apenas à solução inserir para os clientes .The Java, Node JS and Python sample applications, only support the embed for your customers solution.

Configurar seu aplicativo do Azure ADConfigure your Azure AD app

  1. Entre no Portal do Azure.Sign into the Azure portal.

  2. Selecione Registros do Aplicativo.Select App registrations. Se não vir essa opção, pesquise por ela.If you can't see this option, search for it.

  3. Abra o aplicativo do Azure AD criado na Etapa 1 – Registrar um aplicativo do Azure AD.Open the Azure AD application you created in Step 1 - Register an Azure AD application.

  4. No menu Gerenciar, selecione Autenticação.From the Manage menu, select Authentication.

  1. Em Configurações da plataforma, abra sua plataforma da Web e, na seção, URIs de Redirecionamento adicione https://localhost:5000/signin-oidc.In Platform configurations, open your Web platform and in the Redirect URIs section, add 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, selecione Web.If you don't have a Web platform, select Add a platform and in the Configure platforms window, select Web.

  2. Salve suas alterações.Save your changes.

Captura de tela mostrando as configurações de autenticação do aplicativo do Azure AD, incluindo o URI de redirecionamento da Web para o aplicativo de exemplo do .NET Core.

Configurar o aplicativo de inserção de exemploConfigure the sample embedding app

  1. Abra a pasta Inserir para a organização.Open the Embed for your organization folder.

  2. Abra o aplicativo de exemplo inserir para a organização usando um destes métodos:Open the embed for your organization sample app using one of these methods:

  3. Abra appsettings.json e preencha os seguintes valores de parâmetro:Open appsettings.json and fill in the following parameter values:

Executar o aplicativo de exemploRun the sample app

  1. Execute o projeto selecionando a opção adequada:Run the project by selecting the appropriate option:

    • Se você estiver usando o Visual Studio, selecione IIS Express (reprodução).If you're using Visual Studio, select IIS Express (play).

    • Se você estiver usando o Visual Studio Code, selecione Executar > Iniciar Depuração.If you're using Visual Studio Code, select Run > Start Debugging.

  1. Entre no aplicativo de exemplo de integração.Sign into the embedding sample application.

    Observação

    Na primeira vez em que entrar, você receberá um prompt para conceder permissões do Azure AD para o aplicativo.During your first sign in, you'll be prompted to allow Azure AD permissions for the app.

  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.When the embedding sample application loads, select the Power BI content you want to embed and then select Embed.

    Captura de tela mostrando o aplicativo de exemplo de integração do Power BI.

Desenvolvendo seu aplicativoDeveloping your application

Depois de configurar e executar a aplicativo de exemplo inserir para os clientes, você pode começar a desenvolver o próprio aplicativo.After configuring and running the embed for your customers sample application, you can start developing your own application.

Quando estiver pronto, examine os requisitos para mover para a produção.When you're ready, review the move to production requirements. Você também precisará de uma capacidade e deve examinar o artigo sobre planejamento da capacidade para estabelecer qual SKU é mais adequado às suas necessidades.You'll also need a capacity, and should review the capacity planning article to establish which SKU best suites your needs.

Próximas etapasNext steps