Kurz: Vloženie obsahu služby Power BI do aplikácie pre národné/regionálne cloudy

  • Článok

Zistite, ako vložiť analytický obsah do svojich aplikácií obchodných procesov pre národný/regionálny cloud. Použite súpravu SDK platformy .NET služby Power BI s rozhraním JavaScript API služby Power BI na vloženie zostavy, tabule alebo dlaždice do vašej webovej aplikácie.

Power BI podporuje nasledujúce národné/regionálne cloudy:

  • U.S. Government Community Cloud (GCC)

  • U.S. Government Community Cloud High (GCC High)

  • Americkí armádní dodávatelia (DoDCON)

  • Americká armáda (DoD)

  • Cloud služby Power BI pre Čínu

Screenshot showing the Embed a dashboard feature.

Ak chcete začať s týmto návodom , budete potrebovať konto Power BI. Ak nemáte nastavené konto, môžete si v závislosti od typu štátnej správy alebo krajiny/oblasti vybrať ten správny národný/regionálny cloud. Zaregistrujte si konto Power BI pre štátnu správu USA alebo konto cloudu služby Power BI pre Čínu.

Poznámka

Chcete namiesto toho vložiť tabuľu pre svoju organizáciu? Pozrite si tému Integrácia tabule do aplikácie pre vašu organizáciu.

Ak chcete integrovať tabuľu do webovej aplikácie, získajte tabuľu pomocou rozhrania API služby Power BI a prístupového tokenu oprávnenia Microsoft Entra. Načítajte tabuľu pomocou tokenu na vloženie. Rozhranie API služby Power BI poskytuje programový prístup ku konkrétnym zdrojom služby Power BI . Ďalšie informácie nájdete v téme Rozhranie REST API služby Power BI, Súprava .NET SDK služby Power BI a Rozhranie JavaScript API služby Power BI.

Stiahnutie ukážky

V tomto článku sa nachádza kód ukážky týkajúcej sa danej aplikácie týkajúcej sa úschovy údajov v službe GitHub. Ak chcete postupovať podľa tohto návodu, stiahnite si ukážku. Používame .NET Framework/Embed for your customers adresár.

Dôležité

Obsah služby Power BI môžete vložiť len zo služby Government Community Cloud (GCC) prostredníctvom skladovej jednotky Microsoft 365 SKU. Ostatní zákazníci používajúci národný/regionálny cloud môžu použiť skladové jednotky SKU Microsoft 365 alebo Azure.

A screenshot that shows downloading the App Owns Data sample.

A screenshot that shows the App Owns Data directory.

  • Government Community Cloud (GCC):

    1. V súbore Web.config aktualizujte applicationId (natívna aplikácia applicationId), workspaceId, meno používateľa (váš hlavný používateľ) a heslo.

    2. Potom pridajte parametre GCC nasledovne.

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

  • Armádní dodávatelia (Military Contractors, DoDCON):

    1. V súbore Web.config aktualizujte applicationId (natívna aplikácia applicationId), workspaceId, meno používateľa (váš hlavný používateľ) a heslo.

    2. Potom pridajte parametre DoDCON nasledovne.

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

  • Armáda (Military, DoD):

    1. V súbore Web.config aktualizujte applicationId (natívna aplikácia applicationId), workspaceId, meno používateľa (váš hlavný používateľ) a heslo.

    2. Potom pridajte parametre DoDCON nasledovne.

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

  • Parametre cloudu služby Power BI pre Čínu

    1. V súbore Web.config aktualizujte applicationId (natívna aplikácia applicationId), workspaceId, meno používateľa (váš hlavný používateľ) a heslo.

    2. Potom pridajte parametre cloudu služby Power BI pre Čínu nasledovne.

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

Krok 1 – registrácia aplikácie na lokalite Microsoft Entra ID

Zaregistrujte svoju aplikáciu s Microsoft Entra ID na volanie rozhrania REST API. Ďalšie informácie nájdete v téme Registrácia aplikácie Microsoft Entra na účely vkladania obsahu služby Power BI. Keďže existujú rozličné pridruženia národných/regionálnych cloudov, na registráciu aplikácie sa používajú rozličné URL adresy.

  • Government Community Cloud (GCC) – https://app.powerbigov.us/apps

  • Military Contractors (DoDCON) – https://app.high.powerbigov.us/apps

  • Armáda (Military, DoD) – https://app.mil.powerbigov.us/apps

  • Cloud služby Power BI pre Čínu – https://app.powerbi.cn/apps

Ak ste si stiahli ukážku vloženia pre zákazníkov, môžete použiť applicationId zobrazenú položku, aby sa ukážka mohla overiť v službe Microsoft Entra ID. Ak chcete nakonfigurovať ukážku, zmeňte applicationId súbor web.config.

Krok 2 – získanie prístupového tokenu z Microsoft Entra ID

V rámci aplikácie bude potrebné získať prístupový token z identifikátora Microsoft Entra ID. Až potom bude možné vykonávať volania do rozhrania Power BI REST API. Ďalšie informácie nájdete v téme Overovanie používateľov a získanie prístupového tokenu Microsoft Entra pre vašu aplikáciu služby Power BI. Keďže existujú rozličné pridruženia národných/regionálnych cloudov, na získanie prístupového tokenu pre vašu aplikáciu sa používajú rozličné URL adresy.

  • Government Community Cloud (GCC) – https://login.microsoftonline.com

  • Military Contractors (DoDCON) – https://login.microsoftonline.us

  • Armáda (Military, DoD) – https://login.microsoftonline.us

  • Cloud služby Power BI pre Čínu – https://login.chinacloudapi.cn

Príklady týchto prístupových tokenov môžete vidieť v rámci každej úlohy položky obsahu v súbore Controllers\HomeController.cs .

Krok 3 – vloženie obsahu

Teraz, keď máte prístupový token, môžete pokračovať vo vkladaní rovnako ako v akejkoľvek inej platforme.

Súvisiaci obsah

Ukážka vkladania pre zákazníkov

Power BI JavaScript API

Máte ďalšie otázky? Spýtajte sa Komunita Power BI