Inserir uma web part de relatório no SharePoint OnlineEmbed a report web part in SharePoint Online

Com a nova Web Part de Relatório do Power BI para o SharePoint Online, você pode facilmente inserir relatórios interativos do Power BI às páginas do SharePoint Online.With the new Power BI report web part for SharePoint Online, you can easily embed interactive Power BI reports in SharePoint Online pages.

Ao usar a nova opção Inserir no SharePoint Online, os relatórios inseridos respeitam todas as permissões de item e a segurança de dados por meio da segurança em nível de linha (RLS), para que você possa criar facilmente portais internos seguros.When using the new Embed in SharePoint Online option, the embedded reports respect all item permissions and data security through row-level security (RLS), so you can easily create secure internal portals.

RequisitosRequirements

Para que os relatórios da opção Inserir no SharePoint Online funcionem, é necessário ter o seguinte:For Embed in SharePoint Online reports to work, the following is required:

  • Uma licença do Power BI Pro ou PPU (Premium por usuário) ou capacidade do Power BI Premium (EM ou SKU P) com uma licença do Power BI.A Power BI Pro or Premium Per User (PPU) license or a Power BI Premium capacity (EM or P SKU) with a Power BI license.
  • A web part do Power BI para o SharePoint Online requer Páginas Modernas.The Power BI web part for SharePoint Online requires Modern Pages.
  • Para consumir um relatório inserido, os usuários precisam entrar no serviço do Power BI para ativar sua licença do Power BI.To consume an embedded report, users must sign in to Power BI service to activate their Power BI license.

Observação

Para organizações nas nuvens nacionais do Power BI, não há licença gratuita.For organizations in Power BI National clouds, there's no free license. Nesse ambiente, todos os usuários que desejam acessar o relatório inserido no SharePoint precisarão obter uma licença do Power BI Pro ou PPU (Premium por usuário).In this environment, all users who want access to the embedded report in Sharepoint need to have a Power BI Pro or Premium Per User (PPU) license.

Insira seu relatórioEmbed your report

Para inserir seu relatório no SharePoint Online, é necessário obter a URL de relatório e usá-la com a web part do Power BI no SharePoint Online.To embed your report into SharePoint Online, you need to get the report URL and use it with SharePoint Online's Power BI web part.

Obter uma URL de relatórioGet a report URL

  1. Abra um relatório no serviço do Power BI.Open a report in the Power BI service.

  2. No menu Compartilhar, selecione Inserir relatório > SharePoint Online.On the Share menu, select Embed report > SharePoint Online.

    Menu Mais opções, SharePoint Online

  3. Copie a URL de relatório da caixa de diálogo.Copy the report URL from the dialog.

    Inserir link

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 de destino no SharePoint Online e selecione Editar.Open the target page in SharePoint Online and select Edit.

    Página de edições do SP

    Ou, no Sharepoint Online, selecione + Novo para criar uma página do site moderna.Or, in Sharepoint Online, select + New to create a new modern site page.

    Nova página do SP

  2. Selecione a lista suspensa + e a web part do Power BI.Select the + dropdown and then select the Power BI web part.

    Nova web part do SP

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

    Novo relatório do SP

  4. Cole a URL de relatório copiada anteriormente no painel do link de relatório do Power BI.Paste the previously-copied report URL into the Power BI report link pane. O relatório é carregado automaticamente.The report loads automatically.

    Novas propriedades da web part do SP

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

    Relatório do SP carregado

Conceder acesso aos relatóriosGrant access to reports

Inserir um relatório no SharePoint Online não concede automaticamente aos usuários permissão para exibir o relatório – é necessário definir as permissões de exibição no Power BI.Embedding a report in SharePoint Online doesn't automatically give users permission to view the report - you need to set view permissions in Power BI.

Importante

Certifique-se de examinar quem pode ver o relatório dentro do serviço do Power BI e de conceder acesso aos que não aparecem na lista.Make sure to review who can see the report within the Power BI service and grant access to those not listed.

Há duas maneiras de conceder acesso ao relatório no Power BI.There are two ways to provide report access in Power BI. A primeira maneira, se você estiver usando um grupo do Microsoft 365 para criar seu site de equipe do SharePoint Online, será listar o usuário como membro do workspace no serviço do Power BI e da página do SharePoint.The first way, if you're using a Microsoft 365 Group to build your SharePoint Online team site, is to list the user as a member of the workspace within the Power BI service and the SharePoint page. Para obter mais informações, consulte como gerenciar um workspace.For more information, see how to manage a workspace.

A segunda maneira é inserir um relatório dentro de um aplicativo e compartilhá-lo diretamente com os usuários:The second way is to embed a report within an app and share it directly with users:

  1. O autor, que deve ser um usuário Pro, cria um relatório em um workspace.The author, who must be a Pro user, creates a report in a workspace. Para compartilhar com usuários gratuitos do Power BI, o workspace precisa ser definido como um workspace Premium.To share with Power BI free users, the workspace needs to be set as a Premium workspace.

  2. O autor publica o aplicativo e instala-o.The author publishes the app and installs it. O autor precisa instalar o aplicativo para que ele tenha acesso à URL do relatório usada para inserção no SharePoint Online.The author must install the app so it has access to the report URL that is used for embedding in SharePoint Online.

  3. Agora todos os usuários finais também precisam instalar o aplicativo.Now all end users need to install the app too. Também é possível usar o recurso Instalar aplicativo automaticamente, que pode ser habilitado no portal de administração do Power BI, para ter o aplicativo pré-instalado para usuários finais.You can also use the Install app automatically feature, which you can enable in the Power BI admin portal, to have the app pre-installed for end users.

    Instalar o aplicativo automaticamente

  4. O autor abre o aplicativo e vai para o relatório.The author opens the app and goes to the report.

  5. O autor copia a URL do relatório de inserção do relatório instalado pelo aplicativo.The author copies the embed report URL from the report the app installed. Não use a URL do relatório original do workspace.Don't use the original report URL from the workspace.

  6. Crie um novo site de equipe no SharePoint Online.Create a new team site in SharePoint Online.

  7. Adicione a URL do relatório copiada anteriormente à web part do Power BI.Add the previously-copied report URL to the Power BI web part.

  8. Adicione todos os usuários finais e/ou grupos que consumirão os dados na página do SharePoint Online e no aplicativo do Power BI que você 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.

    Observação

    Os usuários ou grupos precisam acessar a página do SharePoint Online e o relatório no aplicativo 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.

