Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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:
Závislosti Power BI
Váš vlastní tenant Microsoft Entra.
K ověření aplikace v Power BI potřebujete jednu z následujících možností:
Objekt instančního principu Microsoft Entra - objekt instančního principu Microsoft Entra, který umožňuje Microsoft Entra ID ověřit vaši aplikaci.
Licence Power BI Pro – Jedná se o hlavního uživatele a vaše aplikace ji používá k ověření v Power BI.
Licence Power BI Premium Per User (PPU) – to je váš hlavní uživatel a vaše aplikace ho používá k ověření v Power BI.
Poznámka:
Pokud chcete přejít do produkčního prostředí, budete potřebovat kapacitu.
Závislosti kódu
.NET Core 3.1 SDK (nebo novější)
Integrované vývojové prostředí (IDE). Doporučujeme použít jedno z následujících prostředí:
metoda
Pokud chcete vytvořit vložení pro ukázkovou aplikaci pro zákazníky , postupujte takto:
Vyberte metodu ověřování.
Zaregistrujte aplikaci Microsoft Entra.
Vytvořte pracovní prostor Power BI.
Získejte hodnoty parametrů pro vložení.
Povolte přístup k pracovnímu prostoru.
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:
- Přihlaste se k Fabric.
- Vyberte položku Pracovní prostory.
- Vyberte + Nový pracovní prostor.
- 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:
Otevřete složku GitHub ukázek Power BI Desktop.
Vyberte Kód a pak vyberte Stáhnout ZIP.
Extrahujte stažený soubor ZIP a přejděte do složky Ukázkové sestavy .
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 |
|
|
| ID pracovního prostoru |
|
|
| ID zprávy |
|
|
| Tajný klíč klienta |
|
|
| ID nájemce |
|
vyžadováno pouze pro Js Node |
| Uživatelské jméno Power BI |
|
|
| Heslo Power BI |
|
|
ID klienta
Návod
Platí pro:
Service principal
Hlavní uživatel
Pokud chcete získat identifikátor GUID ID klienta (označovaný také jako ID aplikace), postupujte takto:
Přihlaste se k Microsoft Azure.
Vyhledejte Registrace aplikací a vyberte odkaz Registrace aplikací.
Vyberte aplikaci Microsoft Entra, kterou používáte pro vložení obsahu Power BI.
V části Přehled zkopírujte identifikátor GUID ID aplikace (klienta).
ID pracovního prostoru
Návod
Platí pro:
Instanční objekt služby
Hlavní uživatel
Pokud chcete získat identifikátor GUID ID pracovního prostoru, postupujte takto:
Přihlaste se ke službě Power BI.
Otevřete sestavu, kterou chcete vložit.
Zkopírujte identifikátor GUID z adresy URL. Identifikátor GUID je číslo mezi /groups/ a /reports/.
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.
ID zprávy
Návod
Platí pro:
Service principal
Hlavní uživatel
Chcete-li získat GUID identifikátor sestavy, postupujte takto:
Přihlaste se ke službě Power BI.
Otevřete sestavu, kterou chcete vložit.
Zkopírujte identifikátor GUID z adresy URL. Identifikátor GUID je číslo mezi /reports/ a /ReportSection.
Tajný klíč klienta
Návod
Platí pro:
Objekt služby
Hlavní uživatel
Tajné heslo klienta získáte takto:
Přihlaste se k Microsoft Azure.
Vyhledejte Registrace aplikací a vyberte odkaz Registrace aplikací.
Vyberte aplikaci Microsoft Entra, kterou používáte pro vložení obsahu Power BI.
V části Spravovat vyberte Certifikáty a tajné kódy.
V části Tajné kódy klienta vyberte Nový tajný klíč klienta.
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.
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:

Pokud chcete získat identifikátor GUID ID tenanta, postupujte takto:
Přihlaste se k Microsoft Azure.
Vyhledejte Registrace aplikací a vyberte odkaz Registrace aplikací.
Vyberte aplikaci Microsoft Entra, kterou používáte pro vložení obsahu Power BI.
V části Přehled zkopírujte GUID identifikátor adresáře (tenanta).
Uživatelské jméno a heslo Power BI
Návod
Platí pro:
Servisní hlavní objekt
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:
Hlavní uživatel instančního objektu 
Tento krok je relevantní jenom v případě, že používáte metodu ověřování service principal
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.
Ve službě Power BI vyberte Nastavení, Nastavení, Portál pro správu.
Vyberte Nastavení tenanta a posuňte se dolů do části Nastavení pro vývojáře.
Povolit principály služby, které mohou používat rozhraní Fabric API a tuto možnost povolit.
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.
Přihlaste se k Fabric.
Přejděte do pracovního prostoru, pro který chcete povolit přístup, a vyberte Spravovat přístup.
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.
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í.
Otevřete složku ukázek pro vývojáře Power BI.
Vyberte Kód a pak vyberte Stáhnout ZIP.
Extrahujte stažený soubor ZIP a přejděte do složky PowerBI-Developer-Samples-master .
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.
Otevřete složku Vkládání pro zákazníky.
Pomocí jedné z těchto metod otevřete ukázkovou aplikaci pro vložení pro vaše zákazníky:
Pokud používáte Visual Studio, otevřete AppOwnsData.sln soubor.
Pokud používáte Visual Studio Code, otevřete složku AppOwnsData .
Otevřete appsettings.json.
V závislosti na metodě ověřování vyplňte následující hodnoty parametrů:
Parametr Instanční objekt služby Hlavní uživatel AuthenticationModeHlavní služba (ServicePrincipal) MasterUser ClientIdID klienta aplikace Microsoft Entra ID klienta aplikace Microsoft Entra TenantIdID 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. ClientSecretTajný klíč klienta Microsoft Entra ID – WorkspaceIdID 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. ReportIdID sestavy, kterou vkládáte, viz ID sestavy ID sestavy, kterou vkládáte, viz ID sestavy 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.
Související obsah
Máte ještě další otázky? Zeptejte se Komunita Power BI.