共用方式為

Power BI 使用案例：為您的組織內嵌

  • 發行項

注意

本文構成Power BI實作規劃系列文章的一部分。 此系列主要著重於 Microsoft Fabric 內的 Power BI 體驗。 如需系列簡介，請參閱 Power BI 實作規劃。

此使用案例著重於開發人員如何在組織的自定義應用程式中以程序設計方式內嵌Power BI內容。 （開發人員不一定負責建立Power BI內容。 當應用程式物件包含具有存取組織中 Power BI 內容之許可權和適當授權的使用者時，就會套用適用於貴組織的 內嵌案例。 這些用戶必須擁有組織帳戶（包括來賓帳戶），其會使用 Microsoft Entra ID 進行驗證（先前稱為 Azure Active Directory）。

注意

在這個案例中，Power BI 為軟體即服務 (SaaS)。 內嵌案例有時稱為 使用者擁有數據。

案例圖表

下圖描述支援為組織內嵌的最常見用戶動作和 Power BI 元件的高階概觀。

圖表顯示為組織內嵌，也就是將內容整合到內部應用程式。下表說明圖表中的專案。

提示

如果您想要將其內嵌在簡報、檔或部落格文章中，建議您下載案例圖表，或將其列印成牆面海報。 因為它是可調整的向量圖形 （SVG） 影像，因此您可以相應增加或減少，而不會遺失品質。

上圖描述下列使用者動作、工具和功能：

項目 說明
專案 1. Power BI 內容建立者會使用 Power BI Desktop 開發 BI 解決方案。
專案 2. 準備好時，內容建立者會將Power BI Desktop 檔案 （.pbix） 或Power BI項目檔 （.pbip） 發佈至 Power BI 服務。
專案 3. 某些數據源可能需要 內部部署數據網關或 VNet 閘道 進行數據重新整理，例如位於私人組織網路內的數據源。
專案 4. Power BI 工作區包含準備內嵌的 Power BI 專案。 針對非個人工作區，自定義應用程式的使用者有權 檢視或建立或修改 Power BI 內容 ，因為它們屬於工作區角色，或他們具有方向許可權。
專案 5. 自定義應用程式會提示應用程式使用者向 Microsoft Entra ID 進行驗證。 驗證成功時，自定義應用程式會快取 Microsoft Entra 存取令牌。
專案 6. 自定義應用程式會使用 Microsoft Entra 存取令牌，代表應用程式使用者呼叫 Power BI REST API。 具體而言，應用程式會使用存取令牌來擷取工作區專案的元數據。 元數據包含在自定義應用程式中內嵌內容所需的屬性。
專案 7. 自訂應用程式會在 HTML 專案中內嵌特定的 Power BI 專案 iframe 。 應用程式可以支援建立和編輯Power BI報表，前提是使用者有權這樣做。
專案 8. Power BI 系統管理員會監督和監視 Power BI 服務 中的活動。

重點

以下是一些重點，以程序設計方式在組織的自定義應用程式中內嵌Power BI內容。

使用案例

您可能會為組織內嵌 Power BI 內容的原因有很多。

  • 內部商業智慧入口網站：您可能想要建立內部商業智慧 （BI） 入口網站，以取代 Power BI 服務。 如此一來，您可以建立自定義應用程式，以整合 Power BI 和其他 BI 工具的內容。
  • 內部應用程式： 您可能想要開發顯示資料視覺效果的內部網路應用程式。 例如，製造部門的內部網路網站可能會顯示即時視覺效果，以提供生產線的最新資訊。
  • 自定義記錄： 您可能想要記錄自定義事件，以記錄Power BI內容存取和使用，超出 活動記錄 檔記錄的記錄。

提示

如果您想要為組織建立樣式為的 BI 入口網站，您可以直接將自定義商標新增至 Power BI 服務 來達成此目的。

無程式代碼內嵌

開發程式設計解決方案需要技能、時間和精力。 請考慮有稱為 無程式代碼內嵌的內嵌 技術，非開發人員可用來在簡單的內部入口網站或網站內嵌內容。

