Power BI 使用案例：為您的組織內嵌
注意
本文是 Power BI 實作規劃系列文章的其中一篇。 此系列主要著重於 Microsoft Fabric 中的 Power BI 體驗。 如需有關此系列的簡介，請參閱 Power BI 實作規劃。
此使用案例的重點在於開發人員如何為您的組織在的自訂應用程式中以程式設計方式內嵌 Power BI 內容。 (開發人員不一定負責建立 Power BI 內容。)當應用程式對象包含具備存取組織中 Power BI 內容權限和適當授權的使用者時，則適用「為您的組織內嵌」案例。 這些用戶必須有組織帳戶（包括來賓帳戶），以Microsoft Entra標識符進行驗證。
注意
在這個案例中，Power BI 為軟體即服務 (SaaS)。 內嵌案例有時稱為「使用者擁有資料」。
案例圖表
下圖描述支援支援組織內嵌最常見使用者動作和 Power BI 元件的高階概觀。
提示
如果您想要將此案例圖表內嵌在簡報、文件或部落格文章中，或將其列印成牆面海報，建議您下載案例圖表。 此圖表是可縮放向量圖形 (SVG) 影像，因此您可以將其擴大或縮小，而不會降低品質。
上述圖表描述下列使用者動作、工具和功能：
| 項目 | 說明 |
|---|---|
 |
Power BI 內容建立者會使用 Power BI Desktop 開發 BI 解決方案。 |
 |
備妥時，內容建立者會將 Power BI Desktop 檔案 (.pbix) 或 Power BI 專案檔案(.pbip) 發佈至 Power BI 服務。 |
 |
某些資料來源可能需要內部部署資料閘道或 VNet 閘道以進行資料重新整理，例如位於私人組織網路內的資料來源。 |
 |
Power BI 工作區包含準備內嵌的 Power BI 項目。 針對非個人工作區，自訂應用程式的使用者具備檢視 (或建立或修改) Power BI 內容的權限，因為這些使用者屬於工作區角色或具備方向權限。 |
 |
自訂應用程式會提示應用程式使用者使用 Microsoft Entra ID 進行驗證。 當驗證成功時，自訂應用程式會建立 Microsoft Entra 存取權杖。 |
 |
自訂應用程式會使用 Microsoft Entra 存取權杖，代表應用程式使用者呼叫 Power BI REST API。 具體而言，應用程式會使用存取權杖以擷取工作區項目的中繼資料。 中繼資料包含在自訂應用程式鐘內嵌內容所需的屬性。 |
 |
自訂應用程式會在 iframe HTML 元素中內嵌特定的 Power BI 項目。 若使用者具備相關權限，則應用程式可以支援建立和編輯 Power BI 報表。 |
 |
