Power BI 的內嵌功能Embedding with Power BI

Power BI 提供 API 來將您的儀表板和報表內嵌至應用程式。Power BI offers APIs for embedding your dashboards and reports into applications. Power BI API 在內嵌內容時,會提供一組一致的功能以及最新 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.

對組織進行內嵌的範例包括內部 Web 應用程式、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 使用者內嵌時,可透過 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. 將這個當作 Proxy 帳戶。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 應該與對組織進行內嵌時所用的 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 BIHow to migrate Power BI Embedded workspace collection content to Power BI
何謂 Power BI PremiumPower 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 Premium 技術白皮書Power BI Premium whitepaper

有其他問題嗎?More questions? 嘗試在 Power BI 社群提問Try asking the Power BI Community