教學課程:將Power BI內容內嵌至適用于國家雲端的應用程式

瞭解如何在 國家雲端的商務程式應用程式中內嵌分析內容。 您可以使用 Power BI .NET SDK 搭配 Power BI JavaScript API 將報表、儀表板或圖格內嵌至 Web 應用程式。

Power BI支援下列國家雲端:

  • 美國政府社群雲端 (GCC)

  • 美國政府社群雲端高 (GCC高)

  • 美國軍事承包商 (DoDCON)

  • 美國軍事 (DoD)

  • 適用於中國雲端的 Power BI

Embedded dashboard

若要開始使用此逐步解說,您需要一個 Power BI 帳戶。 如未設定帳戶,則可以根據政府或國家/地區的類型,選擇正確的國家/地區雲端。 您可以註冊美國政府Power BI帳戶,或中國雲端帳戶的Power BI

注意

想要改為內嵌組織的內容嗎? 請參閱將儀表板整合到應用程式中

若要將儀表板整合到 Web 應用程式,請使用 Power BI API 和 Azure Active Directory (AD) 授權存取權杖,以取得儀表板。 然後,使用內嵌權杖載入儀表板。 Power BI API 可讓您以程式設計方式存取特定的 Power BI 資源。 如需詳細資訊,請參閱Power BI REST API、Power BI .NET SDK 和Power BI JavaScript API

下載範例

本文顯示 GitHub 上 App Owns Data 範例中所使用的程式碼。 若要依照本逐步解說進行,您可以下載範例。 我們將使用 .NET Framework/Embed for your customers 目錄。

重要

您只能使用 Microsoft 365 SKU 從政府社群雲端 (GCC) 內嵌 Power BI 內容。 其他國家/地區的雲端客戶可使用 Microsoft 365 或 Azure SKU

Downloading App Owns Data sample.

App Owns Data directory.

  • 政府社群雲端 (GCC):

    1. 更新 applicationId (原生應用程式 applicationId) 、workspaceId、主要使用者) 的使用者名稱 (,以及 Web.config 檔案中的密碼。

    2. 在 web.config 中新增 GCC 參數,如下所示。

      <add key="authorityUrl" value="https://login.microsoftonline.com/organizations/" />
      <add key="scopeBase" value="https://analysis.usgovcloudapi.net/powerbi/api/.default" />
      <add key="urlPowerBiServiceApiRoot" value="https://api.powerbigov.us/" />
      
  • 軍事承包商 (DoDCON):

    1. 更新 applicationId (原生應用程式 applicationId) 、workspaceId、主要使用者) 的使用者名稱 (,以及 Web.config 檔案中的密碼。

    2. 在 web.config 中新增 DoDCON 參數,如下所示。

      <add key="authorityUrl" value="https://login.microsoftonline.us/organizations/" />
      <add key="scopeBase" value="https://high.analysis.usgovcloudapi.net/powerbi/api/.default" />
      <add key="urlPowerBiServiceApiRoot" value="https://api.high.powerbigov.us/" />
      
  • 軍事 (DoD):

    1. 更新 applicationId (原生應用程式 applicationId) 、workspaceId、主要使用者) 的使用者名稱 (,以及 Web.config 檔案中的密碼。

    2. 在 web.config 中新增 DoDCON 參數,如下所示。

      <add key="authorityUrl" value="https://login.microsoftonline.us/organizations/" />
      <add key="scopeBase" value="https://mil.analysis.usgovcloudapi.net/powerbi/api/.default" />
      <add key="urlPowerBiServiceApiRoot" value="https://api.mil.powerbigov.us/" />
      
  • 適用於中國雲端的 Power BI 參數

    1. 更新 applicationId (原生應用程式 applicationId) 、workspaceId、主要使用者) 的使用者名稱 (,以及 Web.config 檔案中的密碼。

    2. 在 web.config 檔案中新增適用於中國雲端的 Power BI 參數,如下所示。

      <add key="authorityUrl" value="https://login.chinacloudapi.cn/organizations/" />
      <add key="scopeBase" value="https://analysis.chinacloudapi.cn/powerbi/api/.default" />
      <add key="urlPowerBiServiceApiRoot" value="https://api.powerbi.cn/" />
      

步驟 1 - 在 Azure AD 中註冊應用程式

在 Azure AD 中註冊應用程式以進行 REST API 呼叫。 如需詳細資訊,請參閱註冊 Azure AD 應用程式以內嵌 Power BI 內容。 因為有不同的國家/地區雲端聯盟,所以註冊應用程式的 URL 不同。

  • 政府社群雲端 (GCC): https://app.powerbigov.us/apps

  • 軍事承包商 (DoDCON): https://app.high.powerbigov.us/apps

  • 軍事 (DoD): https://app.mil.powerbigov.us/apps

  • 適用於中國雲端的 Power BI - https://app.powerbi.cn/apps

若您已經下載對客戶進行內嵌範例,就能使用取得的 applicationId 來設定範例,以向 Azure AD 驗證。 若要設定範例,請變更 web.config 檔案中的 applicationId

步驟 2 - 從 Azure AD 取得存取權杖

在您的應用程式中,您必須從 Azure AD 取得存取權杖,才能呼叫 Power BI REST API。 如需詳細資訊,請參閱 Authenticate users and get an Azure AD access token for your Power BI app (驗證使用者,並為 Power BI 應用程式取得 Azure AD 存取權杖)。 因為有不同的國家/地區雲端聯盟,所以取得應用程式存取權杖的 URL 不同。

  • 政府社群雲端 (GCC): https://login.microsoftonline.com

  • 軍事承包商 (DoDCON): https://login.microsoftonline.us

  • 軍事 (DoD): https://login.microsoftonline.us

  • 適用於中國雲端的 Power BI - https://login.chinacloudapi.cn

您可以在 Controllers\HomeController.cs 檔案的每個內容項目工作中看到這些存取權杖範例。

步驟 3 - 內嵌內容

現在您已擁有存取權杖,您可以像任何其他平臺上一樣繼續內嵌。

後續步驟

有其他問題嗎? 嘗試在 Power BI 社群提問