Power BI 管理員會在 Power BI 服務入口網站中監督和監視活動。 |
重點
以下是一些重點，強調為您的組織在自訂應用程式中以程式設計方式內嵌 Power BI 內容。
使用案例
有數多原因，您可能會為您的組織內嵌 Power BI 內容。
- 內部商業智慧入口網站：您可能會想要建立內部商業智慧 (BI) 入口網站作為 Power BI 服務的替代項目。 如此一來，您可以建立自訂應用程式以整合 Power BI 和其他 BI 工具的內容。
- 內部應用程式：您可能想要開發內部網路應用程式以顯示資料視覺效果。 例如，製造部門的內部網路網站可能會顯示即時視覺效果，提供生產線的最新資訊。
- 自訂記錄：您可能會想要記錄自訂事件，進而記錄 Power BI 內容除「活動記錄」記錄外的存取和使用。
提示
如果您要建立根據組織設計的 BI 入口網站，您只要將自訂商標新增至 Power BI 服務即可達成。
無程式碼內嵌
開發程式設計解決方案需要技能、時間和精力。 請考量採用內嵌技術 (稱為無程式碼內嵌)，非開發人員可加以使用來在簡單內部入口網站或網站中內嵌內容。
- 使用 Power BI 報表網頁組件，在 SharePoint Online 中內嵌 Power BI 報表。
- 使用 Power BI 產生的安全內嵌程式碼 (或 HTML) 以在內部網頁入口網站中內嵌 Power BI 報表。
- 在 Power Pages 中內嵌 Power BI 報表或儀表板。
- 在 Microsoft Teams 頻道或聊天中內嵌報表。
這些技術需要報表取用者屬於該組織，已進行驗證，並具備存取報表的權限。 Power BI 可確保在取用者檢視報表時，會實施所有的權限與資料安全性。 有時候，系統可能會藉由登入 Power BI 來對驗證進行考驗。
可內嵌的內容
當為您的組織內嵌時，您可以內嵌下列 Power BI內容類型：
- Power BI 報表
- 特定 Power BI 報表視覺效果
- 分頁報表
- Q&A 體驗
- 儀表板
- 特定的儀表板圖格
內容所在的位置沒有限制。 內容可以位於個人工作區或一般工作區。 重要的是，應用程式使用者具備檢視 (或建立或編輯) 內容的權限。 例如，您可以從應用程式使用者的個人工作區內嵌內容。
使用者可在 Power BI 服務中查看的內容都可以內嵌在自訂應用程式中。 如果使用者具備建立或編輯內容的權限，則自訂應用程式可支援該功能 (僅適用於 Power BI 報表)。
驗證
驗證流程是向 Microsoft Entra ID 的互動式驗證。 互動式驗證表示系統將要求應用程式使用者進行驗證。 驗證後，Microsoft Entra ID 會傳回存取權杖。 自訂應用程式的責任是快取存取權杖，以便可用於呼叫 Power BI REST API 及將內容內嵌在 iframe HTML 中。 這些呼叫可以代表應用程式使用者擷取 Power BI 內容的中繼資料，包含在自訂應用程式內嵌所需的屬性。
授權
為您的組織內嵌沒有特定的授權需求。 重要的是，應用程式使用者具備檢視 (或建立或編輯) 內容的適當 Power BI 授權。 當應用程式使用者僅具備 Fabric (免費) 授權時，甚至可以從個人工作區內嵌內容。
Power BI 用戶端 API
Power BI 用戶端 API 可讓開發人員在自訂應用程式與 Power BI 內容之間實現緊密的整合。 這些開發人員會使用在瀏覽器中執行的 JavaScript 或 TypeScript 撰寫自訂邏輯以開發應用程式。
應用程式可以設定和自動化作業，也可以回應使用者起始的動作。 此外，您也可以整合 Power BI 功能，包含瀏覽、篩選條件和交叉分析篩選器、功能表作業、版面配置，以及書籤。
提示
Power BI 內嵌式分析遊樂場是一個網站，可協助您學習、探索和實驗 Power BI 內嵌式分析。 其中包含適用於實際操作體驗的開發人員沙箱，其會搭配用戶端 API 使用範例 Power BI 內容或您自己的內容。 程式碼片段和展示項目也可供您探索。
如需詳細資訊，請參閱什麼是 Power BI 內嵌式分析遊樂場？
閘道安裝
在存取位於私人組織網路或虛擬網路內的資料來源時，通常需要資料閘道。 閘道的兩個用途是重新整理匯入的資料，或檢視查詢即時連線或 DirectQuery 語意模型的報表。
系統監督權
活動記錄會記錄 Power BI 服務中發生的使用者活動。 Power BI 管理員可以使用收集的活動記錄資料執行稽核，以協助他們了解使用模式和採用。 記錄的事件會將取用方法說明為「為您的組織內嵌」。 目前無法判斷內容是否已在自訂應用程式中使用無程式碼內嵌體驗進行檢視。
相關內容
如需深入了解 Power BI 內嵌式分析，請逐步完成內嵌 Power BI 分內學習路徑。
您也可以逐步完成一天的 Power BI 開發人員課程。 其中包含一個自學套件，引導您完成開發 ASP.NET Core MVC 應用程式的流程。
如需可協助您進行 Power BI 實作決策的其他實用案例，請參閱 Power BI 使用案例一文。