Kurz: Vložení obsahu Power BI pomocí ukázkového vložení pro aplikaci vašich zákazníků

PLATÍ PRO: Aplikace vlastní data , která uživatel vlastní.

Vložené analýzy a Power BI Embedded (nabídka Azure) umožňují vkládat obsah Power BI, jako jsou sestavy, řídicí panely a dlaždice, do vaší aplikace.

V tomto kurzu se naučíte:

  • Nastavte vložené prostředí.
  • Nakonfigurujte vložení pro vaše zákazníky (označované také jako aplikace vlastní data) ukázkovou aplikaci.

Pokud chcete aplikaci používat, uživatelé se nebudou muset přihlásit k Power BI ani mít licenci Power BI.

Pokud jste nezávislý dodavatel softwaru (ISV) nebo vývojář, který chce vytvářet aplikace pro třetí strany, doporučujeme použít metodu vložení pro vaše zákazníky .

Důležité

Pokud vkládáte obsah pro národní nebo regionální cloud, liší se několik prvních kroků tohoto kurzu. Podrobnosti najdete v tématu Vložení obsahu pro národní nebo regionální cloudy .

Specifikace ukázek kódu

Tento kurz obsahuje pokyny pro konfiguraci vložení pro ukázkovou aplikaci pro vaše zákazníky v některé z následujících architektur:

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

Ukázky kódu podporují následující prohlížeče:

  • Microsoft Edge
  • Google Chrome
  • Mozilla Firefox

Požadavky

Než začnete s tímto kurzem, ověřte, že máte níže uvedené závislosti Power BI i kódu:

metoda

Pokud chcete vytvořit vložení pro ukázkovou aplikaci pro zákazníky , postupujte takto:

  1. Vyberte metodu ověřování.

  2. Zaregistrujte aplikaci Microsoft Entra.

  3. Vytvořte pracovní prostor Power BI.

  4. Vytvoření a publikování sestavy Power BI

  5. Získejte hodnoty parametrů pro vložení.

  6. Přístup k rozhraní API instančního objektu

  7. Povolte přístup k pracovnímu prostoru.

  8. Vložte obsah.

Krok 1 – Výběr metody ověřování

Vložené řešení se bude lišit v závislosti na vybrané metodě ověřování. Proto je důležité porozumět rozdílům mezi metodami ověřování a rozhodnout se, která z nich nejlépe vyhovuje vašemu řešení.

Následující tabulka popisuje několik klíčových rozdílů mezi instančním objektema hlavními metodami ověřování uživatelů.

Situace Instanční objekt Hlavní uživatel
Mechanismus Instanční objekt vaší aplikace Microsoft Entra umožňuje, aby ID Microsoft Entra ověřilo vloženou aplikaci řešení v Power BI. Vaše aplikace Microsoft Entra používá k ověření v Power BI přihlašovací údaje (uživatelské jméno a heslo) uživatele Power BI.
Zabezpečení Instanční objekt je doporučená metoda autorizace Microsoft Entra ID. Pokud používáte instanční objekt, můžete se ověřit pomocí tajného kódu aplikace nebo certifikátu.

Tento kurz popisuje pouze použití instančního objektu s tajným kódem aplikace. Pokud chcete vložit pomocí instančního objektu a certifikátu, projděte si instanční objekt s článkem o certifikátu.
Tato metoda ověřování není tak zabezpečená jako instanční objekt. Musíte být opatrní pomocí přihlašovacích údajů hlavního uživatele (uživatelské jméno a heslo). Například nezpřístupňujte je ve vložené aplikaci a často změňte heslo.
Delegovaná oprávnění k ID Microsoft Entra Nepovinné. Váš hlavní uživatel nebo správce musí udělit souhlas pro vaši aplikaci pro přístup k oprávněním rozhraní REST API Power BI (označovaným také jako obory). Například Report.ReadWrite.All.
přístup k služba Power BI K služba Power BI nemůžete získat přístup pomocí instančního objektu. K služba Power BI můžete přistupovat pomocí přihlašovacích údajů hlavního uživatele.
Licence Nevyžaduje licenci Pro. Obsah můžete použít z libovolného pracovního prostoru, který jste členem nebo správcem. Vyžaduje licenci Power BI Pro nebo Premium na uživatele (PPU).

