Configurar integração com o Power BI
Nota
A partir de 12 de outubro de 2022, os portais do Power Apps passam a ser Power Pages. Mais informações: O Microsoft Power Pages está agora em disponibilidade geral (blogue)
Em breve, vamos migrar e unir a documentação dos portais do Power Apps com a documentação do Power Pages.
O Power BI é uma das melhores ferramentas para fornecer conhecimentos aprofundados com visualização simples e interativa. Para ver dashboards e relatórios a partir do Power BI em páginas Web num portal, tem de ativar a visualização do Power BI no centro de administração de portais do Power Apps. Também é possível incorporar dashboards e relatórios criados na nova área de trabalho do Power BI ao ativar a integração de serviço do Power BI Embedded.
Nota
Também pode integrar a CLI do Power BI com o Power Pages. Mais informações: O que é o Power Pages.
Nota
- Tem de ter uma licença Power BI apropriada.
- Para utilizar o serviço Power BI Embedded, tem de ter uma licença adequada do Power BI Embedded. Certifique-se de que analisa o planeamento de capacidade e os preços para o Power BI Embedded. Mais informações: Power BI Embedded FAQs sobre licenciamento.
- Certifique-se de que Incorporar conteúdo em aplicações está Ativado nas suas Definições de programador do inquilino do Power BI. Quando está desativado, um portal não pode compor dashboards ou relatórios do Power BI incorporados.
Ativar visualização do Power BI
Ativar a visualização do Power BI permite-lhe incorporar dashboards e relatórios em páginas Web num portal utilizando a etiqueta Liquid powerbi.
Aceda a Configurar a integração com o Power BI e selecione Ativar visualização do Power BI.
Selecione Ativar na mensagem de confirmação. Enquanto a visualização do Power BI está a ser ativada, o portal irá reiniciar e ficará indisponível durante alguns minutos. Será apresentada uma mensagem quando a visualização do Power BI tiver sido ativada.
Os personalizadores podem agora utilizar a tag Liquid powerbi para incorporar dashboards do Power BI e relatórios em páginas Web num portal. Durante a incorporação do conteúdo do Power BI, os personalizadores podem utilizar parâmetros de filtro para criar vistas personalizadas. Para obter mais informações, consulte etiqueta Liquid powerbi.
Desativar visualização do Power BI
Aceda a Configurar a integração com o Power BI e selecione Desativar visualização do Power BI.
Selecione Desativar na mensagem de confirmação. Enquanto a visualização do Power BI está a ser desativada, o portal irá reiniciar e ficará indisponível durante alguns minutos. Será apresentada uma mensagem quando a visualização do Power BI tiver sido desativada.
Ativar o serviço Power BI Embedded
Ativar o serviço Power BI Embedded permite incorporar dashboards e relatórios criados na nova área de trabalho do Power BI. Os dashboards e os relatórios são incorporados em páginas Web num portal utilizando a etiqueta Liquid powerbi.
Pré-requisitos: antes de ativar o serviço Power BI Embedded, certifique-se de que criou os dashboards e relatórios na nova área de trabalho no Power BI. Depois de criar a área de trabalho, forneça acesso de administrador ao administrador global para que as áreas de trabalho sejam apresentadas no centro de administração de portais do Power Apps. Para mais informações sobre como criar novas áreas de trabalho e adicionar-lhes acesso, consulte Criar novas áreas de trabalho no Power BI.
Nota
Certifique-se de que a visualização do Power BI está ativada para que a etiqueta Liquid powerbi funcione.
Para ativar o serviço Power BI Embedded:
Aceda a Configurar a integração com o Power BI e selecione Ativar serviço Power BI Embedded.
Na janela Ativar a integração com o serviço Power BI Embedded, selecione as áreas de trabalho disponíveis para as quais pretende apresentar os dashboards e relatórios no seu portal. Mova estas áreas de trabalho para a lista Áreas de Trabalho Selecionadas.
Nota
Depois de adicionar áreas de trabalho à lista Áreas de Trabalho Selecionadas, as bases de dados e os relatórios são processados após alguns minutos.
Selecione Ativar. Enquanto o serviço Power BI Embedded está a ser ativado, o portal reinicia e ficará indisponível durante alguns minutos. Uma mensagem é apresentada quando o serviço Power BI Embedded estiver ativado.
Depois de ativar o serviço Power BI Embedded, tem de criar um grupo de segurança e adicioná-lo à sua conta do Power BI. Para mais informações, consulte Criar grupo de segurança e adicionar à conta Power BI.
Criar grupo de segurança e adicionar a conta Power BI
Depois de ativar a integração com o serviço Power BI Embedded, tem de criar um grupo de segurança no Azure Active Directory, adicionar-lhe um membro e, em seguida, adicionar o grupo de segurança no Power BI através do portal de administração do Power BI. Esta configuração permite que os dashboards e relatórios criados em novas áreas de trabalho do Power BI sejam apresentados no portal.
Nota
Tem de iniciar sessão com a mesma conta de Administrador Global que utilizou para ativar o serviço Power BI Embedded.
Passo 1: Criar um grupo de segurança
Inicie sessão no portal do Azure utilizando uma conta de Administrador Global para o diretório.
Selecione Azure Active Directory, Grupos e, em seguida, selecione Novo grupo.
Na página Grupo, introduza as seguintes informações:
Tipo de grupo: Segurança
Nome do grupo: serviço Power BI Embedded do Portal
Descrição do grupo: este grupo de segurança é utilizado para o Portal e para a integração com o serviço Power BI Embedded.
Tipo de associação: Atribuída
Selecione Criar.
Passo 2: Adicionar um membro do grupo
Pré-requisito: antes de adicionar um membro do grupo de segurança, tem de ter o ID da aplicação do portal. O ID está disponível no separador Detalhes do Portal no Centro de administração de portais do Power Apps.
Inicie sessão no portal do Azure utilizando uma conta de Administrador Global para o diretório.
Selecione Azure Active Directory e, em seguida, selecione Grupos.
Na página Grupos – Todos os grupos, procure e selecione o Serviço Power BI Embedded do portal.
Na página Descrição geral do serviço Power BI Embedded do portaç, selecione Membros a partir da área Gerir.
Selecione Adicionar membros e introduza o ID de aplicação do portal na caixa de texto.
Selecione o membro dos resultados de pesquisa e, em seguida, escolha Selecionar.
Passo 3: Configuração do Power BI
Inicie sessão no Power BI utilizando uma conta de Administrador Global para o diretório.
Selecione o ícone Definições na parte superior direito do serviço Power BI e, em seguida, escolha Portal de administração.
Selecione Definições do inquilino.
Na secção Definições de programador, selecione Permitir principais de serviço para utilizar APIs do Power BI.
No campo Grupos de segurança específicos, procure e selecione o grupo Serviço Power BI Embedded do portal.
Selecione Aplicar.
Os personalizadores podem agora utilizar a tag do Liquid powerbi para incorporar dashboards e relatórios do Power BI a partir de novas áreas de trabalho do Power BI em páginas Web num portal. Para utilizar o serviço Power BI Embedded, o tipo de autenticação deve ser especificado como powerbiembedded. Durante a incorporação do conteúdo do Power BI, os personalizadores podem utilizar parâmetros de filtro para criar vistas personalizadas. Para obter mais informações, consulte etiqueta Liquid powerbi.
Gerir o serviço Power BI Embedded
Aceda a Configurar a integração com o Power BI e selecione Gerir serviço Power BI Embedded.
Na janela Gerir a integração com o serviço Power BI Embedded, selecione as áreas de trabalho disponíveis para as quais pretende apresentar os dashboards e relatórios no seu portal. Mova estas áreas de trabalho para a lista Áreas de Trabalho Selecionadas. Também pode remover as áreas de trabalho atualmente utilizadas, movendo-as de volta para as Áreas de Trabalho Disponíveis.
Nota
Após a remoção das áreas de trabalho da lista Áreas de Trabalho Selecionadas, poderá demorar até 1 hora para que as alterações sejam refletidas. Até então, as bases de dados e relatórios são processados no portal sem quaisquer problemas.
Selecione Guardar.
Desativar o serviço Power BI Embedded
Aceda a Configurar a integração com o Power BI e selecione Gerir serviço Power BI Embedded.
Na janela Gerir integração com o serviço Power BI Embedded, selecione Desativar a integração com o serviço Power BI Embedded.
Selecione Guardar.
Na mensagem de confirmação, selecione OK. Enquanto o serviço Power BI Embedded está a ser desativado, o portal irá reiniciar e ficará indisponível durante alguns minutos. Será apresentada uma mensagem quando o serviço do Power BI Embedded tiver sido desativado.
Considerações e limitações
- Os portais com a versão 9.3.4.x ou posteriores suportam as seguintes capacidades:
- Dashboards e relatórios do Azure Analysis Services utilizando ligações dinâmicas. As configurações no local ao Azure Analysis Services não são suportadas.
- Dashboards com segurança baseada em funções.
- Mosaico único com segurança baseada em funções.
- 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 de serviço do Power BI Embedded, consulte Considerações e limitações.
A composição de um relatório do Power BI numa página do portal falha com o seguinte erro:
Ocorreu um erro de configuração ao compor o relatório.
Este problema pode acontecer devido a múltiplas razões, tais como:
- A sua configuração do Power BI Embedded está incorreta.
- A segurança ao nível da linha no Power BI está ativada, mas não passou funções na configuração do componente do Power BI (Definições Avançadas) ou o parâmetro de funções na etiqueta liquid do powerbi.
- A opção Incorporar conteúdo em aplicações nas Definições do Programador do Power BI não está ativado.
Aviso de privacidade
Ao ativar a incorporação de dashboards e mosaicos do Power BI, quando um utilizador incorpora um dashboard ou mosaico do Power BI, o token de autorização do Microsoft Entra ID desse utilizador para o Microsoft Dataverse é utilizado para efetuar a autenticação no serviço do Power BI com uma concessão implícita, proporcionando uma experiência de “início de sessão único” totalmente integrada ao utilizador final.
O administrador pode desativar a incorporação de dashboards e mosaicos do Power BI em qualquer altura de modo a parar a utilização do token de autorização do Dynamics 365 para efetuar a autenticação no serviço do Power BI. A composição dos mosaicos ou dashboards existentes deixa de ser feita para o utilizador final.
O componente ou serviço do Azure envolvido na incorporação de mosaicos do Power BI é descrito em detalhe na secção seguinte.
Nota: Para obter mais informações sobre as ofertas adicionais do serviço do Azure, consulte o Centro de Fidedignidade do Microsoft Azure.
Este serviço disponibiliza o token de autenticação trocado com o serviço Power BI para a autenticação da API e da IU.
Passos seguintes
Adicionar um componente do Power BI a uma página Web através do Studio dos portais
Consulte também
- Adicionar um relatório ou dashboard do Power BI a uma página Web utilizando etiqueta Liquid no portal
- etiqueta Liquid powerbi
- Integração com o Power BI
Nota
Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)
O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).