Incorporar com peças Web de relatórios no SharePoint OnlineEmbed with report web part in SharePoint Online

Com a nova peça Web de relatórios do Power BI para o SharePoint Online, pode facilmente incorporar relatórios interativos do Power BI em páginas do SharePoint Online.With Power BI's new report web part for SharePoint Online, you can easily embed interactive Power BI reports in SharePoint Online pages.

Ao utilizar a opção nova Incorporar no SharePoint Online, os relatórios incorporados ficam completamente protegidos, para que possa criar facilmente portais internos seguros.When using the new Embed in SharePoint Online option, the embedded reports are fully secure so you can easily create secure internal portals.

RequisitosRequirements

Eis alguns requisitos para que os relatórios Incorporar no SharePoint Online funcionem.There are a few requirements in order for Embed in SharePoint Online reports to work.

Incorporar o seu relatórioEmbed your report

Para incorporar o seu relatório no SharePoint Online, tem primeiro de obter o URL do relatório e, em seguida, utilizar esse URL com a nova peça Web do Power BI no SharePoint Online.In order to embed your report into SharePoint Online, you first need to get the URL for the report and then use that URL with the new Power BI web part within SharePoint Online.

Obter um URL do seu relatórioGet a URL to your report

  1. Veja o relatório no serviço Power BI.View the report within the Power BI service.

  2. Selecione o item de menu Ficheiro.Select the File menu item.

  3. Selecione Incorporar no SharePoint Online.Select Embed in SharePoint Online.

    Menu de Ficheiros

  4. Copie o URL da caixa de diálogo.Copy URL from dialog.

    Incorporar a ligação

Adicionar o relatório do Power BI a uma página do SharePoint OnlineAdd the Power BI report to a SharePoint Online page

  1. Abra a página pretendida no SharePoint Online e selecione Editar.Open the desired page in SharePoint Online and select Edit.

    Página de edições do SP

    Também pode selecionar + Novo, no SharePoint Online, para criar uma página de site moderna nova.Or, create a new modern site page by selecting + New within SharePoint Online.

    Nova página do SP

  2. Selecione + e selecione a peça Web Power BI.Select + and select the Power BI web part.

    Nova peça Web do SP

  3. Selecione Adicionar relatório.Select Add report.

    Novo relatório do SP

  4. Cole o URL do relatório no painel da propriedade.Paste the report URL into the property pane. Este é o URL do relatório que copiou nos passos anteriores.This report URL is the URL you copied from the steps above. O relatório é carregado automaticamente.The report loads automatically.

    Propriedades da nova peça Web do SP

  5. Selecione Publicar para tornar a alteração visível para os seus utilizadores do SharePoint Online.Select Publish to make the change visible to your SharePoint Online users.

    Relatório do SP carregado

Conceder acesso a relatóriosGrant access to reports

Incorporar um relatório no SharePoint Online não dá automaticamente permissão aos utilizadores para ver o relatório.Embedding a report in SharePoint Online does not automatically give users permission to view the report. As permissões para ver o relatório são definidas no serviço Power BI.The permissions to view the report are set within the Power BI service.

Importante

Certifique-se de que revê quem pode ver o relatório no serviço Power BI e conceda acesso aos que não estão listados.Make sure to review who can see the report within the Power BI service and grant access to those not listed.

Existem duas formas de dar acesso ao relatório no serviço Power BI.There are two ways to provide access to the report within the Power BI service. Se estiver a utilizar um Grupo do Office 365 para criar o seu site de equipa do SharePoint Online, deve listar o utilizador como membro da área de trabalho de aplicação no serviço Power BI e da página do SharePoint.If you are using an Office 365 Group to build your SharePoint Online team site, you list the user as a member of the app workspace within the Power BI service and the SharePoint page. Para obter mais informações, veja como gerir uma área de trabalho de aplicação.For more information, see how to manage an app workspace.

