Incorporar um relatório num site ou portal seguroEmbed a report in a secure portal or website

Esta página é útil?

Com o novo incorporação relatórios de opção para o Power BI, pode facilmente e com segurança incorporar relatórios em portais da web interno.With the new Embed option for Power BI reports, you can easily and securely embed reports in internal web portals. Podem ser estes portais baseado na nuvem ou alojadas no local, como o SharePoint 2019.These portals can be cloud-based or hosted on-premises, such as SharePoint 2019. Todos os itens permissões e segurança de dados por meio de respeitam a relatórios incorporados ao nível da linha (RLS) de segurança.Embedded reports respect all item permissions and data security through row-level security (RLS). Eles fornecem sem código de incorporação em qualquer portal que aceita um URL ou um iFrame.They provide no-code embedding into any portal that accepts a URL or iFrame.

O incorporação opção suporta filtros de URL e definições de URL.The Embed option supports URL Filters and URL settings. Ele permite-lhe integrar portais usando uma abordagem de codificação reduzida que requerem apenas conhecimento HTML e JavaScript básico.It allows you to integrate with portals using a low-code approach requiring only basic HTML and JavaScript knowledge.

Como Incorporar relatórios do Power BI em portaisHow to Embed Power BI reports into portals

  1. A nova opção Incorporar está disponível no menu Ficheiro para relatórios no serviço Power BI.The new Embed option is available on the File menu for reports in the Power BI service.

    Opção de menu pendente da opção Incorporar segura

  2. Selecione o incorporação opção de abrir uma caixa de diálogo que fornece uma ligação e um iFrame, pode usar para incorporar o relatório de forma segura.Select the Embed option to open a dialog that provides a link and an iFrame you can use to embed the report securely.

    Caixa de diálogo da opção Incorporar

  3. Se um utilizador abre um URL de relatório diretamente ou um incorporada num web portal, o acesso de relatório requer autenticação.Whether a user opens a report URL directly, or one embedded in a web portal, report access requires authentication. É apresentado o ecrã seguinte se um utilizador não iniciou sessão no Power BI na sua sessão de browser.The following screen appears if a user has not signed-in to Power BI in their browser session. Quando seleciona início de sessão, foi possível abrir uma nova janela do browser ou separador.When they select Sign-In, a new browser window or tab could open. Tê-los a verificar a existência de fatores que impedem a pop-up se eles não recebe o pedido para iniciar sessão.Have them check for pop-up blockers if they don't get prompted to sign in.

    Iniciar sessão para ver este relatório

  4. Depois do utilizador tem sessão iniciada, o relatório é aberto, mostrando os dados e permitindo a navegação de página e a definição de filtro.After the user has signed in, the report opens, showing the data and allowing page navigation and filter setting. Apenas os utilizadores que têm permissão de visualização, podem ver o relatório no Power BI.Only users who have view permission can see the report in Power BI. Todos os ao nível da linha (RLS) de segurança também são aplicadas as regras.All row-level security (RLS) rules are also applied. Por último, o utilizador tem de estar licenciado corretamente, seja porque precisa de uma licença do Power BI Pro ou porque o relatório tem de estar numa área de trabalho que esteja numa capacidade do Power BI Premium.Lastly, the user needs to be correctly licensed – either they need a Power BI Pro license, or the report must be in a workspace that is in a Power BI Premium capacity. O utilizador tem de iniciar sessão sempre que abrem uma nova janela do browser.The user needs to sign in each time they open a new browser window. No entanto, depois de iniciar sessão, outros relatórios carregado automaticamente.However, once signed in, other reports load automatically.

    Incorporar relatório

  5. Ao usar um iFrame, poderá ter de editar a altura e largura para que ela se encaixe na página da web do seu portal.When using an iFrame, you may need to edit the height and width to have it fit in your portal’s web page.

    Definir altura e largura

Conceder acesso de relatórioGranting report access

O incorporação opção automaticamente não permite aos utilizadores ver o relatório.The Embed option doesn't automatically permit users to view the report. Ver permissões são definidas no serviço Power BI.View permissions are set in the Power BI service.

No serviço Power BI, pode partilhar relatórios incorporados com utilizadores que necessitam de acesso.In the Power BI service, you can share embedded reports with users requiring access. Se estiver a utilizar um grupo do Office 365, pode listar o utilizador como membro da área de trabalho de aplicação.If you're using an Office 365 Group, you can list the user as an app workspace member. Para obter mais informações, consulte como gerir a sua área de trabalho de aplicação no Power BI e do Office 365.For more information, see how to manage your app workspace in Power BI and Office 365.

LicensingLicensing

