採用開發方法來內嵌 Power BI 內容

已完成

下列步驟概述開發人員應該遵循的一般方法,以程式設計方式將Power BI內容內嵌至新的或現有的應用程式。

  1. 準備內嵌所需的 Power BI 內容。
  2. 建立 Microsoft Entra ID 應用程式註冊。
  3. 開發應用程式內嵌程式碼。
  4. 使用用戶端 API 功能來增強使用者體驗。

首先,您必須要有已可內嵌的 Power BI 內容。 內容的準備工作會涉及建立 Power BI 工作區,以及將內容發佈至該工作區。 您可以使用 Power BI Desktop 和 Power BI 服務,以傳統方式建立和管理內容。 我們會在下一個單元中,描述內嵌 Power BI 內容的準備程序。

其次,您必須在 Microsoft Entra 中建立應用程式註冊。 應用程式註冊可讓 Microsoft Entra 知道如何發行令牌,這會授與服務和資源的存取權。 視應用程式的內嵌身分識別而定,可能需要其他 Microsoft Entra 設定。

注意

若要了解內嵌身分識別和應用程式安全性設定,請逐一完成「設定內嵌 Power BI 內容權限」課程模組。

接下來,您將要使用內嵌程式碼來開發或擴充您的應用程式解決方案。 此一程序會涉及匯入特定的 NuGet 套件。 NuGet 套件可協助伺服器端需求,以 Microsoft Entra ID、產生令牌,以及探索Power BI內容。 Power BI 內容的實際內嵌發生於用戶端。 用戶端 API 作業會將特定的 Power BI 內容項目內嵌於 div 元素的內部。

注意

若要了解開發內嵌邏輯,請逐一完成「內嵌 Power BI 內容」課程模組。

用戶端 API 的功能不僅僅只有內嵌 Power BI 內容。 這些 API 還會支援多項作業,協助您順暢地整合並增強內容。 功能包含:

  • 程式設計互動:例如,您的應用程式可以將新的篩選條件套用至內嵌報表。
  • 可訂閱事件:圖表元素,例如直條圖視覺效果的資料行、功能表延伸模組和按鈕,可以觸發應用程式可回應的事件。 例如,當應用程式使用者選取 Power BI 報表內的按鈕時,應用程式會開啟對話方塊視窗,以便輸入並將資料寫回至應用程式資料庫。
  • 動態報表配置:例如,應用程式使用者可以選擇淺色或深色主題的報表。
  • 書籤互動:應用程式可以套用現有的報表書籤,或建立 (並保存) 個人書籤。
  • 報表視覺效果建立:應用程式可讓使用者建立報表視覺效果,或個人化現有報表的視覺效果。

注意

若要了解 Power BI 用戶端 API,請逐一完成「整合內容與 Power BI 用戶端 API」課程模組。