Configurar a integração com o Power BI

Observação

Desde o dia 12 de outubro de 2022, os portais do Power Apps passaram a ser Power Pages. Mais Informações: O Microsoft Power Pages já está disponível para todos (blog)
Em breve, migraremos e mesclaremos a documentação dos portais do Power Apps com a documentação do Power Pages.

O Power BI é uma das melhores ferramentas para fornecer insights com visualização simples e interativa. Para exibir painéis e relatórios do Power BI em páginas da Web em um portal, você deve habilitar a visualização do Power BI no centro de administração de portais do Power Apps. Você pode também inserir painéis e relatórios criados em um espaço de trabalho do Power BI habilitando a integração do serviço Power BI Embedded.

Observação

Você também pode integrar o Power BI com o Power Pages. Mais informações: O que é o Power Pages.

Observação

• É preciso ter uma licença adequada do Power BI.
• É preciso ter uma licença adequada do Power BI Embedded para usar o serviço Power BI Embedded. Certifique-se de revisar o planejamento da capacidade e os preços para o Power BI Embedded. Para obter mais informações: Perguntas frequentes sobre licenciamento do Power BI Embedded.
• Verifique se Inserir conteúdo em aplicativos está Habilitado no locatário do Power BI Configurações do desenvolvedor. Quando desativado, um portal não pode renderizar painéis ou relatórios inseridos do Power BI.

Habilitar a visualização do Power BI

Habilitar a visualização do Power BI permite que você insira painéis e relatórios em página da Web em um portal usando a marca Liquid powerbi.

1. Abra o Centro de administração de portais do Power Apps.

2. Acesse Configurar integração do Power BI e selecione Habilitar visualização do Power BI.

   

3. Selecione Habilitar na mensagem de confirmação. Durante a habilitação da visualização do Power BI, o portal será reiniciado e ficará indisponível por alguns minutos. Uma mensagem aparecerá quando a visualização do Power BI for habilitada.

Os personalizadores podem usar a marca Liquid powerbi para inserir painéis e relatórios do Power BI em páginas da Web em um portal. Durante a inserção do conteúdo do Power BI, os personalizadores podem usar os parâmetros de filtro para criar exibições personalizadas. Para obter mais informações, consulte marca Liquid powerbi.

Desabilitar a visualização do Power BI

1. Abra o Centro de administração de portais do Power Apps.

2. Acesse Configurar integração do Power BI e selecione Desabilitar visualização do Power BI.

   

3. Selecione Desabilitar na mensagem de confirmação. Durante a desabilitação da visualização do Power BI, o portal será reiniciado e ficará indisponível por alguns minutos. Uma mensagem aparecerá quando a visualização do Power BI for desabilitada.

Habilitar o serviço Power BI Embedded

A habilitação do serviço Power BI Embedded permite que você insira painéis e relatórios criados em um espaço de trabalho do Power BI. Os painéis e relatórios são inseridos em páginas da Web em um portal usando a marca Liquid powerbi.

Pré-requisitos: antes de habilitar serviço Power BI Embedded, verifique se você criou os painéis e relatórios no novo espaço de trabalho no Power BI. Depois que criar o espaço de trabalho, forneça acesso do administrador ao administrador global para que os espaços de trabalho sejam exibidos no centro de administração dos portais do Power Apps. Para obter mais informações sobre como criar novos espaços de trabalho e adicionar acesso a eles, consulte Criar os novos espaços de trabalho no Power BI.

Observação

Verifique se a visualização do Power BI está habilitada para que a marca Liquid powerbi funcione.

Para habilitar o serviço do Power BI Embedded:

1. Abra o Centro de administração de portais do Power Apps.

2. Acesse Configurar integração do Power BI e selecione Habilitar serviço do Power BI Embedded.

   

3. Na janela Habilitar a integração do serviço Power BI Embedded, selecione os espaços de trabalho disponíveis dos quais os painéis e relatórios devem ser exibidos em seu portal. Mova esses espaços de trabalho para a lista Espaços de Trabalho Selecionados.

   

   Observação

   Depois que você adicionar espaços de trabalho à lista Espaços de Trabalho Selecionados, os bancos de dados e os relatórios serão renderizados após alguns minutos.

4. Selecione Habilitar. Enquanto o serviço Power BI Embedded estiver sendo habilitado, o portal será reiniciado e ficará indisponível por alguns minutos. Uma mensagem será exibida quando o serviço Power BI Embedded for habilitado.

Após habilitar o serviço do Power BI Embedded, você deve criar um grupo de segurança e adicioná-lo à conta do Power BI. Para obter mais informações, consulte Criar grupo de segurança e adicioná-lo à conta do Power BI.

Criar grupo de segurança e adicioná-lo à conta do Power BI

Depois que habilitar a integração do serviço Power BI Embedded, você deverá criar um grupo de segurança no Azure Active Directory, adicionar um membro a ele e depois adicionar o grupo de segurança ao Power BI por meio do portal de administração do Power BI. Essa configuração permite que os painéis e relatórios criados em novos espaços de trabalho do Power BI sejam exibidos no portal.

Observação

Você deve entrar com a mesma conta de administrador global usado para habilitar o serviço Power BI Embedded.

Etapa 1: Criar um grupo de segurança

1. Entre no portal do Azure usando uma conta de administrador global do diretório.

2. Selecione Azure Active Directory, Grupos e então Novo grupo.

3. Na página Grupo, insira as seguintes informações:

   • Tipo de grupo: segurança

   • Nome de grupo: serviço do Power BI Embedded do portal

   • Descrição do grupo: esse grupo de segurança é usado para o Portal e para a integração do serviço Power BI Embedded.

   • Tipo de associação: atribuído

     

4. Selecione Criar.

