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

已完成

下列步驟會概要說明可讓開發人員遵循的一般性方法,以透過程式設計方式將 Power BI 內容內嵌於新的或現有應用程式之中。

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

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

其次,您必須在 Azure AD 中建立「應用程式註冊」。 該應用程式註冊可讓 Azure AD 知道如何發行權杖,其用來授與服務和資源的存取權。 視您應用程式的內嵌身分識別而定,有可能還需要其他的 Azure AD 設定。

注意

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

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

注意

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

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

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

注意

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