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

VZŤAHUJE SA NA: Aplikácia vlastní údaje Používateľ vlastní údaje

Vložené analýzy a služba Power BI Embedded (v ponuke Azure) vám umožňujú vkladať obsah služby Power BI, ako sú napríklad zostavy, tabule a dlaždice, do vašej aplikácie.

V tomto kurze sa naučíte:

• Nastavenie vloženého prostredia.
• Nakonfigurujte vzorovú aplikáciu vkladania obsahu pre zákazníkov (známu aj pod pojmom aplikácia vlastní údaje).

Ak chcete používať vašu aplikáciu, používatelia sa nebudú musieť prihlásiť do služby Power BI ani mať licenciu na Power BI.

Ak ste nezávislým dodávateľom softvéru (ISV) alebo vývojárom, ktorý chce vytvárať aplikácie pre tretie strany, odporúčame použiť metódu vkladania obsahu pre zákazníkov na vloženie obsahu služby Power BI.

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 zákazníkov pomocou niektorého z nasledujúcich architektúr:

• .NET Framework
• .NET Core
• Java
• Node JS
• Python

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

• Microsoft Edge
• Google Chrome
• Mozilla Firefox

Predpoklady

Pred začatím tohto kurzu overte, či máte v službe Power BI aj závislosti kód uvedené nižšie:

• Závislosti služby Power BI

  • Vlastný nájomník Microsoft Entra.

  • Ak chcete svoju aplikáciu overiť v službe Power BI, budete potrebovať jedno z týchto krokov:

    • Objekt služby – objekt služby Microsoft Entra, ktorý umožňuje identifikácii používateľa Microsoft Entra overiť vašu aplikáciu.

    • Licenciu na Power BI Pro – bude to váš hlavný používateľ a vaša aplikácia ju bude používať na overenie v službe Power BI.

    • Licenciu Power BI Premium Per User (PPU) – ide o vášho hlavného používateľa a vaša aplikácia ju bude používať na overenie v službe Power BI.

    Poznámka

    Ak chcete prejsť do fázy produkcie, budete potrebovať kapacitu.

• Závislosti kódu

.NET Core

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

• Integrované vývojové prostredie (IDE). Odporúčame použiť jedno z nasledujúcich:

  • Visual Studio

  • Visual Studio Code

.NET Framework

• .NET Framework 4.8

• Visual Studio

Java

• JDK (alebo JRE)

• Eclipse IDE - Verify that you have the Eclipse pre vývojárov Java EE (edícia pre veľké podniky)

• Binárne distribúcie Apache Tomcat

Node JS

• Node.js

• Integrované vývojové prostredie (IDE). Odporúčame použiť jedno z nasledujúcich:

  • Visual Studio

  • Visual Studio Code

Python

• Python 3 (alebo novšia verzia)

  Poznámka

  • Ak inštalujete Python prvýkrát, vyberte možnosť Add Python to PATH (Pridať Python k premennej PATH ), aby sa inštalačná cesta pridala do premennej PATH .
  • Ak už máte Python nainštalovaný, overte, či PATH premenná obsahuje jeho inštalačnú cestu. Ďalšie informácie nájdete v dokumentácii k jazyku Python Excursus: Setting environment variables (Exkurz: nastavenie premenných prostredia) (toto prepojenie odkazuje na verziu Python 3).

• Integrované vývojové prostredie (IDE). Odporúčame použiť jedno z nasledujúcich:

  • Visual Studio

  • Visual Studio Code

Spôsob

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

1. Vyberte metódu overovania.

2. Zaregistrujte aplikáciu Microsoft Entra.

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

4. Vytvorenie a publikovanie zostavy Power BI.

5. Získajte hodnoty parametra vkladania.

6. Prístup k API objektu služby

7. Povoľte prístup do pracovného priestoru.

8. Vložte svoj obsah.

Krok 1 – Vyberte metódu overovania

Vaše vložené riešenie sa bude líšiť v závislosti od vybratej metódy overovania. Preto je dôležité riešiť rozdiely medzi metódami overovania a vybrať tú, ktorá najlepšie vyhovuje vášmu riešeniu.