Etapa 2: Adicionar um membro do grupo

Pré-requisito: antes de adicionar um membro ao grupo de segurança, é necessário ter a ID de aplicativo do portal. A ID está disponível na guia Detalhes do Portal no centro de administração de portais do Power Apps.

1. Entre no portal do Azure usando uma conta de administrador global do diretório.

2. Selecione Azure Active Directory e então Grupos.

3. Na página Grupos – Todos os grupos, procure e selecione o grupo Serviço Power BI Embedded do portal.

   

4. Na página Visão geral do Serviço Power BI Embedded do portal, selecione Membros na área Gerenciar.

5. Selecione Adicionar membros e insira a ID de aplicativo do portal na caixa de texto.

6. Selecione o membro nos resultados da pesquisa e escolha Selecionar.

   

Etapa 3: Instalação do Power BI

1. Entre no Power BI usando uma conta de administrador global do diretório.

2. Selecione o ícone Configurações na parte superior direita do serviço do Power BI e selecione Portal de administração.

   

3. Selecione Configurações de locatário.

4. Na seção Configurações do desenvolvedor, selecione Permitir que as entidades de serviço usem APIs do Power BI.

5. No campo Especificar grupos de segurança, procure e selecione o grupo Serviço do portal do Power BI Embedded.

   

6. Selecione Aplicar.

Os personalizadores agora podem usar amarca Liquid powerbi para inserir painéis e relatórios do Power BI de novos espaços de trabalho do Power BI em páginas da Web em um portal. Para usar o serviço Power BI Embedded, o tipo de autenticação deve ser especificado como powerbiembedded. Durante a inserção do conteúdo do Power BI, os personalizadores podem usar os parâmetros de filtro para criar exibições personalizadas. Para obter mais informações, consulte marca Liquid powerbi.

Gerenciar o serviço Power BI Embedded

1. Abra o Centro de administração de portais do Power Apps.

2. Acesse Configurar integração do Power BI e selecione Gerenciar serviço do Power BI Embedded.

   

3. Na janela Gerenciar a integração do serviço Power BI Embedded, selecione os espaços de trabalho disponíveis dos quais os painéis e relatórios devem ser exibidos em seu portal. Mova esses espaços de trabalho para a lista Espaços de Trabalho Selecionados. Você também pode remover os espaços de trabalho usados atualmente movendo-os de volta para Espaços de Trabalho Disponíveis.

   

   Observação

   Após a remoção dos espaços de trabalho da lista Espaços de Trabalho Selecionados, poderá levar até hora 1 para que as alterações sejam refletidas. Até lá, os bancos de dados e os relatórios serão renderizados no portal sem problemas.

4. Selecione Salvar.

Desabilitar serviço Power BI Embedded

1. Abra o Centro de administração de portais do Power Apps.

2. Acesse Configurar integração do Power BI e selecione Gerenciar serviço do Power BI Embedded.

   

3. Na janela Gerenciar integração do serviço Power BI Embedded, selecione Desabilitar a integração do serviço Power BI Embedded.

   

4. Selecione Salvar.

5. Selecione OK na mensagem de confirmação. Durante a desabilitação do serviço do Power BI Embedded, o portal será reiniciado e ficará indisponível por alguns minutos. Uma mensagem aparecerá quando o serviço do Power BI Embedded for desabilitado.

Considerações e limitações

• Portais com versão 9.3.4.x ou posterior são compatíveis com os seguintes recursos:
  • Painéis e relatórios do Azure Analysis Services usando conexões ao vivo. As configurações do Azure Analysis Services local não têm suporte.
  • Painéis com segurança baseada em função.
  • Bloco único com segurança baseada em função.
• A funcionalidade de visualização do Power BI não está disponível na região da China para autenticação do Azure Active Directory.
• Para obter mais informações sobre as limitações do serviço Power BI Embedded, consulte Considerações e limitações.

Falha ao renderizar um relatório do Power BI em uma página do portal com o seguinte erro:

Ocorreu um erro de configuração durante a renderização do seu relatório.

Esse problema pode ocorrer por vários motivos, tais como:

• Sua Configuração do Power BI Embedded está incorreta.
• Segurança de nível de linha no Power BI está habilitado, mas você não passou as funções na Configuração de componente do Power BI (Configurações avançadas), ou parâmetro funções na marca Líquida do powerbi.
• Inserir conteúdo em aplicativos em Power BI Configurações do Desenvolvedor não está habilitado.

Aviso de privacidade

Ao habilitar a inserção de blocos e painéis do Power BI, quando um usuário inserir um bloco ou painel do Power BI, o token de autorização do Microsoft Entra ID desse usuário para o Microsoft Dataverse será usado para autenticação com o serviço do Power BI com uma concessão implícita, oferecendo uma experiência integrada de "logon único" para o usuário final.

Um administrador pode desabilitar a inserção de blocos e painéis do Power BI a qualquer momento para interromper o uso do token de autorização do Dynamics 365 para autenticação com o serviço do Power BI. A renderização dos blocos ou painéis existentes será interrompida para o usuário final.

O componente ou o serviço do Azure que está envolvido com a inserção de blocos do Power BI é descrito detalhadamente na seção a seguir.

Observação: para obter mais informações sobre ofertas de serviço adicionais do Azure, consulte a Central de Confiabilidade do Microsoft Azure.

Microsoft Entra ID

Esse serviço fornece o token de autenticação trocado com o serviço do Power BI para autenticação de API e IU.

Próximas etapas

Adicionar um componente do Power BI a uma página da Web usando os portais do Studio

Consulte também

• Adicionar um relatório ou painel do Power BI a uma página da Web usando uma marca líquida no portal
• marca Líquida do powerbi
• Integração com o Power BI

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).