Tutorial: Inserir conteúdo do Power BI usando um exemplo de inserção para o aplicativo de clientes

  • Artigo

APLICA-SE A: Os dados pertencem ao aplicativo Os dados pertencem ao usuário

A Análise integrada e o Power BI Embedded (a oferta do Azure) permitem que você insira conteúdo do Power BI, como relatórios, dashboards e blocos, no seu aplicativo.

Neste tutorial, você aprenderá a:

  • Configure o seu ambiente inserido.
  • Configure um aplicativo de exemplo inserir para os clientes (também conhecido como aplicativo proprietário dos dados).

Para usar o seu aplicativo, os usuários não precisarão entrar no Power BI ou ter uma licença do Power BI.

Será recomendável usar o método inserir para os clientes para inserir o seu conteúdo do Power BI, se você for um ISV (fornecedor independente de software) ou um desenvolvedor que deseja criar aplicativos para terceiros.

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 os clientes em um dos seguintes frameworks:

  • .NET Framework
  • .NET Core
  • Java
  • Node JS
  • Python

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:

Método

Para criar um aplicativo de exemplo inserir para os clientes, siga estas etapas:

  1. Selecione um método de autenticação.

  2. Registrar um aplicativo do Microsoft Entra.

  3. Crie um workspace do Power BI.

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

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

  6. Acesso à API da entidade de serviço

  7. Habilite o acesso ao workspace.

  8. Insira o conteúdo.

Etapa 1 – Selecionar um método de autenticação

A sua solução inserida será diferente de acordo com o método de autenticação selecionado. Portanto, é importante entender as diferenças entre os métodos de autenticação e decidir qual deles é mais adequado à sua solução.

A tabela a seguir descreve algumas diferenças importantes entre os métodos de autenticação da entidade de serviço e do usuário mestre.

Consideração Entidade de serviço Usuário mestre
Mecanismo O objeto de entidade de serviço do seu aplicativo do Microsoft Entra permite que o Microsoft Entra ID autentique o seu aplicativo de solução inserido no Power BI. O seu aplicativo do Microsoft Entra usa as credenciais (nome de usuário e senha) de um usuário do Power BI para se autenticar no Power BI.
Segurança A entidade de serviço é o método de autorização recomendado do Microsoft Entra ID. Se você estiver usando uma entidade de serviço, poderá autenticar usando um segredo de aplicativo ou um certificado.

Este tutorial descreve apenas o uso da entidade de serviço com um segredo de aplicativo. Para inserir usando uma entidade de serviço e um certificado, confira o artigo Entidade de serviço com um certificado.		 Esse método de autenticação não é tão seguro quanto uma entidade de serviço. Você precisa estar atento às credenciais do usuário mestre (nome de usuário e senha). Por exemplo, não as exponha no seu aplicativo de inserção e altere a senha com frequência.
Permissões delegadas do Microsoft Entra ID Não necessário. O usuário mestre ou um administrador precisam consentir que o seu aplicativo acesse as permissões de API REST do Power BI (também conhecidas como escopos). Por exemplo, Report.ReadWrite.All.
Acesso ao serviço do Power BI Você não pode acessar um serviço do Power BI com uma entidade de serviço. Você pode acessar um serviço do Power BI com as suas credenciais de usuário mestre.
Licença Não requer uma licença Pro. Você pode usar o conteúdo de qualquer workspace do qual você é membro ou administrador. Exige obter uma licença do Power BI Pro ou PPU (Premium por usuário).

Etapa 2 – Registrar um aplicativo do Microsoft Entra

Registrar o seu aplicativo com o Microsoft Entra ID permite que você:

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

Observação

Antes de registrar o seu aplicativo, você precisará decidir qual método de autenticação usar, entidade de serviço ou usuário mestre.

Etapa 3 – 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 4 – 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.

    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.

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

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

Para inserir o seu conteúdo, você precisará obter determinados valores de parâmetro. A tabela abaixo mostra os valores necessários e indica se eles se aplicam ao método de autenticação da entidade de serviço, ao método de autenticação do usuário mestre ou a ambos.

Antes de inserir o conteúdo, verifique se você tem todos os valores listados abaixo. Alguns dos valores poderão ser diferentes, dependendo do método de autenticação que estiver sendo usado.

Parâmetro Entidade de serviço Usuário mestre
ID do Cliente Aplica-se a. Aplica-se a.
ID do Workspace Aplica-se a. Aplica-se a.
ID do Relatório Aplica-se a. Aplica-se a.
Segredo do cliente Aplica-se a. Não se aplica a.
ID do locatário Aplica-se a. necessário somente para Node JS
Nome de usuário do Power BI Não se aplica a. Aplica-se a.
Senha do Power BI Não se aplica a. Aplica-se a.

ID do Cliente

Dica

Aplica-se a: Aplica-se a.Usuário mestre da entidade de serviço Aplica-se a.

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

ID do workspace

Dica

Aplica-se a: Aplica-se a.Usuário mestre da entidade de serviço Aplica-se a.

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

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

Como alternativa, você pode encontrar a ID do workspace nas configurações do portal de Administração selecionando Detalhes ao lado do nome do workspace.

Uma captura de tela mostrando como localizar a ID do workspace nas configurações de administrador.

ID do Relatório

Dica

Aplica-se a: Aplica-se a.Usuário mestre da entidade de serviço Aplica-se a.

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.

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