Nasledujúca tabuľka popisuje niekoľko kľúčových rozdielov medzi metódami overovania objektu služby a hlavného používateľa .

Úvahy	Objekt služby	Hlavný používateľ
Mechanizmus	Váš objekt služby aplikácie Microsoft Entra umožňuje identifikácii Microsoft Entra ID overiť aplikáciu vloženého riešenia v službe Power BI.	Vaša aplikácia Microsoft Entra používa prihlasovacie údaje (meno používateľa a heslo) používateľa služby Power BI na overenie v službe Power BI.
Zabezpečenie	Objekt služby je odporúčaná metóda overovania v identifikátore Microsoft Entra ID. Ak používate objekt služby, môžete ho overiť pomocou tajného kľúča aplikácie alebo certifikátu. Tento kurz popisuje iba použitie objektu služby s tajným kľúčom aplikácie. Ak chcete vkladať použitím objektu služby a certifikátu, prečítajte si článok objekt služby s certifikátom.	Táto metóda overovania nie je rovnako bezpečná ako objekt služby. Prihlasovacie údaje hlavného používateľa (meno používateľa a heslo) musíte dávať pozor. Nezobrazujte ich napríklad vo vašej vkladanej aplikácii a často nemeňte heslo.
Delegované povolenia pre ID Microsoft Entra	Nevyžaduje sa.	Váš hlavný používateľ alebo správca musí vašej aplikácii udeliť súhlas s prístupom k povoleniam rozhrania Power BI REST API (známym aj ako rozsahy). Napríklad Report.ReadWrite.All.
služba Power BI prístup	Nemôžete získať prístup k služba Power BI s objektom služby.	K služba Power BI máte prístup pomocou poverení hlavného používateľa.
Licencia	Nevyžaduje licenciu Pro. Obsah môžete použiť v ľubovoľnom pracovnom priestore, ktorého ste členom alebo správcom.	Vyžaduje licenciu na Power BI Pro alebo Premium na používateľa.

Krok 2 – Zaregistrujte aplikáciu Microsoft Entra

Registrácia aplikácie pomocou id Microsoft Entra ID vám umožňuje:

• Vytvorenie identity pre aplikáciu
• Umožnenie prístupu vašej aplikácie k rozhraniam REST API služby Power BI
• Ak používate hlavného používateľa – zadajte povolenia vašej aplikácie v službe Power BI REST

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

Poznámka

Pred registráciou aplikácie sa musíte rozhodnúť, ktorá metóda overovania sa má použiť, buď pomocou objektu služby alebo hlavného používateľa.

Krok č. 3 – Vytvorte pracovný priestor v službe 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 4 – 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 5 – získajte hodnoty parametra vkladania

Ak chcete vložiť svoj obsah, musíte získať určité hodnoty parametrov. V tabuľke nižšie sú uvedené požadované hodnoty a indikujú, či sú použiteľné pre metódu overovania objektom služby, hlavný používateľ metódy overovania alebo oboje.

Pred vložením obsahu sa uistite, že máte všetky hodnoty uvedené nižšie. Niektoré hodnoty sa budú líšiť v závislosti od metódy overenia, ktorú používate.

Parameter	Objekt služby	Hlavný používateľ
ID klienta
ID pracovného priestoru
ID zostavy
Tajný kľúč klienta
ID nájomníka		vyžaduje sa len pre Node JS
Meno používateľa služby Power BI
Heslo pre službu Power BI

ID klienta

Prepitné

Vzťahuje sa na:Hlavný používateľ služby

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) .

ID pracovného priestoru

Prepitné

Vzťahuje sa na:Hlavný používateľ služby

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 pracovného priestoru môžete nájsť aj v nastaveniach portálu Spravovanie tak, že vyberiete položku Podrobnosti vedľa názvu pracovného priestoru.

ID zostavy

Prepitné

Vzťahuje sa na:Hlavný používateľ služby

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.

   

Tajný kľúč klienta

Prepitné

Vzťahuje sa na:Hlavný používateľ služby

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.

