教學課程:使用客戶的應用程式內嵌範例內嵌Power BI內容

適用於: 應用程式擁有數據 用戶擁有數據

內嵌分析和Power BI Embedded (Azure 供應專案)可讓您將報表、儀錶板和磚等 Power BI 內容內嵌至您的應用程式。

在本教學課程中,您將了解如何:

  • 設定內嵌環境。
  • 您的客戶 設定內嵌(也稱為 應用程式擁有數據)範例應用程式。

若要使用您的應用程式,您的使用者不需要登入 Power BI 或擁有 Power BI 授權。

如果您是獨立軟體廠商(ISV)或想要為第三方建立應用程式的開發人員,建議您使用 內嵌客戶 方法來內嵌 Power BI 內容。

重要

如果您要內嵌國家/地區雲端的內容,本教學課程的前幾個步驟會有所不同。 如需詳細資訊,請參閱內嵌國家/地區雲端的內容。

程式代碼範例規格

本教學課程包含下列其中一個 架構中為您的客戶 範例應用程式設定內嵌的指示:

  • .NET Framework
  • .NET Core
  • Java
  • Node JS
  • Python

程式代碼範例支援下列瀏覽器:

  • Microsoft Edge
  • Google Chrome
  • Mozilla Firefox

必要條件

開始本教學課程之前,請確認您有下列 Power BI 和程式代碼相依性:

方法

若要為您的客戶建立內嵌範例應用程式,請遵循下列步驟:

  1. 選取您的驗證方法

  2. 註冊 Microsoft Entra 應用程式

  3. 建立 Power BI 工作區

  4. 建立和發佈Power BI報表

  5. 取得內嵌參數值

  6. 服務主體 API 存取

  7. 啟用工作區存取

  8. 內嵌您的內容

步驟 1 - 選取您的驗證方法

您的內嵌解決方案會根據您選取的驗證方法而有所不同。 因此,請務必瞭解驗證方法之間的差異,並決定哪一個最適合您的解決方案。

下表描述服務主體主要使用者驗證方法之間的一些主要差異。

考量事項 服務主體 主要使用者
機制 Microsoft Entra 應用程式的 服務主體物件 可讓 Microsoft Entra ID 向 Power BI 驗證內嵌解決方案應用程式。 您的 Microsoft Entra 應用程式會使用 Power BI 使用者的認證(使用者名稱和密碼),對 Power BI 進行驗證。
安全性 服務主體 是 Microsoft Entra ID 建議的授權方法。 如果您使用服務主體,您可以使用應用程式秘密或憑證進行驗證

本教學課程僅說明搭配應用程式秘密使用服務主體。 若要使用 服務主體憑證進行內嵌,請參閱 具有憑證 的服務主體一文。
此驗證方法不如服務主體那麼安全。 您必須警惕主要 使用者認證(使用者 名稱和密碼)。 例如,請勿在內嵌應用程式中公開它們,並經常變更密碼。
Microsoft Entra ID 委派的許可權 非必要。 您的 主要使用者 或系統管理員必須授與同意,您的應用程式才能存取 Power BI REST API 許可權 (也稱為範圍)。 例如 Report.ReadWrite.All
Power BI 服務 存取 您無法使用服務主體存取 Power BI 服務。 您可以使用主要使用者認證來存取 Power BI 服務。
授權 不需要 Pro 授權。 您可以使用您是成員或系統管理員之任何工作區的內容。 需要 Power BI Pro 或 進階版 Per User (PPU) 授權。

步驟 2 - 註冊 Microsoft Entra 應用程式

使用 Microsoft Entra ID 註冊您的應用程式可讓您:

若要使用 Microsoft Entra ID 註冊您的應用程式,請遵循註冊您的應用程式中的指示。

注意

註冊應用程式之前,您必須決定要使用的驗證方法、 服務主體主要使用者

步驟 3 - 建立 Power BI 工作區

Power BI 會將報表、儀錶板和磚保留在工作區中。 若要內嵌這些專案,您必須建立這些專案,並將其上傳至工作區。

提示

如果您已經有工作區,您可以略過此步驟。

若要建立工作區,請執行下列動作:

  1. 登入 Power BI。

  2. 選取工作區

  3. 選取建立工作區

  4. 為您的工作區命名,然後選取 [ 儲存]。

步驟 4 - 建立及發佈 Power BI 報表

下一個步驟是建立報表,並將其上傳至您的工作區。 您可以使用 Power BI Desktop 建立自己的報表 ,然後將 它發佈 至工作區。 或者,您可以將範例報表上傳至工作區。

提示

如果您已經有具有報表的工作區,您可以略過此步驟。

