Power BI에 포함Embedding with Power BI

Power BI는 대시보드 및 보고서를 응용 프로그램에 포함하기 위한 API를 제공합니다.Power BI offers APIs for embedding your dashboards and reports into applications. 또한 콘텐츠를 포함할 경우 일관된 기능은 물론, 대시보드, 게이트웨이 및 앱 작업 영역과 같은 최신 Power BI 기능에 액세스 권한을 제공합니다.The Power BI APIs offer a consistent set of capabilities and access to the latest Power BI features – such as dashboards, gateways and app workspaces – when embedding content.

단일 APIA single API

Power BI 콘텐츠를 포함할 때 두 가지 주요 시나리오가 있습니다.There are two main scenarios when embedding Power BI content. 하나는 조직 내 사용자(Power BI에 대한 라이선스를 갖고 있는)를 위해 포함하는 시나리오이고, 다른 하나는 사용자 및 고객에게 Power BI 라이선스를 요구하지 않고 포함하는 시나리오입니다.Embedding for users in your organization (who have licenses for Power BI) and embedding for your users and customers without requiring them to have Power BI licenses. 두 시나리오 모두에 Power BI REST API를 사용할 수 있습니다.The Power BI REST API allows for both scenarios.

Power BI 라이선스가 없는 고객 및 사용자의 경우 조직 또는 고객에게 서비스를 제공할 때 사용하는 것과 동일한 API를 사용하여 대시보드 및 보고서를 사용자 지정 응용 프로그램에 포함할 수 있습니다.For customers and users without Power BI licenses, you can embed dashboards and reports into your custom application, using the same API to either service your organization or your customers. 응용 프로그램에서 관리하는 데이터를 고객이 볼 수 있습니다.Your customers see the data that is managed by the application. 조직 내 Power BI 사용자의 경우 Power BI에서 직접 또는 포함된 응용 프로그램의 컨텍스트에서 사용자 고유의 데이터를 볼 수 있는 추가 옵션이 제공됩니다.And for Power BI users in your organization, they'll have the additional options to view their own data directly in Power BI or in the context of the embedded application. 포함 필요에 따라 JavaScript 및 REST API를 완벽하게 활용할 수 있습니다.You can take full advantage of the JavaScript and REST APIs for your embedding needs.

포함 작동 방법의 예제를 보려면 JavaScript 포함 샘플을 참조하세요.To view a sample of how embedding works, see the JavaScript embed sample.

조직에 대한 콘텐츠 포함Embedding for your organization

조직에 대한 콘텐츠를 포함하면 Power BI 서비스를 확장할 수 있습니다.Embedding for your organization allows you to extend the Power BI service. 이렇게 하면 응용 프로그램 사용자는 콘텐츠를 보려면 Power BI 서비스에 로그인해야 합니다.This requires that users of your application sign into the Power BI service when they want to view their content. 조직 내 사용자가 로그인하면 해당 사용자는 본인 소유의 또는 Power BI 서비스에서 공유된 대시보드 및 보고서에만 액세스할 수 있습니다.Once someone in your organization signs in, they will only have access to dashboards and reports that they own or that have been shared with them in the Power BI service.

조직에 대한 콘텐츠가 포함된 예로 내부 웹 응용 프로그램, SharePoint Online 웹 파트 및 Microsoft 팀 통합을 들 수 있습니다.Examples of embedding for your organization include internal web application, the SharePoint Online web part and Microsoft Teams integration.

조직에 대한 콘텐츠를 포함하는 경우 다음 항목을 참조하세요.For embedding for your organization, see the following:

편집, 저장 등과 같은 셀프 서비스 기능은 Power BI 사용자에 대해 포함하는 경우 JavaScript API를 통해 사용할 수 있습니다.Self-service capabilities, such as edit, save and more, are available through the JavaScript API when embedding for Power BI users.

고객에 대한 콘텐츠 포함Embedding for your customers

고객에 대한 콘텐츠를 포함하면 Power BI에 대한 계정이 없는 사용자에게 대시보드 및 보고서를 포함하는 기능을 제공합니다.Embedding for your customers provides the ability to embed dashboards and reports to users who don't have an account for Power BI. 고객은 Power BI에 대해 알 필요가 없습니다.Your customers don't need to know anything about Power BI. 포함된 응용 프로그램을 만들려면 Power BI Pro 계정이 하나 이상 필요합니다.At least one Power BI Pro account is needed to create an embedded application. Power BI Pro 계정은 응용 프로그램에 대한 마스터 계정처럼 작동합니다.The Power BI Pro account acts as a master account for your application. 이것을 프록시 계정으로 간주합니다.Think of this as a proxy account. 또한 Power BI Pro 계정을 사용하면 응용 프로그램이 소유한/관리하는 Power BI 서비스 내에서 대시보드 및 보고서에 대한 액세스를 제공하는 embed 토큰을 생성할 수 있습니다.The Power BI Pro account also allows you to generate embed tokens that provide access to dashboards and reports within the Power BI service that are owned/managed by your application.

고객에 대한 콘텐츠를 포함하는 예로 다른 회사에 판매되는 ISV 응용 프로그램을 들 수 있습니다.An example of embedding for your customers is an ISV application being sold to other companies.

고객에 대한 콘텐츠를 포함하는 워크플로 포함

대시보드, 보고서 및 타일을 포함하려면 조직에 대한 콘텐츠를 포함하기 위해 사용하는 동일한 API를 사용합니다.To embed dashboards, reports and tiles, you would use the same APIs that you would use for embedding for your organization.

중요

포함 작업이 Power BI 서비스에 종속되는 반면 고객의 Power BI에 대해 종속되지는 않습니다.While embedding has a dependency on the Power BI service, there is not a dependency on Power BI for your customers. 응용 프로그램에 임베드된 콘텐츠를 보기 위해 Power BI에 가입할 필요는 없습니다.They do not need to sign up for Power BI to view the embedded content in your application.

프로덕션으로 이동할 준비가 되면 앱 작업 영역은 용량에 할당되어야 합니다.When you are ready to move to production, your app workspace must be assigned to a capacity. Microsoft Azure 내에서 Power BI Embedded는 응용 프로그램에서 사용할 용량을 제공합니다.Power BI Embedded, within Microsoft Azure, offers capacity to use with your applications.

포함하는 방법에 대한 자세한 내용은 Power BI 대시보드, 보고서 및 타일을 포함하는 방법을 참조하세요.For details on how to embed, see How to embed your Power BI dashboards, reports and tiles.

Azure 안에서 Power BI 작업 영역 컬렉션 서비스를 사용한 경우 콘텐츠 마이그레이션 방법은 Power BI 작업 영역 컬렉션 Azure 서비스에서 콘텐츠 마이그레이션을 참조하세요.If you were using the Power BI Workspace Collections service within Azure, see Migrate content from the Power BI Workspace Collections Azure service for information on how to migrate your content over.

다음 단계Next steps

Power BI 대시보드, 보고서 및 타일을 포함하는 방법How to embed your Power BI dashboards, reports and tiles
Power BI Embedded 작업 영역 컬렉션 콘텐츠를 Power BI으로 마이그레이션하는 방법How to migrate Power BI Embedded workspace collection content to Power BI
Power BI 프리미엄이란?Power BI Premium - what is it?
JavaScript API Git 리포지토리JavaScript API Git repo
Power BI C# Git 리포지토리Power BI C# Git repo
JavaScript 포함 샘플JavaScript embed sample
포함된 분석 용량 계획 백서Embedded analytics capacity planning whitepaper
Power BI 프리미엄 백서Power BI Premium whitepaper

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