Tenant ID

Prepitné

Vzťahuje sa na:Hlavný používateľ služby

Ak chcete načítať identifikátor ID GUID nájomníka, 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 adresára (nájomníka) .

Meno používateľa a heslo služby Power BI

Prepitné

Vzťahuje sa na:Hlavný používateľ služby

Získajte meno používateľa a heslo používateľa služby Power BI, ktoré používate ako hlavný používateľ. Ide o používateľa, ktorý ste použili na vytvorenie pracovného priestoru a nahratie zostavy v službe služba Power BI.

Krok 6 – prístup do rozhrania API objektu služby

Prepitné

Vzťahuje sa na:Hlavný používateľ služby

Tento krok je relevantný len vtedy, ak používate metódu overovania objektom služby. Ak používate hlavného používateľa, vynechajte tento krok a pokračujte krokom 7 – povoľte prístup do pracovného priestoru.

Ak chcete, aby aplikácia Microsoft Entra mohla získať prístup k obsahu služby Power BI a rozhraniam API, prístup k objektu služby musí povoliť správca služby Power BI na portáli na správu služby Power BI. Ak nie ste správcom nájomníka, požiadajte správcu nájomníka, aby vám povolil nastavenia nájomníka.

1. V služba Power BI vyberte položku Nastavenia> Nastavenia> Spravovanie portal.

   

2. Vyberte položku Nastavenia nájomníka a potom sa posuňte nadol do časti Nastavenia pre vývojára.

3. Rozbaľte možnosť Povoliť objektom služby používať rozhranie API služby Power BI a povoľte ju.

   

Poznámka

Pri používaní objektu služby sa odporúča obmedziť jeho prístup k nastaveniam nájomníka pomocou skupiny zabezpečenia. Ďalšie informácie o tejto funkcii nájdete v článku o objekte služby:

• Vytvorenie skupiny zabezpečenia v microsoft Entra
• Povolenie nastavení správcu služba Power BI

Krok 7 – povoľte prístup do pracovného priestoru

Ak chcete povoliť aplikácii Microsoft Entra prístup k objektom, ako sú napríklad zostavy, tabule a sémantické modely v služba Power BI, pridajte objekt služby alebo hlavného používateľa ako člena alebo správcu do pracovného priestoru.

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

2. Prejdite do pracovného priestoru, pre ktorý chcete povoliť prístup, a v ponuke Viac vyberte položku Prístup k pracovnému priestoru.

   

3. Na table Prístup v závislosti od toho, ktorú metódu overenia používate, skopírujte objekt služby alebo hlavného používateľa do textového poľa Zadajte e-mailovú adresu.

   Poznámka

   Ak používate objekt služby, jeho názov je názov, ktorý ste dodali pre vašu aplikáciu Microsoft Entra.

4. Stlačte možnosť Pridať.

Krok 8 – Vloženie obsahu

Ukážková aplikácia Power BI Embedded umožňuje vytvoriť aplikáciu Power BI na vkladanie obsahu pre zákazníkov .

Pri úprave vzorovej aplikácie vkladania obsahu pre zákazníkov 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. V závislosti od jazyka, ktorý má vaša aplikácia používať, otvorte jeden z týchto priečinkov:

   • .NET Core
   • .NET Framework
   • Java
   • Node JS
   • Python

   Poznámka

   Vzorové aplikácie vkladania obsahu pre zákazníkov podporujú iba rámce uvedené vyššie. Vzorová aplikácia React podporuje iba riešenie vkladania obsahu pre organizáciu.

5. Otvorte priečinok Embed for your customers (Vloženie obsahu pre zákazníkov).

.NET Core

6. Pomocou niektorej z týchto metód otvorte vzorové aplikácie vkladania obsahu pre zákazníkov:

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

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

7. Otvorte súbor appsettings.json.

