SharePoint Online에 보고서 웹 파트 포함Embed a report web part in SharePoint Online

SharePoint Online용 Power BI의 새로운 보고서 웹 파트를 사용하면 SharePoint Online 페이지에서 대화형 Power BI 보고서를 쉽게 포함시킬 수 있습니다.With Power BI's new report web part for SharePoint Online, you can easily embed interactive Power BI reports in SharePoint Online pages.

새로운 SharePoint Online에 포함 옵션을 사용하는 경우 포함된 보고서는 매우 안전해져 안전한 내부 포털을 쉽게 만들 수 있습니다.When using the new Embed in SharePoint Online option, the embedded reports are fully secure, so you can easily create secure internal portals.

요구 사항Requirements

SharePoint Online에 포함 보고서가 작동하려면 다음이 필요합니다.For Embed in SharePoint Online reports to work, the following is required:

  • Power BI Pro 라이선스 또는 Power BI 라이선스를 포함한 Power BI Premium 용량(EM 또는 P SKU).A Power BI Pro license or a Power BI Premium capacity (EM or P SKU) with a Power BI license.
  • SharePoint Online용 Power BI 웹 파트는 최신 페이지가 필요합니다.The Power BI web part for SharePoint Online requires Modern Pages.
  • 포함된 보고서를 사용하려면 사용자가 Power BI 서비스에 로그인하여 Power BI 라이선스를 활성화해야 합니다.To consume an embedded report, users must sign in to Power BI service to activate their Power BI license.

보고서 포함Embed your report

보고서를 SharePoint Online에 포함하려면 보고서 URL을 가져와 SharePoint Online의 Power BI 웹 파트와 함께 사용해야 합니다.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.

보고서 URL 가져오기Get a report URL

  1. Power BI 내에서 보고서를 봅니다.Within Power BI, view the report.

  2. 기타 옵션(...) 드롭다운 메뉴에서 포함 > SharePoint Online을 차례로 선택합니다.On the More options (...) dropdown menu, select Embed > SharePoint Online.

    기타 옵션 메뉴, SharePoint Online

  3. 대화 상자에서 보고서 URL을 복사합니다.Copy the report URL from the dialog.

    Embed 링크

SharePoint Online 페이지에 Power BI 보고서 추가Add the Power BI report to a SharePoint Online page

  1. SharePoint Online에서 대상 페이지를 열고 편집을 선택합니다.Open the target page in SharePoint Online and select Edit.

    SP 편집 페이지

    또는 Sharepoint Online에서 + 새로 만들기를 선택하여 새 최신 사이트 페이지를 만듭니다.Or, in Sharepoint Online, select + New to create a new modern site page.

    SP 새 페이지

  2. + 드롭다운을 선택한 다음, Power BI 웹 파트를 선택합니다.Select the + dropdown and then select the Power BI web part.

    SP 새 웹 파트

  3. 보고서 추가를 선택합니다.Select Add report.

    SP 새 보고서

  4. 이전에 복사한 보고서 URL을 Power BI 보고서 링크 창에 붙여넣습니다.Paste the previously-copied report URL into the Power BI report link pane. 보고서를 자동으로 로드합니다.The report loads automatically.

    SP 새 웹 파트 속성

  5. 게시를 선택하여 변경 사항을 SharePoint Online 사용자가 볼 수 있도록 합니다.Select Publish to make the change visible to your SharePoint Online users.

    SP 보고서 로드됨

보고서에 액세스 권한 부여Grant access to reports

SharePoint Online에 보고서를 포함해도 사용자에게 보고서를 볼 수 있는 권한이 자동으로 부여되지 않으므로 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.

중요

Power BI 서비스 내에서 보고서를 볼 수 있는 사람이 누구인지 확인하고 목록에 없는 사람에게 액세스 권한을 부여합니다.Make sure to review who can see the report within the Power BI service and grant access to those not listed.

Power BI에서 보고서 액세스를 제공하는 두 가지 방법이 있습니다.There are two ways to provide report access in Power BI. 첫 번째 방법은 Office 365 그룹을 사용하여 SharePoint Online 팀 사이트를 구축하는 경우 사용자를 Power BI 서비스 내 작업 영역SharePoint 페이지의 구성원으로 나열하는 것입니다.The first way, if you're using an Office 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. 자세한 내용은 작업 영역 관리 방법을 참조하세요.For more information, see how to manage a workspace.

