Внедрение в Power BIEmbedding with Power BI

Power BI предоставляет интерфейсы API для внедрения панелей мониторинга и отчетов в приложения.Power BI offers APIs for embedding your dashboards and reports into applications. Интерфейсы API Power BI предоставляют сопоставимые возможности и уровень доступа к последним функциям 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. REST API Power BI поддерживает оба сценария.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 Teams.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 возможности самообслуживания, например редактирование, сохранение и т. д., доступны посредством API JavaScript.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. Эта учетная запись используется как главная для вашего приложения.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, принадлежащих вашему приложению и управляемых им.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, а ваши клиенты — нет.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. Power BI Embedded в Microsoft Azure предоставляет емкость для использования с приложениями.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.

Если вы используете службу коллекций рабочих областей Power BI в Azure, сведения о переносе содержимого см. в статье Как перенести содержимое коллекции рабочих областей Power BI Embedded в Power BI.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 BIHow to embed your Power BI dashboards, reports and tiles
Как перенести содержимое коллекции рабочих областей Power BI Embedded в Power BIHow to migrate Power BI Embedded workspace collection content to Power BI
Что такое Power BI Premium?Power BI Premium - what is it?
Репозиторий Git JavaScript APIJavaScript API Git repo
Репозиторий Git Power BI C#Power BI C# Git repo
Пример внедрения JavaScriptJavaScript embed sample
Технический документ по планированию емкости для внедренной аналитикиEmbedded analytics capacity planning whitepaper
Техническая документация по Power BI PremiumPower BI Premium whitepaper

Появились дополнительные вопросы?More questions? Попробуйте задать вопрос в сообществе Power BI.Try asking the Power BI Community