Krok 2 – Registrace aplikace Microsoft Entra

Registrace aplikace v Microsoft Entra ID umožňuje:

  • Vytvoření identity pro vaši aplikaci
  • Povolit aplikaci přístup k rozhraním REST API Power BI
  • Pokud používáte hlavního uživatele – Zadejte oprávnění REST vaší aplikace k Power BI.

Pokud chcete aplikaci zaregistrovat v Microsoft Entra ID, postupujte podle pokynů v části Registrace aplikace.

Poznámka:

Před registrací aplikace se budete muset rozhodnout, kterou metodu ověřování použít, instanční objekt nebo hlavní uživatel.

Krok 3 : Vytvoření pracovního prostoru Power BI

Power BI uchovává sestavy, řídicí panely a dlaždice v pracovním prostoru. Pokud chcete tyto položky vložit, budete je muset vytvořit a nahrát do pracovního prostoru.

Tip

Pokud už pracovní prostor máte, můžete tento krok přeskočit.

Pokud chcete vytvořit pracovní prostor, postupujte takto:

  1. Přihlaste se do Power BI

  2. Vyberte položku Pracovní prostory.

  3. Vyberte Vytvořit pracovní prostor.

  4. Pojmenujte pracovní prostor a vyberte Uložit.

Krok 4 : Vytvoření a publikování sestavy Power BI

Dalším krokem je vytvoření sestavy a nahrání sestavy do pracovního prostoru. Vlastní sestavu můžete vytvořit pomocí Power BI Desktopu a pak ji publikovat do svého pracovního prostoru. Nebo můžete nahrát ukázkovou sestavu do pracovního prostoru.

Tip

Pokud už máte pracovní prostor se sestavou, můžete tento krok přeskočit.

Pokud chcete stáhnout ukázkovou sestavu a publikovat ji do pracovního prostoru, postupujte takto:

  1. Otevřete složku ukázek GitHub Power BI Desktopu.

  2. Vyberte Kód a pak vyberte Stáhnout zip.

    A screenshot showing the ZIP download option in the Power B I desktop samples GitHub

  3. Extrahujte stažený soubor ZIP a přejděte do složky Ukázkové sestavy .

  4. Vyberte sestavu, kterou chcete vložit, a publikujte ji do pracovního prostoru.

Krok 5 – získání hodnot vložených parametrů

Pokud chcete vložit obsah, musíte získat určité hodnoty parametrů. V následující tabulce jsou uvedeny požadované hodnoty a označuje, jestli se vztahují na metodu ověřování instančního objektu , hlavní metodu ověřování uživatelů nebo obojí.

Před vložením obsahu se ujistěte, že máte všechny níže uvedené hodnoty. Některé hodnoty se budou lišit v závislosti na používané metodě ověřování.

Parametr Instanční objekt Hlavní uživatel
ID klienta Applies to. Applies to.
ID pracovního prostoru Applies to. Applies to.
ID sestavy Applies to. Applies to.
Tajný klíč klienta Applies to. Does not apply to.
ID klientu Applies to. vyžadováno pouze pro Js Node
Uživatelské jméno Power BI Does not apply to. Applies to.
Heslo Power BI Does not apply to. Applies to.

Client ID

Tip

Platí pro:Applies to. Hlavní uživatel instančního objektu Applies to.

Pokud chcete získat identifikátor GUID ID klienta (označovaný také jako ID aplikace), postupujte takto:

  1. Přihlaste se k Microsoft Azure.

  2. Vyhledejte Registrace aplikací a vyberte odkaz Registrace aplikací.

  3. Vyberte aplikaci Microsoft Entra, kterou používáte pro vložení obsahu Power BI.

  4. V části Přehled zkopírujte identifikátor GUID ID aplikace (klienta).

ID pracovního prostoru

Tip

Platí pro:Applies to. Hlavní uživatel instančního objektu Applies to.

Pokud chcete získat identifikátor GUID ID pracovního prostoru, postupujte takto:

  1. Přihlaste se ke službě Power BI.

  2. Otevřete sestavu, kterou chcete vložit.

  3. Zkopírujte identifikátor GUID z adresy URL. Identifikátor GUID je číslo mezi /groups/ a /reports/.

    A screenshot showing workspace ID GUID in the Power B I service U R L

