Kurz: Vloženie obsahu služby Power BI pomocou ukážky vkladania obsahu pre aplikáciu organizácie

Vložená analýza služby Power BI umožňuje vkladať do aplikácie obsah služby Power BI, ako sú napríklad zostavy, tabule a dlaždice.

V tomto kurze sa naučíte:

• Nastavenie vloženého prostredia.
• Nakonfigurujte vzorovú aplikáciu vkladania obsahu pre organizáciu (známu aj pod pojmom používateľ vlastní údaje).

Ak chcete používať aplikáciu, používatelia sa budú musieť prihlásiť do služby Power BI.

Riešenie Vloženie obsahu pre organizáciu zvyčajne používajú podniky a veľké organizácie a je určené pre interných používateľov.

Dôležité

Ak vkladáte obsah pre národný/regionálny cloud, líšia sa prvé kroky tohto kurzu. Podrobnosti nájdete v téme Vloženie obsahu pre národné/regionálne cloudy .

Špecifikácie ukážky kódu

Tento kurz obsahuje pokyny na konfiguráciu vzorovej aplikácie vkladania obsahu pre organizáciu v niektorej z nasledujúcich architektúr:

• .NET Framework
• .NET Core
• React TypeScript

Poznámka

Ukážky rozhrania .NET Core a .NET Framework umožňujú koncovému používateľovi zobraziť všetky tabule, zostavy alebo dlaždice Power BI, ku ktorým má prístup v služba Power BI. Ukážka React TypeScript umožňuje vložiť iba jednu zostavu, ku ktorej už má váš koncový používateľ prístup v služba Power BI.

Vzorové kódy podporujú nasledujúce prehliadače:

• Microsoft Edge
• Google Chrome
• Mozilla Firefox

Predpoklady

Skôr než začnete s týmto kurzom, overte, či máte nasledujúce závislosti v službe Power BI aj kóde:

• Závislosti služby Power BI

  • Vlastný nájomník Microsoft Entra.

    • Jedna z nasledujúcich licencií:

      • Power BI Pro

      • Premium na používateľa (PPU)

    Poznámka

    Ak chcete prejsť do produkčného prostredia, budete potrebovať jednu z nasledujúcich konfigurácií:

    • Všetci používatelia s licenciami Pro.
    • Všetci používatelia s licenciami na Premium na používateľa.
    • SKU, ktorá je ekvivalentom alebo vyššou ako SKU F64. Táto konfigurácia umožňuje všetkým používateľom mať bezplatné licencie.

• Závislosti kódu

  .NET Core

  • .NET Core 3.1 SDK (alebo vyššia verzia)

  • Integrované vývojové prostredie (IDE). Odporúčame použiť niektorý z nasledujúcich identifikátorov ID:

    • Visual Studio

    • Visual Studio Code

  .NET Framework

  • .NET Framework 4.8

  • Visual Studio

  React TypeScript

  • Textový editor

  • Terminál príkazového riadka (alebo prostredie PowerShell)

---

Spôsob

Ak chcete vytvoriť vzorovú aplikáciu vkladania obsahu pre organizáciu , postupujte podľa týchto krokov:

1. Zaregistrujte aplikáciu Microsoft Entra.

2. Vytvorte pracovný priestor služby Power BI.

3. Vytvorenie a publikovanie zostavy Power BI.

4. Získajte hodnoty parametra vkladania.

5. Vložte svoj obsah.

Krok 1 – Zaregistrujte aplikáciu Microsoft Entra

Registrácia aplikácie pomocou identifikátora Microsoft Entra ID vám umožní vytvoriť pre aplikáciu identitu.

Ak chcete zaregistrovať svoju aplikáciu pomocou identifikátora Microsoft Entra ID, postupujte podľa pokynov v téme Registrácia aplikácie.

Krok č. 2 – Vytvorenie pracovného priestoru služby Power BI

Power BI udržiava zostavy, tabule a dlaždice v pracovnom priestore. Ak chcete tieto položky vložiť, musíte ich vytvoriť a nahrať ich do pracovného priestoru.

Prepitné

Ak už máte pracovný priestor, môžete tento krok preskočiť.

Ak chcete vytvoriť pracovný priestor, postupujte takto:

1. Prihláste sa do služby Power BI.