Agora o usuário final pode ir para o site de equipe no SharePoint Online e exibir 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 ambiente do Power BI exigir que você entre usando a autenticação multifator, talvez será necessário entrar com um dispositivo de segurança para verificar 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. Isso ocorrerá se você não tiver entrado no SharePoint Online usando a autenticação multifator, mas o ambiente do Power BI requerer um dispositivo de segurança para validar uma conta.This occurs if you did not sign in to SharePoint Online using multi-factor authentication, but your Power BI environment requires a security device to validate an account.

Observação

O Power BI ainda não dá suporte à autenticação multifator com o Azure Active Directory 2.0 – os usuários verão uma mensagem de erro.Power BI does not yet support multi-factor authentication with Azure Active Directory 2.0 - users will see an error message. Se o usuário entrar novamente no SharePoint Online usando o dispositivo de segurança, o relatório poderá ser exibido.If the user signs in again to SharePoint Online using their security device, they may be able to view the report.

Configurações de Web PartWeb part settings

Veja abaixo as configurações que podem ser ajustadas para a web part do Power BI para o SharePoint Online.Below are the settings you can adjust for the Power BI web part for SharePoint Online.

Propriedades da web part do SP

PropertyProperty DescriçãoDescription
Nome da páginaPage name Define a página padrão da web part.Sets the web part's default page. Selecione um valor na lista suspensa.Select a value from the drop-down. Se nenhuma página for exibida, o relatório terá uma página ou a URL que você colou conterá 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. Remover a seção de relatório da URL para selecionar uma página específica.Remove the report section from the URL to select a specific page.
ExibirDisplay Ajusta a maneira como o relatório se ajusta à página do SharePoint Online.Adjusts how the report fits within the SharePoint Online page.
Mostrar Painel de NavegaçãoShow Nav Pane Exibe ou oculta o painel de navegação da página.Shows or hides the page nav pane.
Exibir Painel de FiltroShow Filter Pane Exibe ou oculta o painel de filtro.Shows or hides the filter pane.

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

Se seu relatório não for carregado dentro da web part do Power BI, você poderá ver a mensagem a seguir:If your report does not load within the Power BI web part, you may see the following message:

Mensagem Este conteúdo não está disponível

Há duas razões comuns para essa mensagem.There are two common reasons for this message.

  1. Você não tem acesso ao relatório.You do not have report access.
  2. O relatório foi excluído.The report was deleted.

Contate o proprietário da página do SharePoint Online para ajudar a resolver o problema.Contact the SharePoint Online page owner to help resolve the issue.

LicençasLicensing

Os usuários que visualizam um relatório no SharePoint precisam obter uma licença do Power BI Pro ou PPU (Premium por usuário) . Como alternativa, o conteúdo precisa estar em um workspace com uma capacidade do Power BI Premium (EM ou SKU P) .Users viewing a report in SharePoint need either a Power BI Pro or Premium Per User (PPU) 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 sair, entrar outra vez e visitar esta página novamente.Error: "An error occurred, please try logging out and back in and then revisiting this page. ID da correlação: indefinido, status de resposta http: 400, código de erro do servidor 10001, mensagem: Atualização de token ausente"Correlation ID: undefined, http response status: 400, server error code 10001, message: Missing refresh token"

    Se você receber esse erro, tente uma das etapas de solução de problemas abaixo.If you receive this error, try one of the troubleshooting steps below.

    1. Saia do SharePoint e entre novamente.Sign out of SharePoint and sign back in. Certifique-se de fechar todas as janelas do navegador antes de entrar novamente.Be sure to close all browser windows before signing back in.

    2. Se sua conta de usuário exigir a MFA (autenticação multifator), entre no SharePoint usando seu dispositivo MFA (aplicativo de celular, cartão inteligente etc.).If your user account requires multi-factor authentication (MFA), then sign in to SharePoint using your MFA device (phone app, smart card, etc.).

    3. Contas de Usuários convidados B2B do Azure não são compatíveis.Azure B2B Guest users accounts are not supported. Os usuários veem o logotipo do Power BI que mostra a parte que está sendo carregada, mas o relatório não é mostrado.Users see the Power BI logo that shows the part is loading, but it doesn't show the report.

  • O Power BI não dá suporte aos mesmos idiomas localizados que o SharePoint Online.Power BI does not support the same localized languages that SharePoint Online does. Como resultado, você não verá a localização correta no relatório inserido.As a result, you may not see proper localization within the embedded report.

  • Você pode encontrar problemas se usar o Internet Explorer 10.You may encounter issues if using Internet Explorer 10.

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

  • O servidor clássico do SharePoint não é compatível com essa web part.The classic SharePoint Server is not supported with this web part.

  • Filtros de URL não são compatíveis com a Web part do SPO.URL filters are not supported with the SPO web part.

Próximas etapasNext steps

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