Segredo do cliente

Dica

Aplica-se a: Aplica-se a.Usuário mestre da entidade de serviço Não se aplica a.

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 locatário

Dica

Aplica-se a: Aplica-se a.Usuário mestre da entidade de serviço Não se aplica a.

Para obter o GUID da ID do locatário, 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 diretório (locatário) .

Nome de usuário e senha do Power BI

Dica

Aplica-se a: Não se aplica a.Usuário mestre da entidade de serviço Aplica-se a.

Obtenha o nome de usuário e a senha do usuário do Power BI que você está usando como usuário mestre. Esse é o mesmo usuário usado no serviço do Power BI para criar um workspace e carregar um relatório.

Etapa 6 – Acesso à API da entidade de serviço

Dica

Aplica-se a: Aplica-se a.Usuário mestre da entidade de serviço Não se aplica a.

Esta etapa só será relevante se você estiver usando o método de autenticação entidade de serviço. Se você estiver usando um usuário mestre, ignore esta etapa e continue com Etapa 7 – Habilitar o acesso ao workspace.

Para que um aplicativo do Microsoft Entra possa acessar o conteúdo e as APIs do Power BI, um administrador de Power BI precisa habilitar o acesso à entidade de serviço no portal de administração do Power BI. Se você não for o administrador do seu locatário, peça ao administrador do locatário que habilite as Configurações de locatário para você.

  1. Em Serviço do Power BI, selecione Configurações>Configurações>Portal de administração.

    Uma captura de tela que mostra a opção de menu configurações de administrador no menu de configurações do serviço do Power BI.

  2. Selecione Configurações de locatário e role para baixo até a seção Configurações do desenvolvedor.

  3. Expanda Entidades de serviço podem usar APIs do Fabric e habilite essa opção.

    Uma captura de tela que mostra como habilitar a opção de configurações do desenvolvedor, na opção de menu configurações de locatário, no serviço do Power BI.

Observação

Ao usar uma entidade de serviço, é recomendável limitar o acesso às configurações de locatário usando um grupo de segurança. Para saber mais sobre esse recurso, confira estas seções no artigo da entidade de serviço:

Etapa 7 – Habilitar o acesso ao workspace

Para habilitar seus objetos de acesso de aplicativo do Microsoft Entra, como relatórios, painéis e modelos semânticos no serviço do Power BI, adicione a entidade de serviço ou usuário mestre, como um membro ou administrador no seu espaço de trabalho.

  1. Entre no Fabric.

  2. Role até o workspace para o qual você deseja habilitar o acesso e selecione Gerenciar acesso.

    Captura de tela mostrando o botão de acesso do workspace no menu Mais de um workspace do Power BI.

  3. No painel Acesso, dependendo do método de autenticação que você está usando, copie a entidade de serviço ou o usuário mestre na caixa de texto Inserir o endereço de email.

    Observação

    Se você estiver usando uma entidade de serviço, o nome dela será o nome que você atribuiu ao seu aplicativo do Microsoft Entra.

  4. Selecione Adicionar.

Etapa 8 – Inserir o seu conteúdo

O aplicativo de exemplo inserido do Power BI permite que você crie um aplicativo inserir para os clientes do Power BI.

Siga estas etapas para modificar o aplicativo de exemplo inserir para os clientes, 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.

    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.

  1. Dependendo do idioma que você deseja que o seu aplicativo use, abra uma destas pastas:

    • .NET Core
    • .NET Framework
    • Java
    • Node JS
    • Python

    Observação

    Os aplicativos de exemplo inserir para os clientes dão suporte apenas aos frameworks listados acima. O aplicativo de exemplo React dá suporte apenas à solução inserir para a organização .

  2. Abra a pasta Inserir para os clientes.

  1. Abra o aplicativo de exemplo inserir para os clientes usando um destes métodos:

  2. Abra appsettings.json.

  3. Dependendo do seu método de autenticação, preencha os seguintes valores de parâmetro:

    Parâmetro Entidade de serviço Usuário mestre
    AuthenticationMode ServicePrincipal MasterUser
    ClientId Sua ID do cliente do aplicativo do Microsoft Entra Sua ID do cliente do aplicativo do Microsoft Entra
    TenantId Sua ID de locatário do Microsoft Entra N/D
    PbiUsername N/D O seu nome de usuário do usuário mestre, confira Nome de usuário e senha do Power BI
    PbiPassword N/D A sua senha do usuário mestre, confira Nome de usuário e senha do Power BI
    ClientSecret Seu segredo do cliente do Microsoft Entra ID N/D
    WorkspaceId A ID do workspace com o relatório inserido; confira ID do workspace A ID do workspace com o relatório inserido; confira ID do workspace
    ReportId A ID do relatório que você está inserindo; confira ID do relatório A ID do relatório que você está inserindo; confira ID do relatório

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

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

Experimente o playground de análises integradas do Power BI para começar a desenvolver e acompanhar todos os novos recursos e atualizações do Power BI Embedded.

Quando estiver pronto, examine os requisitos para mover para a produção. 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.

Importante

Se você usou tokens de avaliação de inserção gratuitos para desenvolvimento, precisará comprar uma capacidade para produção. Até que uma capacidade seja adquirida, a faixa de versão de avaliação gratuita continuará a aparecer na parte superior do relatório inserido.

Conteúdo relacionado

Mais perguntas? Perguntar à Comunidade do Power BI.