Sdílet prostřednictvím


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

PLATÍ PRO: Aplikace vlastní data Uživatel vlastní data

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

V tomto kurzu se naučíte:

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

Pokud chcete aplikaci používat, nemusí se uživatelé přihlašovat 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 tutoriál obsahuje pokyny pro konfiguraci zabudování pro ukázkovou aplikaci určenou vašim zákazníkům v některém z následujících frameworků:

  • .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ásledující závislosti Power BI a 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řte a publikujte sestavu Power BI

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

  6. Přístup k rozhraní API service principal

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

  8. Vložte obsah.

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

Vaše vložené řešení se liší 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ů.

Zvážení Instanční objekt služby Hlavní uživatel
Mechanismus Instanční objekt služby principal vaší aplikace Microsoft Entra umožňuje systému Microsoft Entra ID autentizovat vaši vloženou aplikaci řešení vůči 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í Service principal je doporučená metoda autorizace pro Microsoft Entra ID. Pokud používáte služební objekt, můžete se ověřit pomocí tajemství aplikace nebo certifikátu.

Tento kurz popisuje pouze použití služebního objektu se tajemstvím aplikace. Chcete-li vložit pomocí základní identity a certifikátu, nahlédněte do článku o základní identitě s certifikátem.
Tato metoda ověřování není tak zabezpečená jako služební účet. Musíte být ostražití vzhledem k přihlašovacím údajům 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 Na službu Power BI nemůžete získat přístup pomocí hlavního 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 pro jednotlivé uživatele (PPU).

Krok 2 – Registrace aplikace Microsoft Entra

Registrace aplikace v Microsoft Entra ID umožňuje:

  • Vytvoření identity pro vaši aplikaci
  • Umožněte 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, Service Principal nebo administrátorský uživatel.

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

Microsoft Fabric uchovává sestavy, řídicí panely a dlaždice v pracovním prostoru. Pokud chcete tyto položky vložit, musíte je vytvořit a nahrát do pracovního prostoru.

Návod

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 k Fabric.
  2. Vyberte položku Pracovní prostory.
  3. Vyberte + Nový pracovní prostor.
  4. Pojmenujte svůj pracovní prostor a vyberte Použít.

Krok 4: Vytvořte a publikujte sestavu Power BI

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

Návod

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

Pokud chcete stáhnout vzorkovou sestavu (není aktivována přímá propojení s Direct Lake) a publikovat ji na svůj pracovní prostor, postupujte takto:

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

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

    Snímek obrazovky s možností stažení SOUBORU ZIP v ukázkách Power BI Desktopu na GitHubu

  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.

Poznámka:

Pokud vaše sestava používá sémantický model Direct Lake, zkontrolujte tato omezení.

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

Pokud chcete vložit obsah, musíte získat určité hodnoty parametrů. Následující tabulka uvádí požadované hodnoty a označuje, zda se vztahují k metodě ověřování pomocí služby principal, metodě ověřování hlavního uživatele, nebo obojímu.

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

Parametr Instanční objekt služby Hlavní uživatel
ID klienta Platí pro. Platí pro.
ID pracovního prostoru Platí pro. Platí pro.
ID zprávy Platí pro Platí pro:
Tajný klíč klienta Platí pro. Nevztahuje se na.
ID nájemce Platí pro. vyžadováno pouze pro Js Node
Uživatelské jméno Power BI Nevztahuje se na. Platí pro.
Heslo Power BI Nevztahuje se na. Platí pro.

ID klienta

Návod

Platí pro:Platí pro.Service principal Platí pro.Hlavní uživatel

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

Návod

Platí pro:Platí pro.Instanční objekt služby Platí pro.Hlavní uživatel

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

    Snímek obrazovky ukazující GUID identifikátor pracovního prostoru v adrese URL služby Power BI

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

Snímek obrazovky znázorňující, jak najít ID pracovního prostoru z nastavení správce

ID zprávy

Návod

Platí pro:Platí pro.Service principal Platí pro.Hlavní uživatel

Chcete-li získat GUID identifikátor 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.

    Snímek obrazovky znázorňující identifikátor ID sestavy GUID ve službě Power BI URL