두 번째 방법은 앱 내에 보고서를 포함하여 사용자와 직접 공유하는 것입니다.The second way is to embed a report within an app and share it directly with users:

  1. Pro 사용자여야 하는 작성자는 작업 영역에 보고서를 만듭니다.The author, who must be a Pro user, creates a report in a workspace. ‘Power BI 무료 사용자’와 공유하려면 작업 영역을 ‘프리미엄 작업 영역’으로 설정해야 합니다. To share with Power BI free users, the workspace needs to be set as a Premium workspace.

  2. 작성자가 앱을 게시하고 설치합니다.The author publishes the app and installs it. 작성자는 SharePoint Online에 포함하는 데 사용되는 보고서 URL에 액세스할 수 있도록 앱을 설치해야 합니다.The author must install the app so it has access to the report URL that is used for embedding in SharePoint Online.

  3. 이제 모든 최종 사용자도 앱을 설치해야 합니다.Now all end users need to install the app too. Power BI 관리 포털에서 사용하도록 설정할 수 있는 앱을 자동으로 설치 기능을 사용하여 최종 사용자를 위해 앱을 미리 설치되도록 할 수도 있습니다.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.

    앱을 자동으로 설치

  4. 작성자가 앱을 열고 보고서로 이동합니다.The author opens the app and goes to the report.

  5. 작성자는 앱이 설치한 보고서에서 포함 보고서 URL을 복사합니다.The author copies the embed report URL from the report the app installed. 작업 영역의 원래 보고서 URL을 사용하면 안 됩니다.Don't use the original report URL from the workspace.

  6. SharePoint Online에서 새 팀 사이트를 만듭니다.Create a new team site in SharePoint Online.

  7. 이전에 복사한 보고서 URL을 Power BI 웹 파트에 추가합니다.Add the previously-copied report URL to the Power BI web part.

  8. SharePoint Online 페이지 및 직접 만든 Power BI 앱에서 데이터를 사용할 모든 최종 사용자 및/또는 그룹을 추가합니다.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.

    참고

    사용자 또는 그룹은 SharePoint 페이지에서 보고서를 보려면 SharePoint Online 페이지 및 Power BI 앱의 보고서에 대한 액세스 권한이 둘 다 필요합니다.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.

이제 최종 사용자가 SharePoint Online의 팀 사이트로 이동하여 해당 페이지에서 보고서를 볼 수 있습니다.Now the end user can go to the team site in SharePoint Online and view the reports on the page.

Multi-Factor AuthenticationMulti-factor authentication

Power BI 환경에서 다단계 인증을 사용하여 로그인해야 하는 경우 ID를 확인하기 위해 보안 디바이스에 로그인하라는 메시지가 나타날 수 있습니다.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. 이는 다단계 인증을 사용하여 SharePoint Online에 로그인하지 않았지만 Power BI 환경에서 계정의 유효성을 검사하기 위해 보안 디바이스가 필요한 경우에 발생합니다.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.

참고

Power BI는 아직 Azure Active Directory 2.0을 통한 다단계 인증을 지원하지 않습니다. 사용자에게 오류 메시지가 표시됩니다.Power BI does not yet support multi-factor authentication with Azure Active Directory 2.0 - users will see an error message. 사용자가 해당 보안 디바이스를 사용하여 SharePoint Online에 다시 로그인하면 보고서를 볼 수 있습니다.If the user signs in again to SharePoint Online using their security device, they may be able to view the report.

웹 파트 설정Web part settings

다음은 SharePoint Online용 Power BI 웹 파트를 조정할 수 있는 설정입니다.Below are the settings you can adjust for the Power BI web part for SharePoint Online.

SP 웹 파트 속성