若要下載範例報表並將其發佈至您的工作區,請遵循下列步驟:

  1. 開啟 GitHub Power BI Desktop 範例 資料夾。

  2. 選取 [ 程序代碼 ],然後選取 [ 下載 zip]。

    A screenshot showing the ZIP download option in the Power B I desktop samples GitHub

  3. 解壓縮下載的 ZIP,並流覽至 [範例報表] 資料夾。

  4. 選取要內嵌的報表,並將其 發佈 至您的工作區。

步驟 5 - 取得內嵌參數值

若要內嵌您的內容,您必須取得特定參數值。 下表顯示必要值,並指出它們是否適用於 服務主體 驗證方法、 主要使用者 驗證方法或兩者。

在內嵌內容之前,請確定您有下列所有值。 某些值會根據您使用的驗證方法而有所不同。

參數 服務主體 主要使用者
用戶端識別碼 Applies to. Applies to.
工作區識別碼 Applies to. Applies to.
報表標識碼 Applies to. Applies to.
用戶端密碼 Applies to. Does not apply to.
租用戶識別碼 Applies to. 僅限 Node JS 的必要專案
Power BI 用戶名稱 Does not apply to. Applies to.
Power BI 密碼 Does not apply to. Applies to.

Client ID

提示

適用於:Applies to.服務主體 Applies to.主要使用者

若要取得用戶端識別碼 GUID (也稱為 應用程式識別碼),請遵循下列步驟:

  1. 登入 Microsoft Azure

  2. 搜尋 應用程式註冊,然後選取 應用程式註冊 連結。

  3. 選取您用來內嵌 Power BI 內容的 Microsoft Entra 應用程式。

  4. 從 [概觀]段中,複製應用程式 (用戶端) 識別元 GUID。

工作區識別碼

提示

適用於:Applies to.服務主體 Applies to.主要使用者

若要取得工作區標識碼 GUID,請遵循下列步驟:

  1. 登入 Power BI 服務。

  2. 開啟您想要內嵌的報表。

  3. 從 URL 複製 GUID。 GUID 是 /groups//reports/之間的數位。

    A screenshot showing workspace ID GUID in the Power B I service U R L

或者,您可以選取工作區名稱旁的 [詳細數據],在 管理員 入口網站設定中找到工作區標識符。

A screenshot showing how to find the workspace I D from the admin settings.

報表標識碼

提示

適用於:Applies to.服務主體 Applies to.主要使用者

若要取得報表標識元 GUID,請遵循下列步驟:

  1. 登入 Power BI 服務。

  2. 開啟您想要內嵌的報表。

  3. 從 URL 複製 GUID。 GUID 是 /reports//ReportSection 之間的數位。

    A screenshot showing report ID GUID in the Power B I service U R L

用戶端密碼

提示

適用於:Applies to.服務主體 Does not apply to.主要使用者

若要取得客戶端密碼,請遵循下列步驟:

  1. 登入 Microsoft Azure

  2. 搜尋 應用程式註冊,然後選取 應用程式註冊 連結。

  3. 選取您用來內嵌 Power BI 內容的 Microsoft Entra 應用程式。

  4. 在 [管理] 下,選取 [憑證與秘密]。

  5. 在 [用戶端祕密] 下,選取 [新增用戶端祕密]

  6. 在 [ 新增客戶端密碼 ] 彈出視窗中,提供應用程式秘密的描述、選取應用程式秘密到期的時間,然後選取 [ 新增]。

  7. 從 [客戶端密碼] 區段中,複製新建立之應用程式秘密之 [值] 資料行中的字串。 用戶端密碼值是用戶端 識別碼

注意

請務必在客戶端密碼值第一次出現時複製它。 離開此頁面之後,客戶端密碼將會隱藏,您將無法擷取其值。

租用戶識別碼

提示

適用於:Applies to.服務主體 Does not apply to.主要使用者

若要取得租用戶標識碼 GUID,請遵循下列步驟:

  1. 登入 Microsoft Azure

  2. 搜尋 應用程式註冊,然後選取 應用程式註冊 連結。

  3. 選取您用來內嵌 Power BI 內容的 Microsoft Entra 應用程式。

  4. 從 [概觀]段複製目錄(租用戶)標識符 GUID。

Power BI 使用者名稱和密碼

提示

適用於:Does not apply to.服務主體 Applies to.主要使用者

取得您作為主要使用者使用之 Power BI 使用者的使用者名稱和密碼。 這是您在 Power BI 服務 中用來建立工作區並將報表上傳至的相同使用者。

步驟 6 - 服務主體 API 存取

提示

適用於:Applies to.服務主體 Does not apply to.主要使用者

