設定 Power BI Embedded

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

如果您想要開始使用 Power BI Embedded 與其他人共用報表,請使用 Power BI 內嵌式分析設定工具來 開始使用。 本文會說明如何操作。

若要使用Power BI內嵌式分析,您必須在 Azure 中註冊 Microsoft Entra 應用程式。 Microsoft Entra 應用程式會建立 Power BI REST 資源的許可權,並允許存取 Power BI REST API

必要條件

若要設定 Power BI 內嵌式分析環境,您需要下列其中一項:

開始之前

在您註冊應用程式之前,請決定下列哪一個解決方案最符合您的需求:

為您的客戶內嵌

如果您建立專為客戶設計的應用程式,請使用內嵌 for-your-customers 解決方案,也稱為應用程式擁有數據。 使用者不需要登入 Power BI 或擁有 Power BI 授權即可使用您的應用程式。 您的應用程式會使用 主要用戶帳戶 (用於登入 Power BI 的 Power BI Pro 授權)或服務 主體,向 Power BI 進行驗證。

內嵌的客戶解決方案通常由為第三方建立應用程式的獨立軟體廠商 (ISV) 和開發人員使用。

為您的組織內嵌

如果您建立應用程式,要求使用者使用其認證來針對Power BI進行驗證,請使用embed-for-your-organization解決方案,也稱為使用者擁有數據

內嵌組織解決方案通常供企業和大型組織使用,且適用於內部使用者。

如需這兩個解決方案的詳細資訊,請參閱 什麼是PowerBI內嵌式分析解決方案?

設定您的環境

瞭解兩個內嵌選項之後,您可以使用設定工具來建立 Power BI Embedded 環境。

如果您想要手動設定環境,請略過下列各節中的步驟。 相反地,請遵循本文稍後的 手動註冊中的步驟。

重要

如果您要內嵌 GCC,請遵循手動註冊中的指示。

若要使用工具來設定您的環境,請移至 Power BI 內嵌式分析設定工具。 選取您想要的內嵌選項。

Screenshot of the Power BI embedded analytics setup tool. The options for embedding for your customers or for your organization are highlighted.

步驟 1 - 登入 Power BI

  1. 安裝工具的步驟 1 底下,選取 [ 登入]。 此步驟會將您登入 Power BI。 如果系統提示您挑選帳戶,請使用屬於Power BI租使用者的使用者登入。 Microsoft Entra 應用程式會在此用戶下註冊。

    Screenshot of the Power BI embedded analytics setup tool. Under Step 1, the Sign in button is highlighted.

    注意

    如果您已經登入,請確認您已使用您想要用來建立 Microsoft Entra 應用程式的使用者登入。 若要變更使用者,請選取 [註銷]。工具重新啟動之後,請使用正確的使用者登入。

  2. 選取 [下一步 ] 以移至下一個步驟。

    Screenshot of the Power BI embedded analytics setup tool after a user has signed in to Power BI. The Next button in highlighted.

步驟 2 - 註冊您的應用程式

在此步驟中,您會在 Azure 中註冊 Microsoft Entra 應用程式。 Microsoft Entra 應用程式會建立 Power BI REST 資源的許可權,並允許存取 Power BI REST API。 您稍後一律可以變更這些設定。

  1. 若要為您的客戶註冊您的應用程式,請填寫下列欄位:

    • 應用程式名稱 - 為您的應用程式指定名稱。

    • API 存取 - 選取應用程式所需的 Power BI API(也稱為範圍)。 您可以選取 [ 全部 選取] 以選取所有 API。 如需 Power BI 訪問許可權的詳細資訊,請參閱 Microsoft 身分識別平台 端點中的許可權和同意。

    Screenshot of the Power BI embedded analytics setup tool. The step for registering an app is visible, with an app name box and API access options.

  2. 選取註冊

  3. 您的 Microsoft Entra 應用程式應用程式識別碼會顯示在 [摘要] 方塊中。 複製此值以供稍後使用。

    Screenshot of the Power BI embedded analytics setup tool, with a Summary box on the right. Information in the box includes an application ID.

步驟 3 - 建立工作區 (選擇性)

在 Power BI 服務 中建立工作區:

  • 如果您已經有Power BI工作區,請選取 [ 略過]。

  • 若要建立工作區,請輸入工作區的名稱,然後選取 [ 建立工作區]。 您的工作區名稱和標識碼會出現在 [ 摘要 ] 方塊中。 複製這些值以供稍後使用。

    提示

    若要讓內嵌分析範例應用程式如預期般運作,您必須使用工具來建立工作區。

步驟 4 - 匯入內容 (選擇性)

選取下列其中一個選項:

  • 如果您有自己的 Power BI 應用程式,您可以選取 [ 略過]。

  • 如果您想要使用範例報表建立範例 Power BI 應用程式,請選取 [範例 Power BI 報表],然後選取 [ 匯入]。

  • 如果您想要使用自己的報表建立範例 Power BI 應用程式,請選取 [上傳 .pbix 檔案],瀏覽您的檔案,然後選取 [匯入]。

步驟 5 - 授與許可權(僅為客戶內 嵌)

選取 [ 授與許可權 ],然後在對話框中選取 [ 接受]。 此步驟可讓您的 Microsoft Entra 應用程式存取您選取的 API(也稱為範圍),並與您的登入使用者。 此使用者也稱為 主要使用者

下載範例應用程式 (選擇性)

如果您已建立 Power BI 工作區,並使用此工具將內容上傳至其中,您現在可以選取 [ 下載範例應用程式]。

注意

如果您略過選擇性階段,您仍然可以下載範例 Power BI 應用程式。 不過,下載應用程式中的程式代碼缺少註冊期間填入的屬性。 例如,如果您未建立工作區,範例應用程式不會包含工作區標識符。

請務必複製 [摘要] 方塊中的所有資訊。 Power BI 內嵌環境已可供使用。

手動註冊

如果您未使用 Power BI 內嵌式分析設定工具,請使用本節中的程式手動註冊 Microsoft Entra 應用程式。 但只有在您建立下列其中一個解決方案時,才採取這些步驟:

  • embed-for-your-organization 應用程式
  • 具有服務主體的內嵌客戶應用程式

如需如何在 Microsoft Entra ID 中註冊應用程式的詳細資訊,請參閱使用 Microsoft 身分識別平台 註冊應用程式。

  1. 登入 Azure 入口網站

  2. 選取頁面右上角的帳戶,以選取您的 Microsoft Entra 租使用者。

  3. 選取 應用程式註冊。 如果您沒有看到此選項,請搜尋它。

  4. [應用程式註冊] 中,選取 [新增註冊]。

  5. 填寫下列欄位:

    • 名稱 - 為您的應用程式指定名稱。

    • 支援的帳戶類型 - 選取誰可以使用應用程式。

  6. (選擇性)在 [ 重新導向 URI] 方塊中,新增重新導向 URL。

  7. 選取註冊。 註冊應用程式之後,系統會將您導向至應用程式的 [概觀] 頁面,您可以在其中取得 應用程式識別碼

更多問題嗎? 請嘗試詢問 Power BI 社群