속성Property 설명Description
페이지 이름Page name 웹 파트의 기본 페이지를 설정합니다.Sets the web part's default page. 드롭다운에서 값을 선택합니다.Select a value from the drop-down. 페이지가 표시되지 않는 경우는 보고서가 한 페이지이거나 붙여 넣은 URL에 페이지 이름이 포함된 경우입니다.If no pages are displayed, either your report has one page, or the URL you pasted contains a page name. URL에서 보고서 섹션을 제거하여 특정 페이지를 선택합니다.Remove the report section from the URL to select a specific page.
표시Display 보고서가 SharePoint Online 페이지 내에서 어떻게 표시되는지 조정합니다.Adjusts how the report fits within the SharePoint Online page.
탐색 창 표시Show Nav Pane 페이지 탐색 창을 표시하거나 숨깁니다.Shows or hides the page nav pane.
필터 창 표시Show Filter Pane 필터 창을 표시하거나 숨깁니다.Shows or hides the filter pane.

로드되지 않는 보고서Reports that do not load

보고서가 Power BI 웹 파트 내에서 로드되지 않으면 다음과 같은 메시지가 표시될 수 있습니다.If your report does not load within the Power BI web part, you may see the following message:

이 콘텐츠는 사용할 수 있는 메시지가 아닙니다.

이 메시지가 표시되는 데는 일반적으로 두 가지 이유가 있습니다.There are two common reasons for this message.

  1. 보고서 액세스 권한이 없습니다.You do not have report access.
  2. 보고서가 삭제되었습니다.The report was deleted.

이 문제를 해결하려면 SharePoint Online 페이지 소유자에게 문의하세요.Contact the SharePoint Online page owner to help resolve the issue.

라이선싱Licensing

SharePoint에서 보고서를 보는 사용자에게 Power BI Pro 라이선스가 필요하거나, Power BI Premium 용량(EM 또는 P SKU) 에 있는 작업 영역에 있어야 합니다.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).

알려진 문제 및 제한 사항Known issues and limitations

  • 오류: "An error occurred, please try logging out and back in and then revisiting this page.(오류가 발생했습니다. 로그아웃했다가 다시 로그인한 후 이 페이지를 다시 방문하세요.)Error: "An error occurred, please try logging out and back in and then revisiting this page. Correlation ID: undefined, http response status:(상관관계 ID: 정의되지 않음, http 응답 상태:) 400, server error code 10001, message:(400, 서버 코드 오류 10001, 메시지:) Missing refresh token(새로 고침 태그 없음)"Correlation ID: undefined, http response status: 400, server error code 10001, message: Missing refresh token"

    이 오류가 발생하면 아래 문제 해결 단계 중 하나를 시도하세요.If you receive this error, try one of the troubleshooting steps below.

    1. SharePoint에서 로그아웃했다가 다시 로그인합니다.Sign out of SharePoint and sign back in. 다시 로그인하기 전에 모든 브라우저 창을 닫아야 합니다.Be sure to close all browser windows before signing back in.

    2. 사용자 계정에 MFA(다단계 인증)가 필요한 경우 MFA 다단계 인증 디바이스(휴대폰 앱, 스마트 카드 등)를 사용하여 SharePoint에 로그인합니다.If your user account requires multi-factor authentication (MFA), then sign in to SharePoint using your MFA device (phone app, smart card, etc.).

    3. Azure B2B 게스트 사용자 계정은 지원되지 않습니다.Azure B2B Guest users accounts are not supported. 파트가 로드 중임을 나타내는 Power BI 로고가 사용자에게 표시되지만 보고서는 표시되지 않습니다.Users see the Power BI logo that shows the part is loading, but it doesn't show the report.

  • Power BI는 SharePoint Online에서 지원하는 것과 동일한 지역화된 언어를 지원하지 않습니다.Power BI does not support the same localized languages that SharePoint Online does. 결과적으로 포함된 보고서 내에 적절한 지역화가 표시되지 않을 수 있습니다.As a result, you may not see proper localization within the embedded report.

  • Internet Explorer 10을 사용하는 경우 문제가 발생할 수 있습니다.You may encounter issues if using Internet Explorer 10.

  • 내셔널 클라우드에서는 Power BI 웹 파트를 사용할 수 없습니다.The Power BI web part is not available for national clouds.

  • 클래식 SharePoint Server는 이 웹 파트에서 지원되지 않습니다.The classic SharePoint Server is not supported with this web part.

  • URL 필터는 SPO 웹 파트에서 지원되지 않습니다.URL filters are not supported with the SPO web part.

다음 단계Next steps

궁금한 점이 더 있나요?More questions? Power BI 커뮤니티에 질문합니다.Try asking the Power BI Community