教學課程:使用組織的應用程式內嵌範例內嵌來內嵌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 和程式代碼相依性:
Power BI 相依性
-
下列其中一個授權:
-
程序代碼相依性
.NET Core 3.1 SDK (或更新版本)
整合式開發環境 (IDE)。 我們建議使用下列其中一個 IDE:
方法
若要為組織範例應用程式建立內嵌,請遵循下列步驟:
步驟 1 - 註冊 Microsoft Entra 應用程式
使用 Microsoft Entra ID 註冊您的應用程式可讓您建立應用程式的身分識別。
若要使用 Microsoft Entra ID 註冊您的應用程式,請遵循註冊您的應用程式中的指示。
步驟 2 - 建立 Power BI 工作區
Power BI 會將報表、儀錶板和磚保留在工作區中。 若要內嵌這些專案,您必須建立這些專案,並將其上傳至工作區。
提示
如果您已經有工作區,您可以略過此步驟。
若要建立工作區,請執行下列動作:
登入 Power BI。
選取工作區。
選取建立工作區。
為您的工作區命名,然後選取 [ 儲存]。
步驟 3 - 建立及發佈 Power BI 報表
下一個步驟是建立報表,並將其上傳至您的工作區。 您可以使用 Power BI Desktop 建立自己的報表 ,然後將 它發佈 至工作區。 或者,您可以將範例報表上傳至工作區。
提示
如果您已經有具有報表的工作區,您可以略過此步驟。
若要下載範例報表並將其發佈至您的工作區,請遵循下列步驟:
開啟 GitHub Power BI Desktop 範例 資料夾。
選取 [ 程序代碼 ],然後選取 [ 下載 zip]。
解壓縮下載的 ZIP,並流覽至 [範例報表] 資料夾。
選取要內嵌的報表,並將其 發佈 至您的工作區。
步驟 4 - 取得內嵌參數值
若要內嵌您的內容,您必須取得一些參數值。 參數值取決於您要使用的範例應用程式語言。 下表列出每個範例所需的參數值。
參數 | .NET Core | .NET Framework | React TypeScript |
---|---|---|---|
用戶端識別碼 | |||
用戶端密碼 | |||
工作區識別碼 | |||
報表標識碼 |
Client ID
提示
適用於: .NET Core .NET Framework React TypeScript
若要取得用戶端識別碼 GUID (也稱為 應用程式識別碼),請遵循下列步驟:
搜尋 應用程式註冊,然後選取 應用程式註冊 連結。
選取您用來內嵌 Power BI 內容的 Microsoft Entra 應用程式。
從 [概觀] 區段中,複製應用程式 (用戶端) 識別元 GUID。
用戶端密碼
提示
適用於: .NET Core .NET Framework React TypeScript
若要取得客戶端密碼,請遵循下列步驟:
搜尋 應用程式註冊,然後選取 應用程式註冊 連結。
選取您用來內嵌 Power BI 內容的 Microsoft Entra 應用程式。
在 [管理] 下,選取 [憑證與秘密]。
在 [用戶端祕密] 下,選取 [新增用戶端祕密]。
在 [ 新增客戶端密碼 ] 彈出視窗中,提供應用程式秘密的描述、選取應用程式秘密到期的時間,然後選取 [ 新增]。
從 [客戶端密碼] 區段中,複製新建立之應用程式秘密之 [值] 資料行中的字串。 用戶端密碼值是用戶端 識別碼。
注意
請務必在客戶端密碼值第一次出現時複製它。 離開此頁面之後,客戶端密碼將會隱藏,您將無法擷取其值。
工作區識別碼
提示
適用於: .NET Core .NET Framework React TypeScript
若要取得工作區標識碼 GUID,請遵循下列步驟:
登入 Power BI 服務。
開啟您想要內嵌的報表。
從 URL 複製 GUID。 GUID 是 /groups/ 和 /reports/之間的數位。
報表標識碼
提示
適用於: .NET Core .NET Framework ReactTypeScript
若要取得報表標識元 GUID,請遵循下列步驟:
登入 Power BI 服務。
開啟您想要內嵌的報表。
從 URL 複製 GUID。 GUID 是 /reports/ 和 /ReportSection 之間的數位。
步驟 5 - 內嵌您的內容
Power BI 內嵌範例應用程式可讓您為組織 Power BI 應用程式建立內嵌。
請遵循下列步驟來修改 組織 範例應用程式的內嵌,以內嵌 Power BI 報表。
選取 [ 程序代碼 ],然後選取 [ 下載 zip]。
解壓縮下載的 ZIP,並流覽至 PowerBI-Developer-Samples-master 資料夾。
根據您想要應用程式使用的語言,開啟下列其中一個資料夾:
- .NET Core
- .NET Framework
- React-TS
注意
您組織範例應用程式的內嵌僅支援先前列出的架構。 Java、Node JS 和 Python 範例應用程式僅支援為客戶解決方案的內嵌。
設定您的 Microsoft Entra 應用程式
登入 Azure 入口網站。
選取 應用程式註冊。 如果您看不到此選項,請搜尋它。
開啟您在步驟 1 - 註冊 Microsoft Entra 應用程式中建立的 Microsoft Entra 應用程式。
從 [ 管理] 功能表中,選取 [ 驗證]。
在 [平台組態] 中,開啟您的 Web 平台,然後在 [ 重新導向 URI] 區段中新增
https://localhost:5000/signin-oidc
。注意
如果您沒有 Web 平臺,請選取 [新增平臺],然後在 [設定平臺] 視窗中,選擇 [Web]。
儲存您的變更。
設定範例內嵌應用程式
開啟 [為組織內嵌] 資料夾。
使用下列其中一種方法開啟組織範例應用程式的內嵌:
如果您使用 Visual Studio,請開啟 UserOwnsData.sln 檔案。
如果您使用 Visual Studio Code,請開啟 UserOwnsData 資料夾。
開啟 appsettings.json 並填入下列參數值:
執行範例應用程式
選取適當的選項以執行專案:
如果您使用 Visual Studio,請選取 [IIS Express ][播放]。
如果您使用 Visual Studio Code,請選取 [ 執行 > 開始偵錯]。
登入內嵌範例應用程式。
注意
在第一次登入期間,系統會提示您允許應用程式的 Microsoft Entra 許可權。
當內嵌範例應用程式載入時,請選取您想要內嵌的Power BI內容,然後選取 [ 內嵌]。
開發您的應用程式
設定和執行 客戶的 內嵌範例應用程式之後,您可以開始開發自己的應用程式。
更新用戶權力
使用者需要許可權才能存取報表位於的 Power BI 資料夾。 當您授與使用者存取資料夾的許可權時,變更通常只會在使用者登入 Power BI 入口網站之後生效。 若要讓新的許可權立即生效,請在 Embedded 案例中,於啟動時明確呼叫 RefreshUser 許可權 REST API 。 此 API 呼叫會重新整理許可權,並避免新授與許可權的用戶發生授權失敗。