Kurz: Vložení Power BI obsahu pomocí ukázkové vložení pro aplikaci vašich zákazníků
Vložené analytické možnosti 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:
- Nastavit prostředí pro vkládání.
- Nakonfigurovat ukázkovou aplikaci vkládání pro zákazníky (označovanou také jako aplikace vlastní data).
Pokud chcete aplikaci používat, uživatelé se nebudou muset přihlásit k Power BI ani mít licenci na Power BI.
Metodu vkládání pro zákazníky doporučujeme použít, pokud chcete vkládat obsah Power BI a jste nezávislý výrobce softwaru (ISV) nebo vývojář, který chce vytvářet aplikace pro třetí strany.
Důležité
Pokud vkládáte obsah pro národní cloud, liší se několik prvních kroků tohoto kurzu. Podrobnosti najdete v tématu Vložení obsahu pro národní cloudy .
Specifikace ukázek kódu
Tento kurz obsahuje pokyny pro konfiguraci vložení pro ukázkovou aplikaci pro zákazníky v některé z následujících architektur:
- .NET Framework
- .NET Core
- Java
- Node.js
- Python
Ukázky kódu jsou podporované v následujících prohlížečích:
- Microsoft Edge
- Google Chrome
- Mozilla Firefox
Předpoklady
Před zahájením tohoto kurzu si zkontrolujte, že máte následující závislosti Power BI a kódu:
Závislosti Power BI
Vlastní klient Azure Active Directory.
K ověření aplikace v Power BI budete potřebovat některou z následujících možností nebo licencí:
Instanční objekt – instanční objekt Azure Active Directory (Azure AD) umožňuje Azure AD ověřit vaši aplikaci.
Licence Power BI Pro – to bude váš hlavní uživatel, kterého aplikace použije k ověření ve službě Power BI.
Licence Power BI Premium na uživatele (PPU) – bude váš hlavní uživatel, kterým se aplikace bude přihlašovat do Power BI.
Poznámka
K přesunu do provozu budete potřebovat kapacitu.
Závislosti kódu
.NET Core 3.1 SDK (nebo vyšší)
Integrované vývojové prostředí (IDE) Doporučujeme použít některé z následujících prostředí:
Metoda
K vytvoření ukázkové aplikace vkládání pro zákazníky použijte tento postup:
1\. krok – výběr metody ověřování
Vložené řešení se bude lišit podle toho, jakou metodu ověřování vyberete. Proto je důležité znát různé metody ověřování a jejich rozdíly, abyste mohli správně vybrat tu, která řešení nejvíce vyhovuje.
V následující tabulce jsou popsané některé hlavní rozdíly v metodách ověřování instanční objekt a hlavní uživatel.
Aspekty | Instanční objekt | Hlavní uživatel |
---|---|---|
Mechanismus | Instanční objekt aplikace Azure AD umožňuje Azure AD ověřit aplikaci s vloženým řešením v Power BI. | Aplikace Azure AD použije k ověření v Power BI přihlašovací údaje (uživatelské jméno a heslo) uživatele Power BI. |
Zabezpečení | Doporučená ověřovací metoda Azure AD je instanční objekt. 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 k vložení použít instanční objekt a certifikát, přečtěte si informace v článku o instančním objektu s certifikátem. | Tato metoda ověřování není tak zabezpečená jako instanční objekt. Musíte být opatrní s hlavními uživatelskými přihlašovacími údaji (uživatelské jméno a heslo). Například je nezpřístupňujte v aplikaci pro vložení a často změňte heslo. |
Delegovaná oprávnění Azure AD | Nevyžadují se. | Hlavní uživatel nebo správce musí souhlasit s tím, aby vaše aplikace měla oprávnění pro přístup k rozhraní REST API Power BI (označovaná také jako obory). Příklad: Report.ReadWrite.All. |
Přístup ke službě Power BI | Pro přístup ke službě Power BI nemůžete použít instanční objekt. | Přístup k této službě je možný s přihlašovacími údaji hlavního uživatele. |
Licence | Nevyžaduje se licence Pro. Můžete použít obsah z libovolného pracovního prostoru, kterého jste členem nebo správcem. | Vyžaduje licenci na Power BI Pro nebo Premium na uživatele (PPU). |
2\. krok – registrace aplikace do Azure AD
Registrace aplikace do Azure AD vám umožní:
- Zavést identitu aplikace.
- Umožní aplikaci přístup k rozhraním REST API Power BI.
- Pokud používáte hlavního uživatele, umožní zadat oprávnění REST služby Power BI vaší aplikace.
Pokud chcete aplikaci zaregistrovat do Azure AD, postupujte podle pokynů v tématu o registraci své aplikace.
Poznámka
Než svou aplikaci zaregistrujete, budete se muset rozhodnout, jakou použijete metodu ověřování. Jestli instanční objekt nebo hlavního uživatel.
3\. krok – vytvoření pracovního prostoru Power BI
Power BI uchovává sestavy, řídicí panely a dlaždice v pracovním prostoru. Abyste tyto položky mohli vkládat, potřebujete je vytvořit a nahrát do pracovního prostoru.
Tip
Pokud pracovní prostor už máte, můžete tento krok přeskočit.
K vytvoření pracovního prostoru použijte tento postup:
Přihlaste se k Power BI.
Vyberte Pracovní prostory.
Vyberte Vytvořit pracovní prostor.
Pracovní prostor pojmenujte a vyberte Uložit.
4\. krok – vytvoření a publikování sestavy Power BI
Dalším krokem je vytvoření sestavy a její nahrání do pracovního prostoru. V Power BI Desktopu můžete vytvořit vlastní sestavu a pak ji publikovat v pracovním prostoru. Nebo do něj můžete nahrát ukázkovou sestavu.
Tip
Pokud sestavu v pracovním prostoru už máte, můžete tento krok přeskočit.
Ke stažení ukázkové sestavy a jejímu publikování do pracovního prostoru použijte tento postup:
Otevřete v GitHubu složku ukázek Power BI Desktopu.
Vyberte Code (Kód) a pak vyberte Download ZIP (Stáhnout soubor ZIP).
Extrahujte stažený soubor ZIP a přejděte do složky Samples Reports (Ukázky sestav).
Vyberte sestavu, kterou chcete vložit, a publikujte ji do svého pracovního prostoru.
5\. krok – získání hodnot parametrů vkládání
Pokud chcete vložit obsah, musíte získat určité hodnoty parametrů. Následující tabulka ukazuje požadované hodnoty a označuje, jestli jsou použitelné pro metodu ověřování instančního objektu , hlavní metodu ověřování uživatele nebo obojí.
Před vložením obsahu zkontrolujte, že máte všechny níže uvedené hodnoty. Některé hodnoty se budou lišit podle toho, jakou metodu ověřování používáte.
Parametr | Instanční objekt | Hlavní uživatel |
---|---|---|
ID klienta | ![]() |
![]() |
ID pracovního prostoru | ![]() |
![]() |
ID sestavy | ![]() |
![]() |
Tajný kód klienta | ![]() |
![]() |
ID tenanta | ![]() |
![]() |
Uživatelské jméno Power BI | ![]() |
![]() |
Heslo Power BI | ![]() |
![]() |
ID klienta
Tip
Platí pro: Hlavní uživatel instančního objektu
K získání jedinečného identifikátoru ID klienta (označovaného také jako ID aplikace) použijte tento postup:
Přihlaste se k Microsoft Azure.
Vyhledejte Registrace aplikací a vyberte odkaz Registrace aplikací.
Vyberte aplikaci Azure AD, kterou používáte pro vložení obsahu Power BI.
Z oddílu Přehled zkopírujte jedinečný identifikátor ID aplikace (klienta) .
ID pracovního prostoru
Tip
Platí pro: Hlavní uživatel instančního objektu
K získání jedinečného identifikátoru ID pracovního prostoru použijte tento postup:
Přihlaste se ke službě Power BI.
Otevřete sestavu, kterou chcete vložit.
Zkopírujte z adresy URL jedinečný identifikátor (GUID). 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 sestavy
Tip
Platí pro: Hlavní uživatel instančního objektu
Identifikátor GUID ID sestavy získáte takto:
Přihlaste se ke službě Power BI.
Otevřete sestavu, kterou chcete vložit.
Zkopírujte z adresy URL jedinečný identifikátor (GUID). GUID je číslo mezi /reports/ a /ReportSection.
Tajný klíč klienta
Tip
Platí pro: Hlavní uživatel instančního objektu
K získání tajného kódu klienta použijte tento postup:
Přihlaste se k Microsoft Azure.
Vyhledejte Registrace aplikací a vyberte odkaz Registrace aplikací.
Vyberte aplikaci Azure AD, kterou používáte pro vložení obsahu Power BI.
V části Spravovat vyberte Tajné kódy certifikátů&.
V části Tajné kódy klienta vyberte Nový tajný kód klienta.
V automaticky otevíraném okně Přidat tajný kód klienta zadejte popis tajného kódu aplikace, dále vyberte, kdy tajný kód aplikace vyprší a vyberte Přidat.
Z oddílu Tajné kódy klienta zkopírujte řetězec ve sloupci Hodnota s nově vytvořeným tajným kódem aplikace. Hodnota tajného kódu 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: Hlavní uživatel instančního objektu
K získání jedinečného identifikátoru ID tenanta použijte tento postup:
Přihlaste se k Microsoft Azure.
Vyhledejte Registrace aplikací a vyberte odkaz Registrace aplikací.
Vyberte aplikaci Azure AD, kterou používáte pro vkládání obsahu Power BI.
Z oddílu Přehled zkopírujte jedinečný identifikátor ID adresáře (tenanta) .
Uživatelské jméno a heslo pro Power BI
Tip
Platí pro: Hlavní uživatel instančního objektu
Získejte uživatelské jméno a heslo uživatele Power BI, kterého používáte jako hlavního uživatele. Stejného uživatele jste použili k vytvoření pracovního prostoru a nahrání sestavy do služby Power BI.
6\. krok – přístup k rozhraní API instančního objektu
Tip
Platí pro: Hlavní uživatel instančního objektu
Tento krok je potřeba, jen když jako metodu ověřování používáte instanční objekt. Pokud používáte hlavního uživatele, můžete tento krok přeskočit a pokračovat 7. krokem – povolení přístupu k pracovnímu prostoru.
Aby mohla aplikace Azure AD získat přístup k obsahu a rozhraní 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ávce klienta, požádejte správce, aby vám povolil nastavení klienta.
Ve službě Power BI vyberte Nastavení>Nastavení>Portál pro správu.
Vyberte Nastavení klienta a posuňte se dolů k oddílu Nastavení pro vývojáře.
Rozbalte možnost Povolit instančním objektům používat rozhraní API pro Power BI a povolte ji.
Poznámka
Pokud používáte instanční objekt, doporučuje se omezit jeho přístup k nastavení klienta skupinou zabezpečení. Další informace o této funkci najdete v těchto oddílech článku o instančním objektu:
7\. krok – povolení přístupu k pracovnímu prostorou
Pokud chcete povolit přístup k objektům aplikace Azure AD, jako jsou sestavy, řídicí panely a datové sady v služba Power BI, přidejte instanční objekt nebo hlavního uživatele jako člena nebo správce do pracovního prostoru.
Přihlaste se ke službě Power BI.
Posuňte se k pracovnímu prostoru, pro který chcete povolit přístup, a v nabídce Více vyberte Přístup k pracovnímu prostoru.
V podokně Přístup zkopírujte instanční objekt nebo hlavního uživatele (podle toho, jakou metodu ověřování používáte) do textového pole Zadejte e-mailovou adresu.
Poznámka
Pokud používáte instanční objekt, odpovídá jeho název názvu, který jste dali aplikaci Azure AD.
Vyberte Přidat.
8\. krok – vložení obsahu
V ukázkové aplikaci Power BI Embedded můžete vytvořit aplikaci Power BI vkládání pro zákazníky.
K úpravě ukázkové aplikace vkládání pro zákazníky při vkládání sestavy Power BI použijte tento postup.
Otevřete složku ukázek Power BI pro vývojáře.
Vyberte Code (Kód) a pak vyberte Download ZIP (Stáhnout soubor ZIP).
Extrahujte stažený soubor ZIP a přejděte ke složce 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 architektury uvedené výše. Ukázková aplikace React podporuje pouze vložení řešení vaší organizace.
Otevřete složku Vkládání pro zákazníky.
Otevřete ukázkovou aplikaci vkládání pro zákazníky Použijte jednu z těchto metod:
Pokud používáte Visual Studio, otevřete soubor AppOwnsData.sln.
Pokud používáte Visual Studio Code, otevřete složku AppOwnsData.
Otevřete soubor appsettings.json.
Podle používané metody ověřování vyplňte následující hodnoty parametrů:
Parametr Instanční objekt Hlavní uživatel AuthenticationMode
ServicePrincipal MasterUser ClientId
ID klienta vaší aplikace Azure AD ID klienta vaší aplikace Azure AD TenantId
ID tenanta Azure AD N/A PbiUsername
N/A Vaše uživatelské jméno hlavního uživatele (viz Uživatelské jméno a heslo Power BI) PbiPassword
– Vaše heslo hlavního uživatele (viz Uživatelské jméno a heslo Power BI) ClientSecret
Tajný kód klienta Azure AD – 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 vkládané sestavy viz ID sestavy ID vkládané sestavy viz ID sestavy Vyberte příslušnou možnost a spusťte projekt:
Pokud používáte Visual Studio, vyberte IIS Express (přehrát).
Pokud používáte Visual Studio Code, vyberte Spustit > ladění.
Vývoj aplikace
Po nakonfigurování a spuštění ukázkové aplikace vkládání pro zákazníky můžete začít vyvíjet vlastní aplikaci.
Až budete připraveni, projděte si požadavky na přechod do ostrého provozu. Budete také potřebovat kapacitu. Měli byste si přečíst článek o plánování kapacity, abyste zjistili, jaké SKU vám nejlépe vyhovují.