教學課程:使用組織的應用程式內嵌範例內嵌來內嵌Power BI內容

Power BI 內嵌式分析可讓您將 Power BI 內容,例如報表、儀錶板和磚內嵌至您的應用程式。

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

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

若要使用您的應用程式,您的用戶必須登入 Power BI。

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

重要

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

程式代碼範例規格

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

  • .NET Framework
  • .NET Core
  • React TypeScript

注意

.NET Core.NET Framework 範例可讓用戶檢視他們在 Power BI 服務 中可存取的任何 Power BI 儀錶板、報表或磚。 React TypeScript 範例可讓您只內嵌一個使用者已在 Power BI 服務 中存取的報表。

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

  • Microsoft Edge
  • Google Chrome
  • Mozilla Firefox

必要條件

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


方法

若要為組織範例應用程式建立內嵌,請遵循下列步驟:

  1. 註冊 Microsoft Entra 應用程式

  2. 建立 Power BI 工作區

  3. 建立和發佈Power BI報表

  4. 取得內嵌參數值

  5. 內嵌您的內容

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

使用 Microsoft Entra ID 註冊您的應用程式可讓您建立應用程式的身分識別。

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

步驟 2 - 建立 Power BI 工作區

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

提示

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

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

  1. 登入 Power BI。

  2. 選取工作區

  3. 選取建立工作區

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

步驟 3 - 建立及發佈 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. 選取要內嵌的報表,並將其 發佈 至您的工作區。

步驟 4 - 取得內嵌參數值

若要內嵌您的內容,您必須取得一些參數值。 參數值取決於您要使用的範例應用程式語言。 下表列出每個範例所需的參數值。

參數 .NET Core .NET Framework React TypeScript
用戶端識別碼
用戶端密碼
工作區識別碼
報表標識碼

Client ID

提示

適用於: .NET Core .NET Framework React TypeScript

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

  1. 登入 Microsoft Azure

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

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

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

用戶端密碼

提示

適用於: .NET Core .NET Framework React TypeScript

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

  1. 登入 Microsoft Azure

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

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

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

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

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

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

注意

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

工作區識別碼

提示

適用於: .NET Core .NET Framework React TypeScript

若要取得工作區標識碼 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

報表標識碼

提示

適用於: .NET Core .NET Framework ReactTypeScript

若要取得報表標識元 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

步驟 5 - 內嵌您的內容

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
    • React-TS

    注意

    您組織範例應用程式的內嵌僅支援先前列出的架構。 Java、Node JS 和 Python 範例應用程式僅支援為客戶解決方案的內嵌。

設定您的 Microsoft Entra 應用程式

  1. 登入 Azure 入口網站

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

  3. 開啟您在步驟 1 - 註冊 Microsoft Entra 應用程式中建立的 Microsoft Entra 應用程式

  4. 從 [ 管理] 功能表中,選取 [ 驗證]。

  1. [平台組態] 中,開啟您的 Web 平台,然後在 [ 重新導向 URI] 區段中新增 https://localhost:5000/signin-oidc

    注意

    如果您沒有 Web 平臺,請選取 [新增平臺],然後在 [設定平臺] 視窗中,選擇 [Web]。

  2. 儲存您的變更。

Screenshot of the Azure portal window, which shows the app authentication configurations and the web redirect URI for the .NET core app sample.

設定範例內嵌應用程式

  1. 開啟 [為組織內嵌] 資料夾。

  2. 使用下列其中一種方法開啟組織範例應用程式的內嵌:

  3. 開啟 appsettings.json 並填入下列參數值:

執行範例應用程式

  1. 選取適當的選項以執行專案:

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

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

  1. 登入內嵌範例應用程式。

    注意

    在第一次登入期間,系統會提示您允許應用程式的 Microsoft Entra 許可權。

  2. 當內嵌範例應用程式載入時,請選取您想要內嵌的Power BI內容,然後選取 [ 內嵌]。

    Screenshot showing the Power BI embedding sample app.

開發您的應用程式

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

更新用戶權力

使用者需要許可權才能存取報表位於的 Power BI 資料夾。 當您授與使用者存取資料夾的許可權時,變更通常只會在使用者登入 Power BI 入口網站之後生效。 若要讓新的許可權立即生效,請在 Embedded 案例中,於啟動時明確呼叫 RefreshUser 許可權 REST API 。 此 API 呼叫會重新整理許可權,並避免新授與許可權的用戶發生授權失敗。