Kurz: Vkladanie obsahu zo služby Power BI pomocou ukážkovej vloženia pre vašu organizáciu

Analýza služby Power BI Embedded umožňuje do svojej aplikácie vkladať 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.
  • Konfigurácia vloženia pre vašu organizáciu (tiež známa ako aplikácia, ktorá je známa ako aplikácia, ktorá vlastní údaje)

Ak chcete používať aplikáciu, používatelia sa musia 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.

Špecifikácie ukážky kódov

Tento kurz obsahuje pokyny na konfiguráciu ukážkovej aplikácie na vkladanie pre vašu organizáciu v niektorom z nasledujúcich architektúr:

  • .NET 4.5 Framework
  • .NET Core
  • React Strojom

Poznámka

Ukážky pre .NET Core a .NET Framework umožnia koncovom používateľovi zobraziť ľubovoľnú tabuľu, zostavu alebo dlaždicu Power BI, ku nim má prístup v služba Power BI. Pomocou React TypeScript môžete vložiť iba jednu zostavu, ku ktorú už má koncový používateľ prístup služba Power BI.

Vzorové kódy podporujú tieto prehliadače:

  • Microsoft Edge
  • Google Chrome
  • Mozilla Firefox

Požiadavky

Pred tým, ako absolvujete tento kurz, skontrolujte, či viete dodržať tieto špecifikácie týkajúce sa Power BI aj kódov:


Metóda

Ak chcete vytvoriť ukážkovú aplikáciu na vloženie pre organizáciu, postupujte podľa týchto krokov:

  1. zaregistrujte aplikáciu pomocou služby Azure AD,

  2. vytvorte pracovný priestor v službe Power BI,

  3. vytvorte a publikujte zostavu Power BI,

  4. získajte hodnoty parametra vkladania,

  5. vložte svoj obsah.

Krok 1 – Registrácia aplikácie služby Azure AD

Registrácia aplikácie pomocou služby Azure AD vám umožní vytvoriť pre aplikáciu identitu.

Ak chcete zaregistrovať svoju aplikáciu v službe Azure AD, postupujte podľa pokynov v časti Registrácia aplikácie.

Krok 2 – Vytvorenie pracovného priestoru Power BI

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

Tip

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

Pri vytváraní pracovného priestoru postupujte takto:

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

  2. Vyberte položku Pracovný priestor.

  3. Vyberte možnosť Vytvoriť pracovný priestor.

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

Krok 3 – Vytvorenie a publikovanie zostavy 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 následne ju publikovať vo svojom pracovnom priestore. Alebo môžete nahrať vzorovú zostavu do pracovného priestoru.

Tip

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 nasledovne:

  1. Otvorte v GitHube priečinok so vzorovými objektami aplikácie Power BI Desktop.

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

    Snímka obrazovky znázorňujúca možnosť stiahnutia súboru ZIP na lokalite GitHub so vzorovými objektami aplikácie Power BI Desktop

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

  4. Vyberte zostavu, ktorá sa má vložiť, a ju publikujte ju v pracovnom priestore.

Krok 4 – Získanie hodnôt parametrov vkladania

Ak chcete vložiť obsah, budete musieť získať niekoľko hodnôt parametrov. Potrebné hodnoty parametrov závisia od jazyka ukážkovej aplikácie, ktorú chcete použiť. V tabuľke nižšie sú uvedené zoznamy hodnôt parametrov, ktoré sa vyžadujú pre každú vzorku.

Parameter .NET Core .NET Framework React Strojom
ID klienta Vzťahuje sa. Vzťahuje sa. Vzťahuje sa.
Tajný kľúč klienta Vzťahuje sa. Vzťahuje sa. Nevzťahuje sa na.
ID pracovného priestoru Nevzťahuje sa na. Nevzťahuje sa na. Vzťahuje sa na.
Identifikátor zostavy Nevzťahuje sa na. Nevzťahuje sa na. Vzťahuje sa na.

ID klienta

Tip

Vzťahuje sa na:  Vzťahuje sa na. . NET Core  vzťahuje sa na. .NET Framework Vzťahuje sa. React Strojom

Ak chcete načítať identifikátor ID GUID klienta (známy aj ako ID aplikácie), postupujte nasledovne:

  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 Azure AD, 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

Tip

Vzťahuje sa na:  Vzťahuje sa na. . NET Core  vzťahuje sa na. .NET Framework Nevzťahuje sa na. React Strojom

