Incorporar um relatório em um portal ou site seguro
Com a opção Incorporar para relatórios do Power BI, você pode incorporar relatórios de forma fácil e segura em portais da Web internos. Esses portais podem ser baseados na nuvem ou hospedados localmente, como o SharePoint 2019. Os relatórios incorporados respeitam todas as permissões de item e segurança de dados por meio da segurança em nível de linha (RLS) e da segurança no nível de objeto (OLS) do modelo tabular do Analysis Services. Eles fornecem incorporação sem código em qualquer portal que aceite um URL ou iframe.
A opção Incorporar suporta filtros de URL e configurações de URL. Ele permite que você se integre com portais usando uma abordagem low-code que requer apenas conhecimento básico de HTML e JavaScript.
Importante
Devido às atualizações de segurança contínuas do Chromium, a opção Incorporar já não funciona exatamente como antes, e os utilizadores podem ser solicitados a autenticar-se mais do que uma vez. Para resolver isso, considere criar sua própria solução incorporada do Power BI.
Como incorporar relatórios do Power BI em portais
Abra um relatório no serviço do Power BI.
No menu Arquivo, selecione Incorporar relatório>Site ou portal.
Na caixa de diálogo Código de incorporação seguro, selecione o valor em Aqui está um link que você pode usar para incorporar esse conteúdo. Ou se você quiser usar um iframe em um blog ou site, selecione o valor em HTML que você pode colar em um site.
Se um usuário abre uma URL de relatório diretamente ou uma que está incorporada em um portal da Web, o acesso ao relatório requer autenticação. A tela a seguir será exibida se um usuário não tiver entrado no Power BI em sua sessão do navegador. Quando selecionam Iniciar sessão, deve abrir-se uma nova janela ou separador do browser. Peça-lhes que verifiquem se existem bloqueadores de pop-ups se não lhes for pedido para iniciar sessão.
Depois que o usuário faz login, o relatório é aberto, mostrando os dados e permitindo a navegação na página e a configuração do filtro. Somente os usuários com permissão de exibição podem ver o relatório no Power BI. Todas as regras de segurança em nível de linha (RLS) também são aplicadas. Os usuários precisam ser licenciados corretamente. Eles precisam de uma licença do Power BI Pro ou Premium Por Usuário (PPU) ou o conteúdo precisa estar em um espaço de trabalho que esteja em uma capacidade do Power BI Premium. Os utilizadores têm de iniciar sessão sempre que abrem uma nova janela do browser. No entanto, depois de entrarem, outros relatórios são carregados automaticamente.
Quando você usa um iframe, talvez seja necessário editar os valores de altura e largura para que ele caiba na página da Web do seu portal.
Conceder acesso ao relatório
A opção Incorporar não permite automaticamente que os usuários visualizem o relatório. As permissões de exibição são definidas no serviço do Power BI.
No serviço Power BI, você pode compartilhar relatórios incorporados com usuários que precisam de acesso. Se você usar um grupo do Microsoft 365, poderá listar o usuário como um membro do espaço de trabalho.
Licenciamento
Para exibir o relatório incorporado, você precisa de uma licença do Power BI Pro ou Premium por usuário (PPU). Ou, o conteúdo precisa estar em um espaço de trabalho que esteja em uma capacidade do Power BI Premium (EM ou P SKU).
Personalize sua experiência de incorporação usando as configurações de URL
Você pode personalizar a experiência do usuário usando as configurações de entrada da URL de incorporação. No iframe fornecido, você pode atualizar as configurações src da URL.
| Property | Description |
|---|---|
| nome_página | Você pode usar o parâmetro de cadeia de caracteres de consulta pageName para definir qual página de relatório abrir. Você pode encontrar esse valor no final da URL do relatório ao exibir um relatório no serviço do Power BI, conforme mostrado posteriormente neste artigo. |
| Filtros de URL | Você pode usar Filtros de URL na URL de incorporação recebida da interface do usuário do Power BI para filtrar o conteúdo incorporado. Dessa forma, você pode criar integrações low-code apenas com a experiência básica em HTML e JavaScript. |
Definir qual página abre para um relatório incorporado
Você pode encontrar o valor pageName no final da URL do relatório ao exibir um relatório no serviço do Power BI.
Abra o relatório do serviço Power BI no navegador da Web e copie a URL da barra de endereço.
Anexe a propriedade pageName e seu valor ao final da URL.
Filtrar conteúdo de relatório usando filtros de URL
Você pode usar filtros de URL para fornecer diferentes exibições de relatório. Por exemplo, o URL a seguir filtra o relatório para mostrar dados para o setor de energia.
Usar a combinação de pageName e filtros de URL pode ser poderoso. Você pode criar experiências usando HTML e JavaScript básicos.
Por exemplo, aqui está 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>
Quando selecionado, o botão chama uma função para atualizar o iframe com um URL atualizado, que inclui o filtro da indústria 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;
}
Você pode adicionar quantos botões quiser para criar uma experiência personalizada low-code.
Considerações e limitações
Relatórios paginados são suportados com cenários de incorporação segura e relatórios paginados com parâmetros de URL também são suportados. Para obter mais informações, consulte Passar um parâmetro de relatório em uma URL para um relatório paginado no Power BI.
A opção de incorporação segura funciona para relatórios publicados no serviço do Power BI.
Para hospedar conteúdo incorporado com segurança, os usuários devem usar HTTPS para sua página de nível superior. Não há suporte para o uso de uma página de host não segura para acessar conteúdo incorporado com segurança.
O usuário precisa entrar para visualizar o relatório sempre que abrir uma nova janela ou guia do navegador.
Para autenticação, os usuários precisam ter janelas pop-up habilitadas.
Se os usuários acessaram relatórios com êxito no passado, mas agora estão encontrando problemas, eles devem limpar o cache do navegador.
Alguns navegadores exigem que atualize a página após o início de sessão, especialmente quando utiliza os modos InPrivate ou de navegação anónima.
Poderá encontrar problemas se utilizar versões de browser não suportadas. Para obter uma lista de browsers suportados pelo Power BI, consulte Browsers suportados para o Power BI.
Se o seu site definir o cabeçalho Cross-Origin-Opener-Policy (COOP) como "mesma origem", você não poderá fazer login para exibir o conteúdo incorporado porque o MSAL não suporta esse cabeçalho. Em vez disso, escolha "restrict-properties" (para navegadores baseados no Chromium) ou "same-origin-allow-popups". Como alternativa, se não for possível alterar a política Cross-Origin-Opener, vincule-se diretamente ao URL incorporado em vez de incorporá-lo em um iframe.
O SharePoint Server clássico não é suportado, porque requer versões do Internet Explorer anteriores a 11 ou habilitando o modo de exibição de compatibilidade.
Para obter uma experiência de logon único, use a opção Incorporar no SharePoint Online ou crie uma integração personalizada usando o método de incorporação de dados de propriedade do usuário.
Os recursos de autenticação automática fornecidos com a opção Incorporar não funcionam com a API JavaScript do Power BI. Eles são bloqueados no SDK do cliente incorporado PBI a partir da versão 2.10.4. Para a API JavaScript do Power BI, use o método de incorporação de dados de propriedade do usuário.
Os recursos de autenticação automática não funcionam quando estão incorporados em aplicativos, inclusive em aplicativos móveis e de desktop.
O tempo de vida do token de autenticação é controlado com base nas configurações do Microsoft Entra. Quando o token de autenticação expirar, o usuário precisará entrar novamente para obter um token de autenticação atualizado. O tempo de vida padrão é de uma hora, mas pode ser mais curto ou mais longo na sua organização. Não é possível atualizar automaticamente o token neste cenário.