Em alternativa, pode partilhar um relatório diretamente com os utilizadores ao incorporar o relatório numa aplicação.Alternatively, you can share a report directly with users by embedding the report within an app. Existem alguns passos a seguir para incorporar um relatório numa aplicação.There are a few steps to follow for embedding a report within an app.

  1. O autor da aplicação é um utilizador Pro.The author of the app is a Pro user.

  2. O autor cria um relatório numa área de trabalho de aplicação.The author creates a report in an app workspace. Para partilhar com utilizadores gratuitos do Power BI, a área de trabalho de aplicação tem de ser definida como uma área de trabalho Premium.To share with Power BI free users, the app workspace needs to be set as a Premium workspace.

  3. O autor publica a aplicação e, em seguida, instala-a.The author publishes the app then installs it. O autor tem de confirmar que instala a aplicação para ter acesso ao URL do relatório utilizado para incorporar no SharePoint Online.The author needs to make sure to install the app to have access to the report URL that is used to embed in SharePoint Online.

  4. Agora, todos os utilizadores finais também têm de instalar a aplicação.Now all end users need to install the app too. No entanto, pode definir a aplicação para ser pré-instalada para os utilizadores finais com a funcionalidade Instalar aplicação automaticamente, que pode ser ativada no portal de administração do Power BI.However, you can set the app to be preinstalled for end users by using the Install app automatically feature, which can be enabled in the Power BI admin portal.

    Instalar aplicação automaticamente

  5. O autor abre a aplicação e vai para o relatório.The author opens the app and goes to the report.

  6. O autor copia o URL do relatório incorporado do relatório instalado pela aplicação.The author copies the embed report URL from the report installed by the app. Não utilize o URL do relatório original da área de trabalho de aplicação.Do Not use the original report URL from the app workspace.

  7. Crie um novo site de equipa no SharePoint Online.Create a new team site in SharePoint Online.

  8. Adicione o URL do relatório que copiou no passo 6 à parte Web do Power BI.Add the report URL copied from step 6 to the Power BI web part.

  9. Adicione todos os utilizadores finais e/ou grupos que vão consumir os dados na página do SharePoint Online e na aplicação do Power BI que criou.Add all end users and/or groups who are going to consume the data on the SharePoint Online page and in the Power BI app you created.

    Nota

    Os utilizadores ou grupos precisam de aceder tanto à página do SharePoint Online como ao relatório na aplicação do Power BI para ver o relatório na página do SharePoint.Users or groups need access to both the SharePoint Online page and the report in the Power BI app to see the report on the SharePoint page.

  10. Agora, o utilizador final pode ir para o site de equipa no SharePoint Online e ver os relatórios na página.Now the end user can go to the team site in SharePoint Online and view the reports on the page.

Autenticação multifatorMulti-factor authentication

Se o seu ambiente do Power BI requerer que inicie sessão através da autenticação multifator, poderá ser-lhe pedido que inicie sessão com um dispositivo de segurança para verificar a sua identidade.If your Power BI environment requires you to sign in using multi-factor authentication, you may be asked to sign in with a security device to verify your identity. Isto ocorre se não tiver iniciado sessão no SharePoint Online através da autenticação multifator, mas o seu ambiente do Power BI requerer uma conta validada por um dispositivo de segurança.This occurs if you did not sign in to SharePoint Online using multi-factor authentication but your Power BI environment requires an account validated by a security device.

Nota

A autenticação multifator ainda não é suportada no Azure Active Directory 2.0.Multi-factor authentication is not yet supported with Azure Active Directory 2.0. Os utilizadores recebem uma mensagem a indicar erro.Users receive a message saying error. Se o utilizador voltar a iniciar sessão no SharePoint Online através do respetivo dispositivo de segurança, este conseguirá ver o relatório.If the user signs in again to SharePoint Online using their security device, they may be able to view the report.

Definições de peças WebWeb part settings

Segue-se uma descrição das definições que podem ser ajustadas na peça Web Power BI para o SharePoint Online.Below is a description of the settings that can be adjusted for the Power BI web part for SharePoint Online.

Propriedades da peça Web do SP