只有在您使用服務主體驗證方法時,此步驟才相關。 如果您使用 主要使用者,請略過此步驟,然後繼續進行 步驟 7 - 啟用工作區存取

若要讓 Microsoft Entra 應用程式能夠存取 Power BI 內容和 API,Power BI 系統管理員必須在 Power BI 管理入口網站中啟用服務主體存取。 如果您不是租用戶的系統管理員,請取得租用戶的系統管理員,以為您啟用 租用戶設定

  1. [Power BI 服務] 中,選取 [設定> 設定 管理員> 入口網站]。

    A screenshot showing the admin settings menu option in the Power B I service settings menu.

  2. 選取 [租用戶設定 ],然後向下捲動至 [ 開發人員設定 ] 區段。

  3. 展開 [允許服務主體使用 Power BI API],然後啟用此選項。

    A screenshot showing how to enable the developer settings option, in the tenant settings menu option, in Power B I service.

注意

使用服務主體時,建議使用安全組限制其對租用戶設定的存取。 若要深入瞭解這項功能,請參閱服務主體文章中的下列各節:

步驟 7 - 啟用工作區存取

若要在 Power BI 服務 中啟用 Microsoft Entra 應用程式存取物件,例如報表、儀錶板和語意模型,請將服務主體或主要使用者新增為工作區的成員系統管理員

  1. 登入 Power BI 服務。

  2. 捲動至您想要啟用存取權的工作區,然後從 [更多 ] 功能選取 [ 工作區存取]。

    Screenshot showing the workspace access button in the more menu of a Power B I workspace.

  3. 在 [存取] 窗格中,根據您使用的驗證方法,將服務主體主要用戶複製到 [輸入電子郵件位址] 文本框。

    注意

    如果您使用 服務主體,其名稱就是您為 Microsoft Entra 應用程式提供的名稱。

  4. 選取新增

步驟 8 - 內嵌您的內容

Power BI 內嵌範例應用程式可讓您為客戶 Power BI 應用程式建立內嵌。

請遵循下列步驟來修改 客戶的 內嵌範例應用程式,以內嵌 Power BI 報表。

  1. 開啟 Power BI 開發人員範例資料夾。

  2. 選取 [ 程序代碼 ],然後選取 [ 下載 zip]。

    A screenshot showing the ZIP download option in the Power B I developer samples GitHub

  3. 解壓縮下載的 ZIP,並流覽至 PowerBI-Developer-Samples-master 資料夾。

  1. 根據您想要應用程式使用的語言,開啟下列其中一個資料夾:

    • .NET Core
    • .NET Framework
    • Java
    • Node JS
    • Python

    注意

    為客戶的內嵌範例應用程式僅支援上述架構。 React 範例應用程式僅支援組織解決方案的內嵌。

  2. 開啟 [為客戶內嵌] 資料夾。

  1. 使用下列其中一種方法,為您的客戶開啟內嵌範例應用程式

  2. 開啟 appsettings.json

  3. 根據您的驗證方法,填入下列參數值:

    參數 服務主體 主要使用者
    AuthenticationMode ServicePrincipal MasterUser
    ClientId 您的 Microsoft Entra 應用程式 用戶端識別碼 您的 Microsoft Entra 應用程式 用戶端識別碼
    TenantId 您的 Microsoft Entra 租用戶標識碼 N/A
    PbiUsername N/A 您的主要用戶名稱,請參閱Power BI使用者名稱和密碼
    PbiPassword N/A 您的主要用戶密碼,請參閱Power BI使用者名稱和密碼
    ClientSecret 您的 Microsoft Entra ID 用戶端密碼 N/A
    WorkspaceId 內嵌報表工作區的標識碼,請參閱 工作區標識符 內嵌報表工作區的標識碼,請參閱 工作區標識符
    ReportId 您要內嵌之報表的標識碼,請參閱 報表標識符 您要內嵌之報表的標識碼,請參閱 報表標識符
  4. 選取適當的選項以執行專案:

    • 如果您使用 Visual Studio,請選取 [IIS Express ][播放]。

    • 如果您使用 Visual Studio Code,請選取 [ 執行 > 開始偵錯]。

開發您的應用程式

設定和執行 客戶的 內嵌範例應用程式之後,您可以開始開發自己的應用程式。

試用Power BI內嵌式分析遊樂場,以開始開發,並跟上所有新的Power BI Embedded功能和更新。

當您準備好時,請檢閱 移至生產 需求。 您也需要容量,而且應該檢閱容量規劃文章,以建立最適合您需求的SKU。

重要

如果您使用免費內嵌試用令牌進行開發,則必須購買生產容量。 在購買容量之前, 免費試用版橫幅 會繼續出現在內嵌報表頂端。

更多問題嗎? 詢問 Power BI 社群