Inserir um relatório em um site ou portal seguro

Com a opção Inserir para relatórios do Power BI, você pode inserir relatórios em portais Web internos com facilidade e segurança. Esses portais podem ser baseados em nuvem ou hospedados localmente, como o SharePoint 2019. Os relatórios inseridos respeitam todas as permissões de item e a segurança de dados por meio da RLS (segurança em nível de linha) e da OLS (segurança no nível do objeto) do modelo tabular do Analysis Services. Eles fornecem a inserção sem código em qualquer portal que aceite uma URL ou iFrame.

A opção Inserir dá suporte aos filtros de URL e às configurações de URL. Ela permite a integração com portais usando uma abordagem de codificação mínima que requer apenas conhecimentos básicos de HTML e JavaScript.

Como inserir relatórios do Power BI em portais

  1. Abra um relatório no serviço do Power BI.

  2. No menu Arquivo, selecione Inserir relatório>Site ou portal.

    Opção de site ou portal

  3. Na caixa de diálogo código de inserção seguro, selecione o link que você pode usar para inserir esse conteúdo ou o HTML que você pode colar em um blog ou site usando um iFrame.

    Caixa de diálogo da opção Inserir

  4. Quer um usuário abra uma URL de relatório diretamente ou incorporada em um portal da Web, o acesso ao relatório exigirá autenticação. A tela a seguir será exibida se o usuário não tiver entrado no Power BI na sessão atual do navegador. Ao selecionar Entrar, uma nova janela ou guia do navegador poderá ser aberta. Se não for solicitado que o usuário entre, será necessário verificar se há bloqueadores de pop-up ativados.

    Entrar para exibir este relatório

  5. Depois que o usuário entrar, o relatório será aberto e mostrará os dados, permitindo a navegação pelas páginas e a configuração de filtros. Somente os usuários com permissão de exibição poderão ver o relatório no Power BI. Todas as regras de RLS (Segurança em Nível de Linha) também são aplicadas. Por fim, o usuário precisa estar licenciado de modo adequado. Ele precisa de uma licença do Power BI Pro ou PPU (Premium por usuário). Como alternativa, o relatório deverá estar em um workspace com uma capacidade do Power BI Premium. O usuário precisará entrar novamente toda vez que abrir uma nova janela do navegador. No entanto, uma vez conectado, outros relatórios serão carregados automaticamente.

    Inserir relatório

  6. Ao usar um iFrame, talvez seja necessário editar a altura e a largura para que caibam na página da Web do Portal.

    Definir altura e largura

Concedendo acesso ao relatório

A opção Inserir não permite automaticamente que os usuários exibam o relatório. As permissões de exibição são definidas no serviço do Power BI.

No serviço do Power BI, você pode compartilhar relatórios inseridos com usuários que necessitam de acesso. Se estiver usando um grupo do Microsoft 365, você poderá listar o usuário como um membro do workspace. Para obter mais informações, confira como gerenciar seu workspace no Power BI e no Microsoft 365.

Licenças

Os usuários precisam obter uma licença do Power BI Pro ou PPU (Premium por usuário) para ver o relatório inserido. Como alternativa, o conteúdo precisa estar em um workspace com uma capacidade do Power BI Premium (EM ou SKU P).

Personalizar sua experiência de inserção usando configurações de URL

Você pode personalizar a experiência do usuário usando as configurações de entrada da URL de inserção. No iFrame fornecido, você pode atualizar as configurações de src da URL.

Propriedade Descrição
pageName Você pode usar o parâmetro de cadeia de caracteres de consulta pageName para definir qual página do relatório abrir. Você pode encontrar esse valor no final da URL do relatório ao exibi-lo no serviço do Power BI, conforme mostrado abaixo.
Filtros de URL Você pode usar Filtros de URL na URL de inserção recebida da interface do usuário do Power BI para filtrar o conteúdo da inserção. Dessa forma, você pode criar integrações de código baixo tendo apenas experiências básicas em HTML e JavaScript.

Definir qual página é aberta para um relatório inserido

Você pode encontrar o valor do pageName no final da URL do relatório ao exibi-lo no serviço do Power BI.

  1. Abra o relatório no serviço do Power BI em seu navegador da Web e copie a URL da barra de endereço.

    Seção de relatório

  2. Anexe a configuração pageName à URL.

    Anexar pageName

Filtrar o conteúdo do relatório usando filtros de URL

Você pode usar filtros de URL para fornecer diferentes exibições de um relatório. Por exemplo, a URL a seguir filtra o relatório para mostrar dados ao setor de energia.

Usar a combinação de pageName e Filtros de URL pode ser poderosa. Você pode criar experiências usando HTML e JavaScript básicos.

Por exemplo, eis um botão que você pode adicionar a uma página HTML:

<button class="textLarge" onclick='show("ReportSection", "Energy");' style="display: inline-block;">Show Energy</button>

Ao ser pressionado, o botão chama uma função para atualizar o iFrame com uma URL atualizada, que inclui o filtro para o setor de energia.

function show(pageName, filterValue)

{

var newUrl = baseUrl + "&pageName=" + pageName;

if(null != filterValue && "" != filterValue)

{

newUrl += "&$filter=Industries/Industry eq '" + filterValue + "'";

}

//Assumes there's an iFrame on the page with id="iFrame"

var report = document.getElementById("iFrame")

report.src = newUrl;

}

Filtrar

Você pode adicionar quantos botões desejar para criar uma experiência personalizada de código baixo.

Considerações e limitações

  • Os relatórios paginados são compatíveis com cenários de inserção seguros, e os relatórios paginados com parâmetros de URL também são compatíveis. Leia mais sobre como passar parâmetros de relatório em uma URL para um relatório paginado.

  • A inserção segura funciona para relatórios publicados no serviço do Power BI.

  • O usuário precisa entrar para ver o relatório sempre que abrir uma nova janela do navegador.

  • Alguns navegadores exigem que você atualize a página após entrar, especialmente ao usar os modos privado ou incógnito.

  • Você poderá ter problemas se usar versões de navegador sem suporte. O Power BI é compatível com a seguinte lista de navegadores.

  • Não há suporte para o servidor do SharePoint clássico, pois ele requer versões anteriores ao Internet Explorer 11 ou a habilitação do modo de exibição de compatibilidade.

  • Para obter uma experiência de logon único, use a opção Inserir no SharePoint Online ou crie uma integração personalizada usando o método de inserção o usuário possui dados.

  • O recurso de autenticação automática fornecido com a opção Inserir não funciona com a API JavaScript do Power BI. Para a API JavaScript do Power BI, use o método de inserção o usuário possui dados.

  • O tempo de vida do token de autenticação é controlado com base nas configurações do AAD. Quando o token de autenticação expirar, o usuário precisará atualizar o navegador para obter um token de autenticação atualizado. O tempo de vida padrão é de uma hora, mas ele pode ser mais curto ou mais longo na sua organização. Não há capacidade de atualizar automaticamente o token nesse cenário.

Próximas etapas