PropriedadeProperty DescriçãoDescription
Nome da páginaPage name Predefine a página que é mostrada pela peça Web.Sets the default page that is shown by the web part. Selecione um valor no menu pendente.Select a value from the drop-down. Se não forem apresentadas páginas, significa que o seu relatório tem uma página ou que o URL que colou contém um nome de página.If no pages are displayed, either your report has one page, or the URL you pasted contains a page name. Remova a secção de relatório do URL para selecionar uma página específica.Remove the report section from the URL to select a specific page.
ApresentarDisplay Opção para personalizar o ajuste do relatório na página do SharePoint Online.Option to adjust how the report is fit within the SharePoint Online page.
Mostrar Painel de NavegaçãoShow Navigation Pane Mostra ou oculta o painel de navegação de páginas.Shows or hides the page navigation pane.
Mostrar Painel de FiltroShow Filter Pane Mostra ou oculta o painel de filtro.Shows or hides the filter pane.

Relatórios que não são carregadosReports that do not load

O seu relatório poderá não ser carregado na peça Web Power BI, apresentando a seguinte mensagem.Your report may not load within the Power BI web part and may show the following message.

Este conteúdo não está disponível.This content isn't available.

Mensagem de relatório não encontrado

Existem dois motivos comuns para esta mensagem.There are two common reasons for this message.

  1. Não tem acesso ao relatório.You do not have access to the report.
  2. O relatório foi eliminado.The report was deleted.

Contacte o proprietário da página do SharePoint Online para que este o ajude a resolver o problema.Contact the owner of the SharePoint Online page to help you resolve the issue.

LicensingLicensing

Os utilizadores que visualizam um relatório no SharePoint precisam de uma licença do Power BI Pro ou os conteúdos precisam de estar numa área de trabalho com capacidade do Power BI Premium (SKU EM ou P).Users viewing a report in SharePoint 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).

Limitações e problemas conhecidosKnown issues and limitations

  • Erro: "Ocorreu um erro; tente terminar e voltar a iniciar sessão e, em seguida, revisite esta página.Error: "An error occurred, please try logging out and back in and then revisiting this page. ID de Correlação: indefinido, estado de resposta de http: 400, código de erro de servidor 10001, mensagem: Token de atualização em falta"Correlation ID: undefined, http response status: 400, server error code 10001, message: Missing refresh token"

    Se receber este erro, experimente um dos passos de resolução de problemas abaixo.If you receive this error, try one of the troubleshooting steps below.

    1. Termine a sessão no SharePoint e volte a iniciá-la.Sign out of SharePoint and sign back in. Certifique-se de que fecha todas as janelas do browser antes de voltar a iniciar sessão.Be sure to close all browser windows before signing back in.

    2. Se a sua conta de utilizador requer autenticação multifator (MFA), certifique-se de que inicia sessão no SharePoint através do seu dispositivo de autenticação multifator (aplicação para telemóvel, smart card, etc.)If your user account requires multi-factor authentication (MFA), ensure you sign in to SharePoint using your multi-factor authentication device (phone app, smart card, etc.)

    3. As contas de utilizadores Convidados do Azure B2B não são suportadas.Azure B2B Guest users accounts are not supported. Os utilizadores veem o logótipo do Power BI que mostra que a peça está a ser carregada, mas não será apresentado o relatório.Users see the Power BI logo that shows the part is loading, but it doesn't show the report.

  • O Power BI não suporta os mesmos idiomas localizados que o SharePoint Online.Power BI does not support the same localized languages that SharePoint Online does. Como tal, poderá não ver uma devida localização no relatório incorporado.As a result, you may not see proper localization within the embedded report.

  • Poderá encontrar problemas se estiver a utilizar o Internet Explorer 10.You may encounter issues if using Internet Explorer 10. Pode ver a compatibilidade de browsers do Power BI e do Office 365.You can look at the browsers support for Power BI and for Office 365.

  • A peça Web do Power BI não está disponível para clouds nacionais.The Power BI web part is not available for national clouds.

  • O SharePoint Server clássico não é suportado com esta peça Web.The classic SharePoint Server is not supported with this web part.

  • Os filtros de URL não são suportados na peça Web do SPO.URL filters are not supported with the SPO web part.

Próximos passosNext steps

Mais perguntas?More questions? Experimente perguntar à Comunidade do Power BITry asking the Power BI Community