Tutorial: inserir conteúdo do Power BI usando um aplicativo de exemplo da solução inserir para seus clientes

APLICA-SE A: Aplicativo possui dados O usuário possui dados

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:

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.

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:

• Dependências do Power BI

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

  • Para autenticar o seu aplicativo no Power BI, você precisará de um dos seguintes:

    • Entidade de serviço – um objeto da entidade de serviço do Microsoft Entra que permite que o Microsoft Entra ID autentique seu aplicativo.

    • Licença do Power BI Pro – Será o seu usuário mestre e o seu aplicativo o usará para se autenticar no Power BI.

    • Uma licença do Power BI PPU (Premium por usuário) – Será o seu usuário mestre e o seu aplicativo o usará para se autenticar no Power BI.

    Observação

    Para movê-lo para a produção você precisará de uma capacidade.

• Dependências de 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.

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.

Etapa 3 – Criar um workspace do Power BI

O Power BI mantém os seus relatórios, dashboards e blocos em um workspace. Para inserir esses itens, você precisará criá-los e carregá-los em um workspace.

Para criar um workspace, faça o seguinte:

1. Entre no Power BI.

2. Selecione Workspaces.

3. Selecione Criar um workspace.

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.

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 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
ID do Workspace
ID do Relatório
Segredo do cliente
ID do locatário		necessário somente para Node JS
Nome de usuário do Power BI
Senha do Power BI

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

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

   

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.

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.

   

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

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

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

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.

   

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.

   

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 serviço do Power BI.

2. Role até o espaço de trabalho para o qual você deseja habilitar o acesso e, no menu Mais, selecione Acesso do espaço de trabalho.

   

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.

   

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

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

5. Abra a pasta Inserir para os clientes.

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.

Conteúdo relacionado

• Mover para ambiente de produção
• Inserir para a organização
• Repositórios paginados inseridos

Mais perguntas? Perguntar à Comunidade do Power BI.