8. V závislosti od metódy overenia vyplňte nasledujúce hodnoty parametrov:

   Parameter	Objekt služby	Hlavný používateľ
   AuthenticationMode	ServicePrincipal (ObjektSlužbu)	MasterUser (HlavnýPouser)
   ClientId	Vaše ID klienta aplikácie Microsoft Entra	Vaše ID klienta aplikácie Microsoft Entra
   TenantId	Vaše ID nájomníka microsoft Entra	Neaplikovateľné
   PbiUsername	Neaplikovateľné	Vaše meno hlavného používateľa nájdete v časti Meno a heslo používateľa služby Power BI
   PbiPassword	Neaplikovateľné	Vaše heslo pre hlavného používateľa nájdete v časti Meno a heslo používateľa služby Power BI
   ClientSecret	Váš tajný kľúč klienta Microsoft Entra ID	Neaplikovateľné
   WorkspaceId	ID pracovného priestoru s vloženou zostavou nájdete v časti ID pracovného priestoru	ID pracovného priestoru s vloženou zostavou nájdete v časti ID pracovného priestoru
   ReportId	ID zostavy, ktorú vkladáte, nájdete v časti ID zostavy	ID zostavy, ktorú vkladáte, nájdete v časti ID zostavy

9. 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.

.NET Framework

6. Pomocou Visual Studia otvorte súbor AppOwnsData.sln .

7. Otvorte web.config.

8. V závislosti od metódy overenia vyplňte nasledujúce hodnoty parametrov:

   Parameter	Objekt služby	Hlavný používateľ
   authenticationType	ServicePrincipal (ObjektSlužbu)	MasterUser (HlavnýPouser)
   applicationId	Vaše ID klienta aplikácie Microsoft Entra	Vaše ID klienta aplikácie Microsoft Entra
   workspaceId	ID pracovného priestoru s vloženou zostavou nájdete v časti ID pracovného priestoru	ID pracovného priestoru s vloženou zostavou nájdete v časti ID pracovného priestoru
   reportId	ID zostavy, ktorú vkladáte, nájdete v časti ID zostavy	ID zostavy, ktorú vkladáte, nájdete v časti ID zostavy
   pbiUsername	Neaplikovateľné	Vaše meno hlavného používateľa nájdete v časti Meno a heslo používateľa služby Power BI
   pbiPassword	Neaplikovateľné	Vaše heslo pre hlavného používateľa nájdete v časti Meno a heslo používateľa služby Power BI
   applicationSecret	Váš tajný kľúč klienta Microsoft Entra ID	Neaplikovateľné
   tenant	Vaše ID nájomníka microsoft Entra	Neaplikovateľné

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

Java

6. Otvorte prostredie Eclipse a postupujte podľa pokynov uvedených nižšie.

   Poznámka

   Pokyny pre vzorové aplikácie vkladania obsahu pre zákazníkov v jazyku Java nájdete v článku Eclipse IDE for Java EE Developers (podnikové vydanie). Ak používate inú aplikáciu, musíte ju nastaviť sami.

7. Pridajte server Tomcat do zatmenia:

   a. Vyberte položku Okno>Zobraziť servery zobrazenia.>

   b. Na karte servery vyberte položku No servers are available (K dispozícii nie sú žiadne servery). Kliknutím na toto prepojenie vytvoríte nový server.

   c. V okne Define a New Server (Zadefinujte nový server) rozbaľte položku Apache a vyberte server Tomcat, ktorý ste spustili na počítači. Napríklad Tomcat v9.0 Server.

   d. Vyberte Ďalej.

   e. V okne Tomcat Server vyberte položku Prehľadávať a prejdite do priečinka, ktorý obsahuje server Tomcat.

   f. V okne Tomcat Server vyberte položku Installed JREs (Nainštalované JREs).

   r. V okne Installed JREs (Nainštalované JREs) vyberte dostupné jre a potom vyberte položku Apply and Close (Použiť a zavrieť).

   h. V okne Tomcat Server vyberte položku Finish (Dokončiť). Server Tomcat budete môcť zobraziť na karte Servers ( Servery ).