2. Vyberte položku Pracovné priestory.

3. Vyberte položku Vytvoriť pracovný priestor.

4. Pomenujte svoj pracovný priestor a vyberte položku Uložiť.

Krok č. 3 – Vytvorte a publikujte zostavu Power BI

Ďalším krokom je vytvorenie zostavy a jej nahratie do pracovného priestoru. Pomocou aplikácie Power BI Desktop môžete vytvoriť vlastnú zostavu a potom ju publikovať vo svojom pracovnom priestore. Prípadne môžete nahrať vzorovú zostavu do pracovného priestoru.

Prepitné

Ak už máte pracovný priestor so zostavou, môžete tento krok preskočiť.

Ak si chcete stiahnuť vzorovú zostavu a publikovať ju vo svojom pracovnom priestore, postupujte podľa týchto krokov:

1. Otvorte v GitHube priečinok so vzormi aplikácie Power BI Desktop.

2. Vyberte položku Code a potom vyberte položku Download zip.

   

3. Rozbaľte stiahnutý súbor ZIP a prejdite do priečinka Samples Reports .

4. Vyberte zostavu, ktorá sa má vložiť, a ju publikujte ju do pracovného priestoru.

Krok 4 – získajte hodnoty parametra vkladania

Ak chcete vložiť svoj obsah, musíte získať niekoľko hodnôt parametrov. Hodnoty parametrov závisia od jazyka ukážkovej aplikácie, ktorú chcete použiť. Nižšie uvedená tabuľka uvádza, ktoré hodnoty parametrov sa vyžadujú pre každú vzorku.

Parameter	.NET Core	.NET Framework	React TypeScript
ID klienta
Tajný kľúč klienta
ID pracovného priestoru
ID zostavy

ID klienta

Prepitné

Vzťahuje sa na: .NET Core .NET Framework React TypeScript

Ak chcete načítať identifikátor ID GUID klienta (známy aj ako ID aplikácie), postupujte podľa týchto krokov:

1. Prihláste sa do služby Microsoft Azure.

2. Vyhľadajte položku App registrations (Registrácie aplikácií ) a vyberte prepojenie App registrations (Registrácie aplikácií ).

3. Vyberte aplikáciu Microsoft Entra, ktorú používate na vkladanie obsahu služby Power BI.

4. V časti Prehľad skopírujte identifikátor GUID ID aplikácie (klienta) .

Tajný kľúč klienta

Prepitné

Vzťahuje sa na: .NET Core .NET Framework React TypeScript

Ak chcete získať tajný kľúč klienta, postupujte podľa týchto krokov:

1. Prihláste sa do služby Microsoft Azure.

2. Vyhľadajte položku App registrations (Registrácie aplikácií ) a vyberte prepojenie App registrations (Registrácie aplikácií ).

3. Vyberte aplikáciu Microsoft Entra, ktorú používate na vkladanie obsahu služby Power BI.

4. V časti Spravovať vyberte položku Certifikáty a tajné kódy.

5. V časti Client secrets (Tajné kódy klienta) vyberte položku New client secret ( Nový tajný kľúč klienta).

6. Do kontextového okna Pridanie tajného kľúča klienta zadajte popis tajného kľúča vašej aplikácie, vyberte dátum ukončenia jeho platnosti a vyberte položku Pridať.

7. V časti Client secrets (Tajné kódy klienta) skopírujte reťazec v stĺpci Value (Hodnota) novovytvoreného tajného kľúča aplikácie. Hodnota tajného kľúča klienta je vašim ID klienta.

Poznámka

Uistite sa, že ste skopírovali hodnotu tajného kľúča klienta pri jej prvom zobrazení. Po prechode z tejto stránky sa tajný kľúč klienta skryje a nebudete môcť načítať jeho hodnotu.

ID pracovného priestoru

Prepitné

Vzťahuje sa na: .NET Core .NET Framework React TypeScript

Ak chcete načítať identifikátor ID GUID pracovného priestoru, postupujte podľa týchto krokov:

1. Prihláste sa do služba Power BI.

2. Otvorte zostavu, ktorú chcete vložiť.

3. Skopírujte identifikátor GUID z URL adresy. Identifikátor GUID je číslo medzi položkami /groups/ a /reports/.

   