這些技術要求報表取用者屬於組織、進行驗證，並具有存取報表的許可權。 Power BI 可確保在取用者檢視報表時，會實施所有的權限與資料安全性。 有時候，系統可能會藉由登入 Power BI 來對驗證進行考驗。

可內嵌的內容

為組織內嵌時，您可以內嵌下列 Power BI 內容類型：

  • Power BI 報表
  • 特定的Power BI報表視覺效果
  • 分頁報表
  • 問答體驗
  • 儀表板​​
  • 特定的儀表板圖格

內容所在的位置沒有任何限制。 內容可以位於個人工作區或一般工作區中。 重要的是，應用程式用戶有權檢視或建立或編輯內容。 例如，您可以從應用程式使用者的個人工作區內嵌內容。

用戶可以在 Power BI 服務 中看到的任何內容都可以內嵌在自定義應用程式中。 如果使用者有權建立或編輯內容，則自定義應用程式可以支援該功能（僅適用於 Power BI 報表）。

驗證

驗證流程是 具有 Microsoft Entra ID 的互動式驗證 。 互動式驗證表示應用程式使用者將面臨驗證的挑戰。 通過驗證時，Microsoft Entra ID 會傳回存取令牌。 自定義應用程式負責快取存取令牌，以便用來進行Power BI REST API呼叫，以及在HTML元素內 iframe 嵌內容。 這些呼叫可以代表應用程式使用者擷取 Power BI 內容的相關元數據，包括在自定義應用程式中內嵌它所需的屬性。

授權

沒有為組織內嵌的特定授權需求。 重要的是，應用程式使用者具有許可權和適當的Power BI授權，可檢視或建立或編輯內容。 當應用程式使用者只有 Fabric（免費）授權時，甚至可以從個人工作區內嵌內容。

Power BI 用戶端 API

Power BI 用戶端 API 可讓開發人員在自定義應用程式與 Power BI 內容之間達成緊密整合。 他們會使用在瀏覽器中執行的 JavaScript 或 TypeScript 撰寫自訂邏輯來開發應用程式。

應用程式可以設定和自動化作業，而且可以回應使用者起始的動作。 此外，您可以整合 Power BI 功能，包括瀏覽、篩選和交叉分析篩選器、功能表作業、版面配置和書籤。

提示

Power BI Embedded Analytics 遊樂場是一個網站，可協助您學習、探索及實驗 Power BI 內嵌式分析。 其中包含適用於實際操作體驗的開發人員沙箱，其會搭配用戶端 API 使用範例 Power BI 內容或您自己的內容。 程式碼片段和展示項目也可供您探索。

如需詳細資訊，請參閱什麼是 Power BI 內嵌式分析遊樂場？

閘道安裝

通常，存取位於私人組織網路或虛擬網路內的數據源時， 需要數據網關 。 網關的兩個用途是 重新整理匯入的數據，或檢視查詢即時連線或 DirectQuery 語意模型的報表（先前稱為數據集）。

注意

強烈建議您透過個人模式的閘道，使用標準模式的集中式數據閘道。 在標準模式中，數據閘道支持即時連線和 DirectQuery 作業（除了排程的數據重新整理作業）。

系統監督

活動記錄會記錄 Power BI 服務 中發生的用戶活動。 Power BI 系統管理員可以使用收集的活動記錄數據來執行 稽核 ，以協助他們瞭解使用模式和採用。 記錄的事件會將取用方法描述為 為您的組織內嵌。 目前沒有任何方法可判斷內容是否在自定義應用程式中以無程式代碼內嵌體驗來檢視。

相關內容

若要深入瞭解Power BI內嵌式分析，請透過內 嵌Power BI分析 學習路徑。

您也可以在一天課程中完成Power BI 開發人員。 其中包含一個自學套件，可引導您完成開發 ASP.NET Core MVC 應用程式的程式。

如需可協助您進行Power BI實作決策的其他實用案例，請參閱 Power BI使用案例 一文。