Případně můžete ID pracovního prostoru najít v nastavení portálu Správa tak, že vyberete Podrobnosti vedle názvu pracovního prostoru.

A screenshot showing how to find the workspace I D from the admin settings.

ID sestavy

Tip

Platí pro:Applies to. Hlavní uživatel instančního objektu Applies to.

Pokud chcete získat identifikátor GUID ID sestavy, postupujte takto:

  1. Přihlaste se ke službě Power BI.

  2. Otevřete sestavu, kterou chcete vložit.

  3. Zkopírujte identifikátor GUID z adresy URL. Identifikátor GUID je číslo mezi /reports/ a /ReportSection.

    A screenshot showing report ID GUID in the Power B I service U R L

Tajný klíč klienta

Tip

Platí pro:Applies to. Hlavní uživatel instančního objektu Does not apply to.

Tajný klíč klienta získáte takto:

  1. Přihlaste se k Microsoft Azure.

  2. Vyhledejte Registrace aplikací a vyberte odkaz Registrace aplikací.

  3. Vyberte aplikaci Microsoft Entra, kterou používáte pro vložení obsahu Power BI.

  4. V části Spravovat vyberte Certifikáty a tajné kódy.

  5. V části Tajné kódy klienta vyberte Nový tajný klíč klienta.

  6. V automaticky otevírané okně Přidat tajný klíč klienta zadejte popis tajného kódu aplikace, vyberte, kdy vyprší platnost tajného kódu aplikace, a vyberte Přidat.

  7. V části Tajné kódy klienta zkopírujte řetězec ve sloupci Hodnota nově vytvořeného tajného kódu aplikace. Hodnota tajného klíče klienta je VAŠE ID klienta.

Poznámka:

Ujistěte se, že při prvním zobrazení zkopírujete hodnotu tajného klíče klienta. Po přechodu mimo tuto stránku bude tajný klíč klienta skrytý a nebudete moct načíst jeho hodnotu.

ID tenanta

Tip

Platí pro:Applies to. Hlavní uživatel instančního objektu Does not apply to.

Pokud chcete získat identifikátor GUID ID tenanta, postupujte takto:

  1. Přihlaste se k Microsoft Azure.

  2. Vyhledejte Registrace aplikací a vyberte odkaz Registrace aplikací.

  3. Vyberte aplikaci Microsoft Entra, kterou používáte pro vložení obsahu Power BI.

  4. V části Přehled zkopírujte identifikátor GUID ID adresáře (tenanta).

Uživatelské jméno a heslo Power BI

Tip

Platí pro:Does not apply to. Hlavní uživatel instančního objektu Applies to.

Získejte uživatelské jméno a heslo uživatele Power BI, který používáte jako hlavní uživatel. To je stejný uživatel, do služba Power BI jste použili k vytvoření pracovního prostoru a nahrání sestavy.

Krok 6 – Přístup k rozhraní API instančního objektu

Tip

Platí pro:Applies to. Hlavní uživatel instančního objektu Does not apply to.

Tento krok je relevantní jenom v případě, že používáte metodu ověřování instančního objektu. Pokud používáte hlavního uživatele, přeskočte tento krok a pokračujte krokem 7 – Povolení přístupu k pracovnímu prostoru.

Aby aplikace Microsoft Entra mohla získat přístup k obsahu a rozhraním API Power BI, musí správce Power BI povolit přístup instančního objektu na portálu pro správu Power BI. Pokud nejste správcem tenanta, získejte správce tenanta, aby vám povolil nastavení tenanta.

  1. V služba Power BI vyberte portál Nastavení> Nastavení> Správa.

    A screenshot showing the admin settings menu option in the Power B I service settings menu.

  2. Vyberte Nastavení tenanta a posuňte se dolů do části Nastavení pro vývojáře.

  3. Rozbalte možnost Povolit instančním objektům používat API Power BI a tuto možnost povolte.

    A screenshot showing how to enable the developer settings option, in the tenant settings menu option, in Power B I service.

Poznámka:

Při použití instančního objektu se doporučuje omezit přístup k nastavení tenanta pomocí skupiny zabezpečení. Další informace o této funkci najdete v těchto částech článku instančního objektu:

Krok 7 – Povolení přístupu k pracovnímu prostoru

Pokud chcete povolit přístup k objektům aplikace Microsoft Entra, jako jsou sestavy, řídicí panely a sémantické modely v služba Power BI, přidejte instanční objekt nebo hlavního uživatele jako člena nebo správce do pracovního prostoru.

  1. Přihlaste se ke službě Power BI.

  2. Přejděte do pracovního prostoru, pro který chcete povolit přístup, a v nabídce Další vyberte přístup k pracovnímu prostoru.

    Screenshot showing the workspace access button in the more menu of a Power B I workspace.

  3. V podokně Accessu v závislosti na používané metodě ověřování zkopírujte instanční objekt nebo hlavního uživatele do textového pole Zadat e-mailovou adresu.

    Poznámka:

    Pokud používáte instanční objekt, jeho název je název, který jste dali aplikaci Microsoft Entra.

  4. Vyberte Přidat.

Krok 8 : Vložení obsahu

Ukázková aplikace Power BI Embedded umožňuje vytvořit vložení pro aplikace Power BI pro vaše zákazníky .

Pokud chcete vložit sestavu Power BI, postupujte podle těchto kroků a upravte vložení ukázkové aplikace pro zákazníky .

  1. Otevřete složku ukázek pro vývojáře Power BI.

  2. Vyberte Kód a pak vyberte Stáhnout zip.

    A screenshot showing the ZIP download option in the Power B I developer samples GitHub

  3. Extrahujte stažený soubor ZIP a přejděte do složky PowerBI-Developer-Samples-master .

  1. V závislosti na jazyce, který má vaše aplikace používat, otevřete jednu z těchto složek:

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

    Poznámka:

    Vložení ukázkových aplikací pro vaše zákazníky podporuje pouze výše uvedené architektury. Ukázková aplikace React podporuje jenom vkládání pro řešení vaší organizace.

  2. Otevřete složku Vložit pro zákazníky.

  1. Pomocí jedné z těchto metod otevřete ukázkovou aplikaci pro vložení pro vaše zákazníky:

  2. Otevřete soubor appsettings.json.

  3. V závislosti na metodě ověřování vyplňte následující hodnoty parametrů:

    Parametr Instanční objekt Hlavní uživatel
    AuthenticationMode ServicePrincipal MasterUser
    ClientId ID klienta aplikace Microsoft Entra ID klienta aplikace Microsoft Entra
    TenantId ID vašeho tenanta Microsoft Entra
    PbiUsername N/A Uživatelské jméno hlavního uživatele , viz uživatelské jméno a heslo Power BI.
    PbiPassword Hlavní uživatelské heslo, viz uživatelské jméno a heslo Power BI.
    ClientSecret Tajný klíč klienta Microsoft Entra ID
    WorkspaceId ID pracovního prostoru s vloženou sestavou, viz ID pracovního prostoru. ID pracovního prostoru s vloženou sestavou, viz ID pracovního prostoru.
    ReportId ID sestavy, kterou vkládáte, viz ID sestavy. ID sestavy, kterou vkládáte, viz ID sestavy.
  4. Spusťte projekt výběrem příslušné možnosti:

    • Pokud používáte Visual Studio, vyberte IIS Express (přehrát).

    • Pokud používáte Visual Studio Code, vyberte Spustit spuštění > ladění.

Vývoj aplikace

Po konfiguraci a spuštění vložení pro ukázkovou aplikaci pro zákazníky můžete začít vyvíjet vlastní aplikaci.

Vyzkoušejte si dětské hřiště pro analýzy Power BI Embedded, abyste mohli začít vyvíjet a udržovat přehled o všech nových funkcích a aktualizacích Power BI Embedded.

Až budete připraveni, projděte si přechod na produkční požadavky. Budete také potřebovat kapacitu a měli byste si projít článek plánování kapacity a zjistit, která skladová položka nejlépe vyhovuje vašim potřebám.

Důležité

Pokud jste pro vývoj použili bezplatné zkušební tokeny pro vložení, musíte si koupit kapacitu pro produkční prostředí. Dokud se kapacita nekoupí, bude se banner s bezplatnou zkušební verzí dál zobrazovat v horní části vložené sestavy.

Máte ještě další otázky? Zeptejte se Komunita Power BI.