Pri načítavaní tajného kľúča klienta postupujte takto:

  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 Azure AD, ktorú používate na vkladanie obsahu služby Power BI.

  4. V časti Manage (Spravovať) vyberte položku Certificates & secrets (Certifikáty a tajné kľúče) .

  5. V časti Client secrets (Tajné kľúče 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ľúče klienta) skopírujte reťazec v stĺpci Value (Hodnota) novovytvoreného tajného kľúča klienta. Hodnota tajného kľúča klienta je vašim ID klienta.

Poznámka

Uistite sa, že skopírujete tajnú hodnotu klienta, keď sa prvýkrát zobrazí. Po prechode z tejto stránky bude tajomstvo klienta skryté a nebudete môcť načítať jeho hodnotu.

ID pracovného priestoru

Tip

Vzťahuje sa na:  Nevzťahuje sa na. . Nevzťahuje  sa na net core. .NET Framework Vzťahuje sa. React Strojom

Ak chcete načítať identifikátor ID GUID pracovného priestoru, postupujte nasledovne:

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

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

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

    Snímka obrazovky znázorňujúca identifikátor ID GUID pracovného priestoru v URL adrese služby Power BI

Identifikátor zostavy

Tip

Vzťahuje sa na:  Nevzťahuje sa na. . Nevzťahuje  sa na net core. .NET Framework Vzťahuje sa. ReactTypeScript

Ak chcete získať IDENTIFIKÁTOR GUID zostavy, postupujte podľa týchto krokov:

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

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

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

    Snímka obrazovky znázorňujúca identifikátor ID GUID zostavy v URL adrese služby Power BI

Krok 5 – Vloženie obsahu

Vzorová aplikácia Power BI Embedded umožňuje vytvoriť vkladanie pre vašu organizáciu aplikácie Power BI.

Ak chcete upraviť ukážkovú aplikáciu na vkladanie pre svoju organizáciu, použite tento postup na vloženie zostavy Power BI.

  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.

    Snímka obrazovky znázorňujúca možnosť stiahnutia súboru ZIP na lokalite GitHub so vzorovými objektami aplikácie Power BI Desktop

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

  1. V závislosti od jazyka, ktorý má vaša aplikácia používať, otvorte jeden z týchto priečinkov:

    • .NET Core
    • .NET Framework
    • React – TS

    Poznámka

    Ukážkové aplikácie na vkladanie pre vašu organizáciu podporujú iba vyššie uvedené rámce. Ukážkové aplikácie Java, Node JS a Python podporujú len riešenie na vkladanie pre vašich zákazníkov.

Konfigurácia aplikácie služby Azure AD

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

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

  3. Otvorte aplikáciu Azure AD, ktorú ste vytvorili v kroku 1 – Zaregistrujte aplikáciu Azure AD.

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

  1. V časti Konfigurácie platformy otvorte webovú platformu a v časti Redirect URI (URI presmerovania) pridajte https://localhost:5000/signin-oidc .

    Poznámka

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

  2. Zmeny uložte.

Snímka obrazovky zobrazujúca konfigurácie overovania aplikácie Azure AD vrátane presmerovania webu U R I pre vzorku základnej aplikácie .NET.

Konfigurácia aplikácie na vkladanie vzoriek

  1. Otvorte vloženie priečinka organizácie.

  2. Otvorte vloženie vzorovej aplikácie organizácie pomocou jednej z týchto metód:

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

Spustenie vzorovej 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 Run > Start Debugging.

  1. Prihláste sa do ukážkovej aplikácie na vkladanie.

    Poznámka

    Počas prvého prihlásenia sa zobrazí výzva na povolenie povolení služby Azure AD pre aplikáciu.

  2. Keď sa načíta ukážková aplikácia na vkladanie, vyberte obsah služby Power BI, ktorý chcete vložiť, a potom vyberte položku Vložiť.

    Snímka obrazovky zobrazujúca ukážkovú aplikáciu na vkladanie v službe Power BI.

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.

Ak ste pripravení, prečítajte si požiadavky uvedené v časti Presun do fázy produkcie. Budete tiež potrebovať kapacitu a mali by ste skontrolovaťčlánok o plánovaní kapacity, aby ste vytvorili, ktoré kapacity SKU najlepšieujú vaše potreby.

Ďalšie kroky