Tajný klíč klienta

Návod

Platí pro:Platí pro.Objekt služby Nevztahuje se na.Hlavní uživatel

Tajné heslo 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 klientského tajného klíče. Po přechodu mimo tuto stránku bude tajný klíč klienta skrytý a nebudete moct načíst jeho hodnotu.

ID nájemce

Návod

Platí pro:Instanční objekt.Nevztahuje se na hlavního uživatele.

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 GUID identifikátor adresáře (tenanta).

Uživatelské jméno a heslo Power BI

Návod

Platí pro:Nevztahuje se na.Servisní hlavní objekt Platí pro.Hlavní uživatel

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, kterého jste použili ve službě Power BI pro vytvoření pracovního prostoru a nahrání sestavy.

Krok 6 – Přístup k rozhraní API principála služby

Návod

Platí pro:Platí pro.Hlavní uživatel instančního objektu Nevztahuje se na.

Tento krok je relevantní jenom v případě, že používáte metodu ověřování service principal. 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 měla přístup k obsahu Power BI a jeho rozhraním API, musí správce Power BI povolit přístup služebního zástupce v portálu pro správu Power BI. Pokud nejste správcem vašeho tenanta, požádejte správce tenanta, aby vám povolil nastavení tenanta.

  1. Ve službě Power BI vyberte Nastavení, Nastavení, Portál pro správu.

    Snímek obrazovky s možností nabídky nastavení správce v nabídce nastavení služby Power BI

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

  3. Povolit principály služby, které mohou používat rozhraní Fabric API a tuto možnost povolit.

    Snímek obrazovky znázorňující, jak ve službě Power BI povolit možnost nastavení pro vývojáře v nabídce nastavení tenanta

Poznámka:

Při použití služebního principálu se doporučuje omezit jeho přístup k nastavení tenanta pomocí bezpečnostní skupiny. Další informace o této funkci najdete v těchto částech článku o service principal:

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

Pokud chcete povolit aplikaci Microsoft Entra přístup k objektům, jako jsou sestavy, řídicí panely a sémantické modely ve službě Power BI, přidejte service principal nebo hlavního uživatele jako člena nebo správce do pracovního prostoru.

  1. Přihlaste se k Fabric.

  2. Přejděte do pracovního prostoru, pro který chcete povolit přístup, a vyberte Spravovat přístup.

    Snímek obrazovky zobrazující tlačítko pro přístup k pracovnímu prostoru v nabídce více v prostředí Power BI.

  3. V podokně Access, v závislosti na používané metodě ověřování, zkopírujte služební principál nebo hlavního uživatele do textového pole Zadat e-mailovou adresu.

    Poznámka:

    Pokud používáte principál služby, 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 svou sestavu Power BI do ukázkové aplikace pro zákazníky, postupujte podle těchto kroků k úpravě vložení.

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

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

    Snímek obrazovky znázorňující možnost stažení SOUBORU ZIP v ukázkách Power BI pro vývojáře na GitHubu

  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 Vkládání 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 appsettings.json.

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

    Parametr Instanční objekt služby Hlavní uživatel
    AuthenticationMode Hlavní služba (ServicePrincipal) MasterUser
    ClientId ID klienta aplikace Microsoft Entra ID klienta aplikace Microsoft Entra
    TenantId ID vašeho tenanta Microsoft Entra
    PbiUsername 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 > Zahájit ladění.

Vývoj aplikace

Po konfiguraci a spuštění integrovaného řešení pro zákazníky jako ukázkové aplikace 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 není kapacita zakoupena, banner s Bezplatnou zkušební verzí se bude dál zobrazovat v horní části vložené sestavy.

Důležité informace a omezení

Pro režim Direct Lake platí následující omezení:

  • Vyžadujetoken pro vložení V2.
  • Pokud používáte služební účet, potřebujete připojení neměnné identity (ale bez SSO).
  • Nastavení instančního objektu jako metodu ověřování u připojení Pevná identita je jedinou možností podporovanou prostřednictvím automatizace. Další metody jsou podporovány ručně prostřednictvím portálu.

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