ID zostavy

Prepitné

Vzťahuje sa na: .NET Core .NET Framework ReactTypeScript

Ak chcete načítať identifikátor ID GUID zostavy, postupujte podľa týchto krokov:

1. Prihláste sa do služba Power BI.

2. Otvorte zostavu, ktorú chcete vložiť.

3. Skopírujte identifikátor GUID z URL adresy. Identifikátor GUID je číslo medzi položkami /reports/ a /ReportSection.

   

Krok 5 – Vloženie obsahu

Vzorová aplikácia Power BI Embedded umožňuje vytvoriť aplikáciu Power BI na vkladanie obsahu pre organizáciu .

Pri úprave vzorovej aplikácie vkladania obsahu pre organizáciu postupujte pri vkladaní zostavy služby Power BI nasledovne.

1. Otvorte priečinok s ukážkami služby Power BI pre vývojárov.

2. Vyberte položku Code a potom vyberte položku Download zip.

   

3. Rozbaľte stiahnutý súbor ZIP a prejdite do priečinka PowerBI-Developer-Samples-master .

4. Otvorte jeden z nasledujúcich priečinkov v závislosti od jazyka, ktorý má vaša aplikácia používať:

   • .NET Core
   • .NET Framework
   • React-TS

   Poznámka

   Vzorové aplikácie vkladania obsahu pre vašu organizáciu podporujú iba predtým uvedené rámce. Vzorové aplikácie Java, Node JS a Python podporujú iba riešenie Vloženie obsahu pre zákazníkov.

.NET Core

Konfigurácia aplikácie Microsoft Entra

1. Prihláste sa na portál Azure.

2. Vyberte položku App registrations (Registrácie aplikácií). Ak sa vám táto možnosť nezobrazuje, vyhľadajte ju.

3. Otvorte aplikáciu Microsoft Entra, ktorú ste vytvorili v kroku 1 – Registrácia aplikácie Microsoft Entra.

4. V ponuke Spravovať vyberte položku Overenie.

5. V časti Konfigurácie platformy otvorte webovú platformu a v časti Identifikátory URI presmerovania pridajte https://localhost:5000/signin-oidc.

   Poznámka

   Ak nemáte webovú platformu, vyberte položku Pridať platformu a v okne Konfigurácia platforiem vyberte položku Web.

6. Uloží zmeny.

Konfigurácia ukážkovej aplikácie vkladania

1. Otvorte priečinok Embed for your organization (Vloženie pre organizáciu).

2. Pomocou niektorej z týchto metód otvorte vzorové aplikácie vkladania obsahu pre organizáciu:

   • Ak používate Visual Studio, otvorte UserOwnsData.sln súbor.

   • Ak používate Visual Studio Code, otvorte priečinok UserOwnsData .

3. Otvorte appsettings.json a vyplňte nasledujúce hodnoty parametrov:

   • ClientId – Použitie identifikátora ID GUID klienta

   • ClientSecret – Použitie tajného kľúča klienta

Spustenie ukážkovej aplikácie

1. Projekt spustite výberom vhodnej možnosti:

   • Ak používate Visual Studio, vyberte položku IIS Express (prehrá sa).

   • Ak používate Visual Studio Code, vyberte položku Spustiť > ladenie Začať ladenie.

2. Prihláste sa do ukážkovej aplikácie vkladania.

   Poznámka

   Počas prvého prihlásenia sa zobrazí výzva na povolenie povolení aplikácie Microsoft Entra.

3. Po načítaní vzorovej aplikácie vkladania vyberte obsah služby Power BI, ktorý chcete vložiť, a potom vyberte položku Vložiť.

   

.NET Framework

Konfigurácia aplikácie Microsoft Entra

1. Prihláste sa na portál Azure.

2. Vyberte položku App registrations (Registrácie aplikácií). Ak sa vám táto možnosť nezobrazuje, vyhľadajte ju.

3. Otvorte aplikáciu Microsoft Entra, ktorú ste vytvorili v kroku 1 – Registrácia aplikácie Microsoft Entra.

4. V ponuke Spravovať vyberte položku Overenie.