8. Otvorte projekt v prostredí Eclipse:

   Dôležité

   V zariadení Eclipse sa môžu vyskytnúť problémy, ak je názov cesty príliš dlhý. Ak sa chcete tomuto problému vyhnúť, overte, či priečinok vašej vzorovej aplikácie nie je príliš hlboko vnorený v štruktúre priečinkov vášho počítača.

   a. Vyberte položku Súbor a potom vyberte položku Otvoriť projekty zo systému súborov.

   b. V okne Import Projects from File System or Archive (Importovať projekty zo systému súborov alebo archivovať) vyberte položku Directory (Adresár) a otvorte priečinok AppOwnsData.

   c. Stlačte možnosť Dokončiť.

9. Pridajte server Tomcat do projektu:

   a. Na table Package Explorer (Prieskumník balíkov) kliknite pravým tlačidlom myši na položku AppOwnsData a vyberte položku Properties (Vlastnosti).

   b. V okne Properties for AppOwnsData (Vlastnosti AppOwnsData) vyberte možnosť Targeted Runtimes (Cielené moduly runtime) a potom položku Apache Tomcat. Tento výber bude obsahovať verziu softvéru Apache Tomcat , ktorú používate, napríklad Apache Tomcat v9.0.

   c. Vyberte položku Použiť a zavrieť.

10. Vyplnenie požadovaných parametrov

    a. V časti Package explorer (Prieskumník balíkov) rozbaľte projekt AppOwnsData .

    b. Rozbaľte položku Java Resources (Zdroje jazyka Java).

    c. Rozbaľte položku src.

    d. Rozbaľte súbor com.embedsample.appoensdata.config.

    e. Otvorte položku Config.java.

    f. V závislosti od metódy overenia vyplňte nasledujúce hodnoty parametrov:

    Parameter	Objekt služby	Hlavný používateľ
    authenticationType	ServicePrincipal (ObjektSlužbu)	MasterUser (HlavnýPouser)
    workspaceId	ID pracovného priestoru s vloženou zostavou nájdete v časti ID pracovného priestoru	ID pracovného priestoru s vloženou zostavou nájdete v časti ID pracovného priestoru
    reportId	ID zostavy, ktorú vkladáte, nájdete v časti ID zostavy	ID zostavy, ktorú vkladáte, nájdete v časti ID zostavy
    clientId	Vaše ID klienta aplikácie Microsoft Entra	Vaše ID klienta aplikácie Microsoft Entra
    pbiUsername	Neaplikovateľné	Vaše meno hlavného používateľa nájdete v časti Meno a heslo používateľa služby Power BI
    pbiPassword	Neaplikovateľné	Vaše heslo pre hlavného používateľa nájdete v časti Meno a heslo používateľa služby Power BI
    tenantId	Vaše ID nájomníka microsoft Entra	Neaplikovateľné
    appSecret	Váš tajný kľúč klienta Microsoft Entra ID	Neaplikovateľné

11. Spustenie projektu

    a. V časti Package Explorer (Prieskumník balíkov) kliknite pravým tlačidlom na položku AppOwnesData.

    b. Vyberte položku Spustiť ako>spustiť na serveri.

    c. V okne Run on Server (Spustiť na serveri) vyberte položku Choose an existing server (Vybrať existujúci server) a vyberte server Tomcat.

    d. Stlačte možnosť Dokončiť.

Node JS

6. Otvorte priečinok App Owns Data pomocou preferovaného prostredia IDE. Odporúčame použiť jedno z nasledujúcich:

   • Visual Studio

   • Visual Studio Code

7. Otvorte terminál a nainštalujte požadované závislosti spustením príkazu: npm install.

8. Rozbaľte priečinok Config a otvorte súbor config.json.

