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:
Dependências do Power BI
Seu próprio locatário do Microsoft Entra.
Uma das seguintes licenças:
Nota
Para passar 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.
- Um SKU equivalente ou superior a um SKU F64. Esta configuração permite que todos os usuários tenham licenças livres.
Dependências de código
SDK do .NET Core 3.1 (ou superior)
Um ambiente de desenvolvimento integrado (IDE). Recomendamos o uso de um dos seguintes IDEs:
Método
Para criar uma incorporação para o aplicativo de exemplo da sua organização , siga estas etapas:
Registre um aplicativo Microsoft Entra.
Crie um espaço de trabalho do Power BI.
Crie e publique um relatório do Power BI.
Obtenha os valores dos parâmetros de incorporação.
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:
Faça login no Fabric.
Selecione Áreas de trabalho.
Selecione + Novo espaço de trabalho.
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:
Abra a pasta de exemplos do GitHub Power BI Desktop.
Selecione Código e, em seguida, selecione Baixar zip.
Extraia o ZIP baixado e navegue até a pasta Relatórios de exemplo .
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:
Faça logon no Microsoft Azure.
Pesquise por Registos de aplicações e selecione a ligação Registos de aplicações.
Selecione o aplicativo Microsoft Entra que você está usando para incorporar seu conteúdo do Power BI.
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:
Faça logon no Microsoft Azure.
Pesquise por Registos de aplicações e selecione a ligação Registos de aplicações.
Selecione o aplicativo Microsoft Entra que você está usando para incorporar seu conteúdo do Power BI.
Em Gerenciar, selecione Certificados & segredos.
Em Segredos do cliente, selecione Novo segredo do cliente.
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.
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:
Iniciar sessão no serviço Power BI.
Abra o relatório que pretende incorporar.
Copie o GUID do URL. O GUID é o número entre /groups/ e /reports/.
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:
Iniciar sessão no serviço Power BI.
Abra o relatório que pretende incorporar.
Copie o GUID do URL. O GUID é o número entre /reports/ e /ReportSection.
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.
Abra a pasta de exemplos do desenvolvedor do Power BI.
Selecione Código e, em seguida, selecione Baixar zip.
Extraia o ZIP baixado e navegue até a pasta PowerBI-Developer-Samples-master .
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
Inicie sessão no Portal do Azure.
Selecione Registos de aplicações. Se não conseguir ver esta opção, pesquise-a.
Abra o aplicativo Microsoft Entra que você criou na Etapa 1 - Registrar um aplicativo Microsoft Entra.
No menu Gerenciar, selecione Autenticação.
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.
Guardar as suas alterações.
Configurar o aplicativo de incorporação de exemplo
Abra a pasta Incorporar para sua organização .
Abra a incorporação para seu aplicativo de exemplo da organização usando um destes métodos:
Se você estiver usando o Visual Studio, abra o arquivo UserOwnsData.sln .
Se você estiver usando o Visual Studio Code, abra a pasta UserOwnsData .
Abra appsettings.json e preencha os seguintes valores de parâmetro:
Execute a aplicação de exemplo
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.
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.
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.
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.