Configurar o Power BI Embedded

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

Para começar a usar Power BI Embedded a fim de compartilhar seus relatórios com outras pessoas, use a Ferramenta de configuração de análise integrada do Power BI para começar. Este artigo mostra como fazer isso.

Para usar a análise integrada do Power BI, você precisa registrar um aplicativo do Microsoft Entra no Azure. O aplicativo do Microsoft Entra estabelece permissões para os recursos REST do Power BI e permite o acesso às APIs REST do Power BI.

Pré-requisito

Para configurar um ambiente de análise integrada do Power BI, você precisa de um dos seguintes itens:

Antes de começar

Antes de registrar seu aplicativo, decida qual das seguintes soluções melhor atende às suas necessidades:

Inserir para seus clientes

Use a solução inserir para seus clientes, também conhecida como dados de propriedade do aplicativo, se você criar um aplicativo projetado para seus clientes. Os usuários não precisam entrar ou ter uma licença do Power BI para usar seu aplicativo. Seu aplicativo é autenticado no Power BI usando uma conta de usuário mestre (uma licença de Power BI Pro usada para fazer login nele) ou uma entidade de serviço.

Geralmente, a solução de inserção para seus clientes é usada por ISVs (fornecedores independentes de software) e por desenvolvedores criando aplicativos para terceiros.

Inserir para a organização

Use a solução inserir a sua organização, também conhecida como o usuário tem dados, se criar um aplicativo que exigirá que os usuários usem suas credenciais para autenticação 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.

Para obter mais informações sobre as duas soluções, confira O que são as soluções de análise integrada do Power BI?.

Configure seu ambiente

Depois de entender as duas opções de inserção, você pode usar a ferramenta de instalação para criar seu ambiente do Power BI Embedded.

Se preferir configurar manualmente seu ambiente, pule as etapas nas seções a seguir. Em vez disso, siga as etapas em Registro manual, posteriormente neste artigo.

Importante

Se você está inserindo um GCC, siga as instruções em Registro manual.

Para usar a ferramenta para configurar seu ambiente, acesse a ferramenta de Configuração de análise integrada do Power BI. Selecione a opção de inserção desejada.

Screenshot of the Power BI embedded analytics setup tool. The options for embedding for your customers or for your organization are highlighted.

Etapa 1 – Entrar no Power BI

  1. Em Etapa 1 na ferramenta de instalação, selecione Entrar. Essa etapa o conectará ao Power BI. Se for solicitado que você escolha uma conta, entre com um usuário que pertença ao seu locatário do Power BI. O aplicativo do Microsoft Entra é registrado para esse usuário.

    Screenshot of the Power BI embedded analytics setup tool. Under Step 1, the Sign in button is highlighted.

    Observação

    Se já está conectado, confirme se você entrou com o usuário que deseja usar para criar o aplicativo Microsoft Entra. Para alterar os usuários, selecione sair. Depois que a ferramenta for reiniciada, entre com o usuário correto.

  2. Escolha Avançar para passar para a próxima etapa.

    Screenshot of the Power BI embedded analytics setup tool after a user has signed in to Power BI. The Next button in highlighted.

Etapa 2 – Registrar seu aplicativo

Nessa etapa, você registrará um aplicativo Microsoft Entra no Azure. O aplicativo do Microsoft Entra estabelece permissões para os recursos REST do Power BI e permite o acesso às APIs REST do Power BI. Você pode alterar essas configurações posteriormente quando quiser.

  1. Para registrar seu aplicativo para seus clientes, preencha os seguintes campos:

    Screenshot of the Power BI embedded analytics setup tool. The step for registering an app is visible, with an app name box and API access options.

  2. Selecione Registrar.

  3. A ID do Aplicativo de seu aplicativo do Microsoft Entra é exibida na caixa Resumo. Copie o valor para uso posterior.

    Screenshot of the Power BI embedded analytics setup tool, with a Summary box on the right. Information in the box includes an application ID.

Etapa 3 – Criar um workspace (opcional)

Crie um workspace no serviço do Power BI:

  • Se já tiver um workspace do Power BI, selecione Ignorar.

  • Para criar um workspace, dê um nome para ele e selecione Criar workspace. O nome e a ID do workspace aparecem na caixa Resumo. Copie esses valores para uso posterior.

    Dica

    Para que o aplicativo de amostra de análise integrada funcione conforme o esperado, você deve usar a ferramenta para criar um workspace.

Etapa 4 – Importar conteúdo (opcional)

Selecione uma das seguintes opções:

  • Se tiver seu próprio aplicativo do Power BI, você poderá selecionar Ignorar.

  • Para criar um aplicativo de exemplo do Power BI usando um relatório de exemplo, selecione Relatório de exemplo do Power BI e selecione Importar.

  • Para criar um aplicativo de exemplo do Power BI usando seu próprio relatório, selecione Carregar um arquivo .pbix, pesquise pelo arquivo e selecione Importar.

Etapa 5 – conceder permissões (Inserir para seus clientes apenas)

Selecione Conceder permissões e, na caixa de diálogo, selecione Aceitar. Essa etapa permite que o aplicativo do Microsoft Entra acesse as APIs selecionadas (também conhecidas como escopos) com o usuário conectado. Esse usuário também é conhecido como usuário mestre.

Baixe o aplicativo de exemplo (opcional)

Se você criou um workspace do Power BI e carregou conteúdo nele usando a ferramenta, agora você pode selecionar Baixar aplicativo de exemplo.

Observação

Se tiver ignorado os estágios opcionais, você ainda poderá baixar um aplicativo de exemplo do Power BI. No entanto, o código no aplicativo baixado não possui as propriedades que são preenchidas durante o registro. Por exemplo, se você não criar um workspace, o aplicativo de exemplo não incluirá a ID dele.

Copie todas as informações na caixa Resumo. Seu ambiente de inserção do Power BI está pronto para uso.

Registro manual

Se você não usou a ferramenta de configuração de análise integrada do Power BI, use o procedimento nesta seção para registrar manualmente um aplicativo do Microsoft Entra. Essas etapas são destinadas somente a quem está uma das seguintes soluções:

  • Um aplicativo inserir para a organização
  • Um aplicativo inserir para os clientes com uma entidade de serviço

Para obter mais informações sobre como registrar aplicativos no Microsoft Entra ID, confira Registrar um aplicativo com a plataforma de identidade da Microsoft.

  1. Entre no portal do Azure.

  2. Selecione o locatário do Microsoft Entra selecionando sua conta no canto superior direito da página.

  3. Selecione Registros do Aplicativo. Se não vir essa opção, pesquise por ela.

  4. Em Registros de aplicativo, selecione Novo registro.

  5. Preencha os campos a seguir:

    • Nome – dê um nome ao aplicativo.

    • Tipo de conta com suporte – selecione quem pode usar o aplicativo.

  6. (Opcional) Na caixa URI de redirecionamento, adicione uma URL de redirecionamento.

  7. Selecione Registrar. Após o aplicativo ser registrado, você é direcionado para a página de visão geral dele, em que pode obter a ID do Aplicativo.

Mais perguntas? Experimente perguntar à Comunidade do Power BI.