9. V závislosti od metódy overenia vyplňte nasledujúce hodnoty parametrov:

   Parameter	Objekt služby	Hlavný používateľ
   authenticationMode	ServicePrincipal (ObjektSlužbu)	MasterUser (HlavnýPouser)
   clientId	Vaše ID klienta aplikácie Microsoft Entra	Vaše ID klienta aplikácie Microsoft Entra
   workspaceId	ID pracovného priestoru s vloženou zostavou nájdete v časti ID pracovného priestoru	ID pracovného priestoru s vloženou zostavou nájdete v časti ID pracovného priestoru
   reportId	ID zostavy, ktorú vkladáte, nájdete v časti ID zostavy	ID zostavy, ktorú vkladáte, nájdete v časti ID zostavy
   pbiUsername	Neaplikovateľné	Vaše meno hlavného používateľa nájdete v časti Meno a heslo používateľa služby Power BI
   pbiPassword	Neaplikovateľné	Vaše heslo pre hlavného používateľa nájdete v časti Meno a heslo používateľa služby Power BI
   clientSecret	Váš tajný kľúč klienta Microsoft Entra ID	Neaplikovateľné
   tenantId	Vaše ID nájomníka microsoft Entra	Vaše ID nájomníka microsoft Entra

10. Projekt spustite nasledovne:

    a. V termináli IDE spustite príkaz npm start.

    b. Otvorte novú kartu v prehliadači a prejdite na .http://localhost:5300

Python

6. Otvorte prostredie PowerShell alebo príkazový riadok.

7. Overte, či sa nachádzate v priečinku Python>Embed for your customers (Vloženie obsahu pre zákazníkov) a či sa v priečinku nachádza súbor requirements.txt, a spustite príkaz .pip3 install -r requirements.txt

8. Otvorte priečinok App Owns Data pomocou preferovaného prostredia IDE. Odporúčame použiť jedno z nasledujúcich:

   • Visual Studio

   • Visual Studio Code

9. Otvorte config.py.

10. V závislosti od metódy overenia vyplňte nasledujúce hodnoty parametrov:

    Parameter	Objekt služby	Hlavný používateľ
    AUTHENTICATION_MODE	ServicePrincipal (ObjektSlužbu)	MasterUser (HlavnýPouser)
    WORKSPACE_ID	ID pracovného priestoru s vloženou zostavou nájdete v časti ID pracovného priestoru	ID pracovného priestoru s vloženou zostavou nájdete v časti ID pracovného priestoru
    REPORT_ID	ID zostavy, ktorú vkladáte, nájdete v časti ID zostavy	ID zostavy, ktorú vkladáte, nájdete v časti ID zostavy
    TENANT_ID	Vaše ID nájomníka microsoft Entra	Neaplikovateľné
    CLIENT_ID	Vaše ID klienta aplikácie Microsoft Entra	Vaše ID klienta aplikácie Microsoft Entra
    CLIENT_SECRET	Váš tajný kľúč klienta Microsoft Entra ID	Neaplikovateľné
    POWER_BI_USER	Neaplikovateľné	Vaše meno hlavného používateľa nájdete v časti Meno a heslo používateľa služby Power BI
    POWER_BI_PASS	Neaplikovateľné	Vaše heslo pre hlavného používateľa nájdete v časti Meno a heslo používateľa služby Power BI

11. Uložte súbor.

12. Projekt spustite nasledovne:

    a. V prostredí PowerShell alebo v príkazovom riadku prejdite do priečinka Python>Embed for your customers>AppOwnesData a spustite príkaz .flask run

    b. Otvorte novú kartu v prehliadači a prejdite na .http://localhost:5000

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.

Vyskúšajte ihrisko pre vloženú analýzu služby Power BI, kde môžete začať vyvíjať a držať krok so všetkými novými funkciami a aktualizáciami služby Power BI Embedded.

Keď budete pripravení, prečítajte si požiadavky uvedené v časti Presun do fázy produkcie . Budete tiež potrebovať kapacitu a mali by ste si prečítať článok o plánovaní kapacity, aby ste zistili, ktoré skladové jednotky SKU najlepšie vyhovujú vašim potrebám.

Dôležité

Ak ste na vývoj používali bezplatné vkladacie skúšobné tokeny, musíte si kúpiť kapacitu na produkciu. Kým si nezakúpite kapacitu, v hornej časti vloženej zostavy sa bude naďalej zobrazovať pruh bezplatnej skúšobnej verzie .

Súvisiaci obsah

• Presun do produkcie
• Vloženie obsahu pre organizáciu
• Vloženie stránkovaných zostáv

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