Para ver o relatório incorporado, os utilizadores precisam de qualquer uma licença do Power BI Pro ou os conteúdos precisam de estar numa área de trabalho que está numa capacidade do Power BI Premium (EM ou P SKU).To view the embedded report, users need either a Power BI Pro license or the content needs to be in a workspace that's in a Power BI Premium capacity (EM or P SKU).

Personalizar a experiência de incorporação com definições de URLCustomize your embed experience using URL settings

Pode personalizar a experiência do usuário com as definições de entrada o URL de incorporação.You can customize the user experience using the embed URL's input settings. Em iFrame fornecido, pode atualizar o URL src definições.In the provided iFrame, you can update the URL's src settings.

PropriedadeProperty DescriçãoDescription
pageNamepageName Pode utilizar o pageName consultar o parâmetro de cadeia de caracteres para definir qual página de relatório para abrir.You can use the pageName query string parameter to set which report page to open. Pode encontrar este valor no final do URL do relatório ao visualizar um relatório no serviço Power BI, conforme mostrado abaixo.You can find this value at the report URL's end when viewing a report in the Power BI service, as shown below.
Filtros de URLURL Filters Pode usar filtros de URL no URL de incorporação que recebeu da interface do Usuário do Power BI para filtrar o conteúdo de incorporação.You can use URL Filters in the embed URL you received from the Power BI UI to filter the embed content. Desta forma, pode criar integrações de código reduzido tendo apenas experiência básica de HTML e JavaScript.This way you can build low-code integrations with only basic HTML and JavaScript experience.

Conjunto a página que abre-se para um relatório incorporadoSet which page opens for an embedded report

Pode encontrar os pageName valor no final do URL do relatório ao visualizar um relatório no serviço Power BI.You can find the pageName value at the report URL's end when viewing a report in the Power BI service.

  1. Abra o relatório a partir do serviço Power BI no seu navegador da web e, em seguida, copie o URL da barra de endereço.Open the report from the Power BI service in your web browser, and then copy the address bar URL.

    Secção Relatório

  2. Anexe a definição pageName ao URL.Append the pageName setting to the URL.

    Anexar pageName

Filtrar conteúdo do relatório com filtros de URLFilter report content using URL filters

Pode usar filtros de URL para fornecer vistas de relatório diferente.You can use URL Filters to provide different report views. Por exemplo, o URL abaixo filtra o relatório para mostrar dados do setor da Energia.For example, the URL below filters the report to show data for the Energy industry.

A utilização da combinação de pageName e Filtros de URL pode ser eficiente.Using the combination of pageName and URL Filters can be powerful. Pode criar experiências com HTML e JavaScript básicos.You can build experiences using basic HTML and JavaScript.

Por exemplo, aqui está um botão, que pode adicionar a uma página HTML:For example, here’s a button you can add to an HTML page:

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

Quando selecionada, o botão chama uma função para atualizar a iFrame com um URL atualizada, o que inclui o filtro de setor da energia.When selected, the button calls a function to update the iFrame with an updated URL, which includes the Energy industry filter.

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

Pode adicionar quantos botões quiser para criar uma experiência personalizada com código reduzido.You can add as many buttons as you’d like to create a low-code custom experience.

Considerações e limitaçõesConsiderations and limitations

  • Não suporta utilizadores convidados externos com a capacidade empresa-empresa (B2B) do Azure.Doesn't support external guest users with Azure business to business (B2B).

  • A incorporação segura funciona para os relatórios publicados no serviço Power BI.Secure embed works for reports published to the Power BI service.

  • O utilizador tem de iniciar sessão ver o relatório, sempre que abrirem uma nova janela do browser.The user needs to sign in to view the report whenever they open a new browser window.

  • Alguns browsers requerem que Atualize a página após o início de sessão, especialmente quando se utilizam modos InPrivate ou Incognito.Some browsers require you to refresh the page after sign in, especially when using InPrivate or Incognito modes.

  • Para obter uma experiência de início de sessão único, utilize a incorporação no SharePoint Online opção ou crie uma utilizando a integração personalizada a utilizador detém os dados incorporar o método.To achieve a single sign-on experience, use the Embed in SharePoint Online option, or build a custom integration using the user owns data embedding method.

  • A capacidade de autenticação automática fornecida com a opção Incorporar não funciona com a API de JavaScript do Power BI.The automatic authentication capability provided with the Embed option doesn't work with the Power BI JavaScript API. Para a API de JavaScript do Power BI, utilize o utilizador detém os dados incorporar o método.For the Power BI JavaScript API, use the user owns data embedding method.

Próximos passosNext steps