5. V časti Konfigurácie platformy nakonfigurujte nasledujúce možnosti:

   1. Na svojej webovej platforme v časti Identifikátory URI presmerovania pridajte https://localhost:44300/.

      Poznámka

      Ak nemáte webovú platformu, vyberte položku Pridať platformu a v okne Konfigurovať platformy vyberte položku Web.

   2. V implicitnom udelení a hybridných postupoch povoľte možnosť Tokeny ID.

6. Uloží zmeny.

Konfigurácia ukážkovej aplikácie vkladania

1. Otvorte priečinok Embed for your organization (Vloženie pre organizáciu).

2. Pomocou programu Visual Studio otvorte súbor UserOwnsData.sln.

3. Otvorte Web.config a vyplňte nasledujúce hodnoty parametrov:

   • clientId – Použitie identifikátora ID GUID klienta

   • clientSecret – Použitie tajného kľúča klienta

Spustenie ukážkovej aplikácie

1. Projekt spustite výberom položky IIS Express (prehrá sa).

2. Prihláste sa do ukážkovej aplikácie vkladania.

   Poznámka

   Počas prvého prihlásenia sa zobrazí výzva na povolenie povolení aplikácie Microsoft Entra.

3. Po načítaní vzorovej aplikácie vkladania vyberte obsah služby Power BI, ktorý chcete vložiť, a potom vyberte položku Vložiť.

   

React TypeScript

Konfigurácia aplikácie Microsoft Entra

1. Prihláste sa na portál Azure.

2. Vyberte položku App registrations (Registrácie aplikácií). Ak sa vám táto možnosť nezobrazuje, vyhľadajte ju.

3. Otvorte aplikáciu Microsoft Entra, ktorú ste vytvorili v kroku 1 – Registrácia aplikácie Microsoft Entra.

4. V ponuke Spravovať vyberte položku Overenie.

5. V časti Konfigurácie platformy nakonfigurujte webovú platformu takto:

   1. Do časti Identifikátory URI presmerovania pridajte https://localhost:3000 a vyberte položku Konfigurovať.

      Poznámka

      Ak nemáte webovú platformu, vyberte položku Pridať platformu a v okne Konfigurácia platforiem vyberte položku Web.

   2. V implicitnom prideľovaní a hybridných postupoch povoľte obe možnosti:

      • Prístupové tokeny
      • Tokeny ID

6. Uloží zmeny.

Konfigurácia ukážkovej aplikácie vkladania

1. Otvorte priečinok Embed for your organization>UserOwnsData>src.

2. Pomocou textového editora otvorte súbor Config.ts a vyplňte nasledujúce hodnoty parametrov:

   • clientId – Použitie identifikátora ID GUID klienta

   • workspaceId – použitie ID pracovného priestoru

   • reportId – Použitie ID zostavy

3. Uložte súbor.

Spustenie ukážkovej aplikácie

1. Otvorte terminál a prejdite na položku Embed for your organization (Vloženie pre vašu organizáciu>UserOwnsData).

2. Nainštalujte požadované závislosti zadaním nasledujúceho príkazu:

   npm install

3. Spustite aplikáciu zadaním nasledujúceho príkazu:

   npm run start

   Poznámka

   Počas prvého prihlásenia sa zobrazí výzva na povolenie povolení aplikácie Microsoft Entra.

Vývoj aplikácie

Po nakonfigurovaní a spustení vzorovej aplikácie vkladania obsahu pre zákazníkov môžete začať vyvíjať svoju vlastnú aplikáciu.

Aktualizácia povolení používateľa

Používatelia potrebujú povolenie na prístup k priečinku služby Power BI, v ktorej sa zostava nachádza. Keď udelíte používateľovi povolenie na prístup k priečinku, zmena sa zvyčajne prejaví až po prihlásení používateľa na portál Power BI. Aby sa nové povolenia prejavili okamžite, v scenári Embedded explicitne zavolajte rozhranie RefreshUser Permissions REST API pri spustení. Toto volanie rozhrania API obnoví povolenia a zabráni zlyhaniam oprávnenia pre používateľov s novoprijatými povoleniami.

Súvisiaci obsah

Kurz: Vloženie obsahu služby Power BI pomocou ukážkovej aplikácie vkladania obsahu pre zákazníkov

Vloženie stránkovaných zostáv

Spýtajte sa Komunita Power BI