教學課程:使用客戶的應用程式內嵌範例內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. 註冊 Azure AD 應用程式

  3. 建立 Power BI 工作區

  4. 建立及發佈 Power BI 報表

  5. 取得內嵌參數值

  6. 服務主體 API 存取

  7. 啟用工作區存取

  8. 內嵌內容

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

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

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

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

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

步驟 2 - 註冊 Azure AD 應用程式

向 Azure AD 註冊應用程式可讓您:

若要向 Azure AD 註冊應用程式,請依照註冊您的應用程式中的指示進行。

注意

在註冊應用程式之前,您必須決定要使用哪種驗證方法:「服務主體」或「主要使用者」。

步驟 3 - 建立 Power BI 工作區

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

提示

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

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

  1. 登入 Power BI。

  2. 選取 [工作區]。

  3. 選取 [建立工作區]。

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

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

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

提示

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

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

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

  2. 選取 [Code] \(程式碼\),然後選取 [Download zip] \(下載 ZIP\)。

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

  3. 解壓縮下載的 ZIP 並巡覽至 Samples Reports 資料夾。

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

步驟 5 - 取得內嵌參數值

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

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

參數 服務主體 主要使用者
用戶端識別碼 Applies to. Applies to.
Workspace ID \(工作區識別碼\) Applies to. Applies to.
Report ID \(報表識別碼\) Applies to. Applies to.
用戶端密碼 Applies to. Does not apply to.
租用戶識別碼 Applies to. Does not apply to.
Power BI 使用者名稱 Does not apply to. Applies to.
Power BI 密碼 Does not apply to. Applies to.

用戶端識別碼

提示

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

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

  1. 登入 Microsoft Azure

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

  3. 選取您用來內嵌Power BI內容Azure AD應用程式。

  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內容Azure AD應用程式。

  4. 在 [管理] 底下,選取 [憑證和密碼]。

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

  6. 在 [新增用戶端祕密] 快顯視窗中,提供應用程式祕密的描述、選擇應用程式祕密何時到期,然後選取 [新增]。

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

注意

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

租用戶識別碼

提示

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

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

  1. 登入 Microsoft Azure

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

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

  4. 從 [概觀] 區段中,複製 [目錄 (租用戶) 識別碼] GUID。

Power BI 使用者名稱及密碼

提示

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

針對您要作為主要使用者的 Power BI 使用者,取得其「使用者名稱」和「密碼」。 這是 Power BI 服務中您用來建立工作區並將報表上傳到其中的相同使用者。

步驟 6 - 服務主體 API 存取

提示

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

只有當您使用「服務主體」驗證方法時,此步驟才有意義。 如果您使用「主要使用者」,請略過此步驟,並繼續進行步驟 7 - 啟用工作區存取

若要讓 Azure AD 應用程式能夠存取 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 - 啟用工作區存取

若要啟用 Azure AD 應用程式存取物件,例如 Power BI 服務中的報表、儀表板和資料集,請將 服務主體主要使用者新增為工作區 的成員管理員

  1. 登入 Power BI 服務。

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

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

  3. 在 [存取] 窗格中,視您使用的驗證方法而定,將「服務主體」或「主要使用者」複製到 [輸入電子郵件地址] 文字方塊。

    注意

    如果您使用「服務主體」,其名稱就是您提供給 Azure AD 應用程式的名稱。

  4. 選取 [新增]。

步驟 8 - 內嵌您的內容

Power BI Embedded 範例應用程式可讓您建立「對客戶進行內嵌」 Power BI 應用程式。

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

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

  2. 選取 [Code] \(程式碼\),然後選取 [Download zip] \(下載 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 您的 Azure AD 應用程式用戶端識別碼 您的 Azure AD 應用程式用戶端識別碼
    TenantId 您的 Azure AD 租用戶識別碼 N/A
    PbiUsername N/A 您的「主要使用者」使用者名稱,請參閱 Power BI 使用者名稱和密碼
    PbiPassword N/A 您的「主要使用者」密碼,請參閱 Power BI 使用者名稱和密碼
    ClientSecret 您的 Azure AD 用戶端祕密 N/A
    WorkspaceId 內嵌報表所在工作區的識別碼,請參閱工作區識別碼 內嵌報表所在工作區的識別碼,請參閱工作區識別碼
    ReportId 所要內嵌報表的識別碼,請參閱報表識別碼 所要內嵌報表的識別碼,請參閱報表識別碼
  4. 選取適當的選項來執行專案:

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

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

開發您的應用程式

設定並執行「對客戶進行內嵌」範例應用程式之後,您就可以開始開發自己的應用程式。

當您準備好時,請檢閱移至實際執行環境需求。 您也需要容量,並應檢閱容量規劃一文,以確定哪一個 SKU 最符合需求。

後續步驟