Adicionar um componente do Power BI

  • Artigo

Você pode adicionar um componente do Power BI em uma página para exibir painéis e relatórios do Power BI em seu portal.

O Power BI deve ser habilitado antes de você começar a adicionar componentes do Power BI. Para obter mais informações, consulte: Configurar a integração do Power BI.

Para adicionar um componente do Power BI a uma página

  1. Abra o estúdio de design para editar o conteúdo e os componentes da sua página.

  2. Selecione a página que deseja editar.

  3. Selecione a seção à qual deseja adicionar o componente do Power BI.

  4. Passe o mouse sobre qualquer área de tela editável e selecione o ícone Power BI no painel do componente.

    As opções do menu adicionar componente.

  5. Selecione Editar para configurar as propriedades apropriadas para exibir seu painel de controle do Power BI.

    Propriedades do Power BI.

  6. No painel de propriedades à direita da tela, insira as seguintes informações:

    1. Tipo de acesso: na lista suspenso, selecione a opção apropriada para seus requisitos de negócios.

      • Inserir para seus clientes
      • Inserir para sua organização
      • Publicar na Web

      1. Inserir para seus clientes – permite compartilhar com segurança os relatórios ou painéis do Power BI com usuários externos sem uma licença do Power BI ou configuração de autenticação do Microsoft Entra. Esta opção usa serviços do Power BI Embedded para integrar painéis ou relatórios do Power BI a seu portal.

        Observação

        Certifique-se de que o serviço do Power BI Embedded esteja habilitado e os respectivos workspaces do Power BI estão selecionados e compartilhados com o criador ou o usuário conectado.

      2. Inserir para sua organização – permite compartilhar com segurança relatórios ou painéis do Power BI com usuários autenticados do Microsoft Entra ID.

        Observação

        Certifique-se de que você tenha compartilhado workspaces do Power BI com o criador e os usuários do portal de destino.

      3. Publicar na Web – permite compartilhar relatórios ou painéis do Power BI com qualquer pessoa na Internet.

      Para obter mais informações sobre os tipos de acesso, acesse considerações sobre o tipo de acesso do Power BI.

    2. Espaço de trabalho: Selecione o espaço de trabalho do Power BI da lista.

    3. Selecionar tipo: Selecione o tipo como Painel ou o Relatório da lista.

      • Painel – permite que você escolha um Painel e então um Bloco no painel selecionado para exibição na página da Web.
      • Relatório – permite que você selecione um Relatório e então uma Página no relatório para exibição na página da Web.

    4. Aplicar funções: se você tiver definido funções no Power BI e as atribuiu a relatórios, será preciso inserir as funções adequadas neste campo.

      • Você pode especificar várias funções separadas por uma vírgula (por exemplo, role_1,role_2). Para obter mais informações sobre como definir funções no Power BI, vá para Segurança de nível de linha (RLS) com o Power BI.
      • Esta opção só está disponível para o tipo de acesso Inserir para seus clientes.

    5. Aplicar filtro : permite ao usuário carregar o relatório com valores pré-filtrados. O usuário pode fornecer uma condição de filtro no campo.

      • O parâmetro de filtro deve estar sem o prefixo ?filter=''. Por exemplo, Table/Field eq 'value'.
        Para mais informações, acesse detalhes do parâmetro de filtro.
      • Esta opção só está disponível para Relatórios com tipos de acesso Inserir para seus clientes e Inserir para sua organização.

    6. URL do código de inserção: insira a URL do código de inserção.

      • Para aprender a criar e gerenciar códigos de inserção, acesse Publicar na Web do Power BI
      • Esta opção só está disponível para o tipo de acesso Publicar na Web.

Considerações sobre o tipo de acesso do Power BI

A lista a seguir explica tipos de acesso do Power BI em resumo e lista as considerações de tipo de acesso para o Power Pages. Para obter mais informações sobre tipos de acesso do Power BI, acesse A diferença entre o serviço Power BI e o Power BI Embedded.

  • Inserir para seus clientes:

    • Mostra a lista de workspaces compartilhados com um usuário atualmente conectado e habilitado para o serviço Power BI Embedded.

    • Usa serviço do Power BI Embedded.

    • Se você já usou o serviço Power BI Embedded com Power Pages antes, receberá uma mensagem de aviso indicando que precisa desativar a visualização do Power BI no centro de administração e ativá-la novamente ao selecionar Inserir para seus clientes:

      Quando esta mensagem aparecer, desabilite e depois habilite a visualização do Power BI novamente.

    • Se você adicionar o Power BI com Inserir para seus clientes em um site disponível anonimamente, qualquer pessoa poderá ver o painel. Para proteger esta página, leia Permissões de página no Power Pages.

  • Inserir para sua organização:

    • Mostra a lista de workspaces compartilhados com um usuário conectado.
    • Usa autenticação do Microsoft Entra.

  • Publicar na Web: qualquer pessoa na Internet pode exibir seu relatório ou visual publicado. Essa opção não requer nenhuma autenticação e inclui a exibição de dados de nível de detalhes que seus relatórios agregam. Antes de publicar um relatório, verifique se não há problema em compartilhar os dados e as visualizações publicamente. Não publique informações confidenciais ou sigilosas. Consulte as políticas da sua organização antes de publicar.

Considerações gerais do Power BI

  • O desempenho do design studio do Power Pages pode diminuir ao trabalhar com espaços de trabalho do Power BI devido aos seguintes motivos:
    • Um alto número de workspaces compartilhados com um usuário conectado.
    • Os espaços de trabalho do Power BI são compartilhados com muitos usuários.
  • A variável Liquid de captura não é suportada no estúdio de design ao trabalhar com um componente do Power BI.
  • Se você excluir um site e provisionar um novo site usando a mesma configuração, será preciso adicionar a ID de aplicativo do site do novo site ao grupo de segurança do Power BI Embedded Serviço do Microsoft Entra no Portal. Para obter mais informações, consulte Configurar a integração do Power BI.
  • Se você fizer uma alteração na seção Power Pages do centro de administração do Power Platform, deverá recarregar o estúdio de design se já o tiver aberto.
  • Adicionar usuários a painéis e relatórios do Power BI pode demorar um pouco para refletir no design studio.
  • Os painéis e relatórios do Power BI conectados a um conjunto de dados compartilhado presente em um espaço de trabalho diferente não têm suporte.
  • Não há suporte para relatórios do Power BI paginados.
  • Se você estiver usando o tipo de acesso do Power BI, Incorporar para seus clientes, para fornecer relatórios e painéis para seus clientes, consulte a biblioteca powerbi-client JavaScript para personalizações avançadas.
  • Se você estiver usando o tipo de acesso do Power BI, Incorporar para sua organização, e quiser ocultar o painel de filtro, consulte ocultar painel de filtro no modo de leitura na documentação do Power BI.

Considerações sobre desempenho e otimização do Power BI

A inserção de múltiplos workspaces do Power BI pode precisar de considerações adicionais. Consulte os seguintes recursos para a solução de problemas, otimização e práticas recomendadas do Power BI Embedded:

Consulte também