Oktatóanyag: Power BI-tartalom beágyazása az alkalmazásba nemzeti felhőkhöz

Megtudhatja, hogyan ágyazhat be elemzési tartalmakat az üzleti folyamatalkalmazásaiba a nemzeti felhőbe. A Power BI .NET SDK és a Power BI JavaScript API használatával beágyazhat egy jelentést, irányítópultot vagy csempét a webalkalmazásokba.

A Power BI a következő országos felhőket támogatja:

• Egyesült Államok Kormányzati közösségi felhő (GCC)

• Amerikai kormányzati közösségi felhő magas (GCC High)

• Amerikai katonai alvállalkozók (DoDCON)

• Amerikai hadsereg (DoD)

• A kínai felhőhöz készült Power BI

A bemutató megkezdéséhez Power BI-fiókra van szükség. Ha nincs beállítva fiók, attól függően, hogy milyen típusú kormányt vagy országot/régiót használ, kiválaszthatja a megfelelő országos felhőt. Regisztráljon egy egyesült államokbeli kormányzati Power BI-fiókra vagy egy Kínai felhőhöz készült Power BI-fiókra.

Megjegyzés

Inkább egy irányítópultot szeretne beágyazni a szervezet számára? Lásd: Irányítópult integrálása a szervezet alkalmazásába.

Irányítópult webalkalmazásba való integrálásához használja a Power BI API-t és az Azure Active Directory (AD) engedélyezési hozzáférési jogkivonatát az irányítópult lekéréséhez. Töltse be az irányítópultot beágyazási jogkivonat használatával. A Power BI API szoftveres hozzáférést biztosít meghatározott Power BI-erőforrásokhoz. További információ: Power BI REST API, Power BI .NET SDK és Power BI JavaScript API.

A minta letöltése

Ez a cikk a GitHubon található Alkalmazástulajdonosi adatok minta kódját mutatja be. Az útmutató követéséhez töltse le a mintát. A könyvtárat .NET Framework/Embed for your customers használjuk.

Fontos

Power BI-tartalmakat csak a Kormányzati közösségi felhőből (GCC) ágyazhat be Microsoft 365 termékváltozattal. Az országos felhő más ügyfelei használhatják a Microsoft 365 vagy az Azure termékváltozatait.

• Kormányzati közösségi felhő (GCC):

  1. A Web.config fájlban frissítse applicationId a (natív alkalmazás applicationId), workspaceIda felhasználónevet (a fő felhasználót) és a jelszót.

  2. Ezután adja hozzá a GCC-paramétereket az alábbiak szerint.

     <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/" />
     

• Katonai alvállalkozók (DoDCON):

  1. A Web.config fájlban frissítse applicationId a (natív alkalmazás applicationId), workspaceIda felhasználónevet (a fő felhasználót) és a jelszót.

  2. Ezután adja hozzá a DoDCON-paramétereket az alábbiak szerint.

     <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/" />
     

• Katonaság (DoD):

  1. A Web.config fájlban frissítse applicationId a (natív alkalmazás applicationId), workspaceIda felhasználónevet (a fő felhasználót) és a jelszót.

  2. Ezután adja hozzá a DoDCON-paramétereket az alábbiak szerint.

     <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/" />
     

• A kínai felhőhöz készült Power BI paraméterei

  1. A Web.config fájlban frissítse applicationId a (natív alkalmazás applicationId), workspaceIda felhasználónevet (a fő felhasználót) és a jelszót.

  2. Ezután adja hozzá a Kínai Power BI felhőparamétereit az alábbiak szerint.

     <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\. lépés – alkalmazás regisztrálása az Azure AD-ben

A REST API-hívások indításához az alkalmazásokat regisztrálja az Azure AD-ben. További információt az Azure AD alkalmazás regisztrálása Power BI-tartalmak beágyazásához eljárást ismertető cikkben talál. Mivel különböző országos felhőszolgáltatások léteznek, különböző URL-címek használatával regisztrálhatja alkalmazását.

• Kormányzati közösségi felhő (GCC) – https://app.powerbigov.us/apps

• Katonai alvállalkozók (DoDCON) – https://app.high.powerbigov.us/apps

• Katonaság (DoD) – https://app.mil.powerbigov.us/apps

• A kínai felhőhöz készült Power BI – https://app.powerbi.cn/apps

Ha letöltötte az ügyfélmintához tartozó beágyazást, akkor a applicationId lekérést fogja használni, hogy a minta hitelesíteni tudja Azure AD. A minta konfigurálásához módosítsa a applicationIdweb.config fájlban.

2\. lépés – hozzáférési token lekérése az Azure AD-ből

Az alkalmazásban egy hozzáférési tokent kell beszereznie az Azure AD-ből, mielőtt hívásokat indíthatna a Power BI REST API-hoz. További információkért lásd a felhasználók hitelesítésével és a Power BI-alkalmazáshoz Azure AD hozzáférési token beszerzésével kapcsolatos cikket. Mivel különböző országos felhőszolgáltatások léteznek, különböző URL-címek használatával szerezheti be az alkalmazása hozzáférési jogkivonatát.

• Kormányzati közösségi felhő (GCC) – https://login.microsoftonline.com

• Katonai alvállalkozók (DoDCON) – https://login.microsoftonline.us

• Katonaság (DoD) – https://login.microsoftonline.us

• A kínai felhőhöz készült Power BI – https://login.chinacloudapi.cn

A Controllers\HomeController.cs fájlban lévő tartalomelem-feladatokban láthat példát ezekre a hozzáférési jogkivonatokra.

3. lépés – Tartalom beágyazása

Most, hogy rendelkezik hozzáférési jogkivonattal, folytathatja a beágyazást, ahogy bármely más platformon tenné.

• Tartalom beágyazása ügyfelek számára
• Tartalom beágyazása a szervezet számára

Következő lépések

Beágyazás az ügyfelek számára – minta

Power BI JavaScript API

További kérdései vannak? Kérdezze meg a Power BI közösségét