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

Zistite, ako vložiť analytický obsah do svojich aplikácií obchodných procesov pre národný cloud. Použite súpravu SDK platformy .NET služby Power BI spolu 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é cloudy:

• U.S. Government Community Cloud (GCC)

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

• Americkí vojenskí dodávatelia (DoDCON)

• Americká armáda (DoD)

• Cloud služby Power BI pre Čínu

Ak chcete spustiť zahájiť túto prehliadku, potrebujete mať konto Power BI. Ak nemáte nastavené konto, môžete si v závislosti od typu štátnej správy alebo krajiny či oblasti vybrať ten správny národný 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 tabuľu integrovať do webovej aplikácie, získajte tabuľu pomocou rozhrania API služby Power BI a overovcieho prístupového tokenu služby Azure Active Directory (AD). Načítajte tabuľu pomocou tokenu na vloženie. Rozhranie Power BI API 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 pre ukážku aplikácia vlastní údaje 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ť iba zo služby Government Community Cloud (GCC) pomocou skladovej jednotky Microsoft 365 SKU. Ostatní zákazníci používajúci národný cloud môžu použiť skladové jednotky SKU Microsoft 365 alebo Azure.

• Government Community Cloud (GCC):

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

  2. Potom pridajte nasledujúce parametre 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/" />
     

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

  1. V súboreWeb.config aktualizujte applicationId (natívna aplikácia applicationId), workspaceIdmeno 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úboreWeb.config aktualizujte applicationId (natívna aplikácia applicationId), workspaceIdmeno 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úboreWeb.config aktualizujte applicationId (natívna aplikácia applicationId), workspaceIdmeno používateľa (váš hlavný používateľ) a heslo.

  2. Ďalej 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 v službe Azure AD

Zaregistrujte svoju aplikáciu v službe Azure AD, aby ste mohli vykonávať volania rozhrania REST API. Ďalšie informácie nájdete v téme Registrácia aplikácie služby Azure AD na účely vkladania obsahu Power BI. Keďže existujú rozličné pridruženia národných 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

• 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ť získať ukážkuapplicationId, aby sa ukážka mohla overiť v službe Azure AD. Ak chcete nakonfigurovať ukážku, zmeňte applicationId súbor v web.config .

Krok 2 – získanie prístupového tokenu zo služby Azure AD

V rámci aplikácie bude treba získať prístupový token zo služby Azure AD. 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 služby Azure AD pre vašu aplikáciu služby Power BI. Keďže existujú rozličné pridruženia národných 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

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

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

Na príklady týchto prístupových tokenov sa môžete pozrieť v rámci jednotlivých úloh s položkami obsahu v súbore Controllers\HomeController.cs.

Krok 3 – vloženie obsahu

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

• Vloženie obsahu pre zákazníkov
• Vloženie obsahu pre vašu organizáciu

Ďalšie kroky

Ukážka vkladania pre zákazníkov

Power BI JavaScript API

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