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:

Metoda

K vytvoření ukázkové aplikace vkládání pro zákazníky použijte tento postup:

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

  2. Zaregistrujte aplikaci do Azure AD.

  3. Vytvořte pracovní prostor Power BI.

  4. Vytvořte sestavu Power BI a publikujte ji.

  5. Získejte hodnoty parametrů vkládání.

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

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

  8. Vložte obsah.

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

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:

  1. Přihlaste se k Power BI.

  2. Vyberte Pracovní prostory.

  3. Vyberte Vytvořit pracovní prostor.

  4. 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:

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

  2. Vyberte Code (Kód) a pak vyberte Download ZIP (Stáhnout soubor 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 Samples Reports (Ukázky sestav).

  4. 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 Applies to. Applies to.
ID pracovního prostoru Applies to. Applies to.
ID sestavy Applies to. Applies to.
Tajný kód klienta Applies to. Does not apply to.
ID tenanta Applies to. Does not apply to.
Uživatelské jméno Power BI Does not apply to. Applies to.
Heslo Power BI Does not apply to. Applies to.

ID klienta

Tip

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

K získání jedinečného identifikátoru ID klienta (označovaného také jako ID aplikace) použijte tento postup:

  1. Přihlaste se k Microsoft Azure.

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

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

  4. Z oddílu Přehled zkopírujte jedinečný identifikátor ID aplikace (klienta) .

ID pracovního prostoru

Tip

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

K získání jedinečného identifikátoru ID pracovního prostoru použijte tento postup:

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

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

  3. Zkopírujte z adresy URL jedinečný identifikátor (GUID). 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 pro správu 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.

Identifikátor GUID ID sestavy získáte takto:

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

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

  3. Zkopírujte z adresy URL jedinečný identifikátor (GUID). 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.

K získání tajného kódu klienta použijte tento postup:

  1. Přihlaste se k Microsoft Azure.

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

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

  4. V části Spravovat vyberte Tajné kódy certifikátů&.

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

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

  7. 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:Applies to. Hlavní uživatel instančního objektu Does not apply to.

K získání jedinečného identifikátoru ID tenanta použijte tento postup:

  1. Přihlaste se k Microsoft Azure.

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

  3. Vyberte aplikaci Azure AD, kterou používáte pro vkládání obsahu Power BI.

  4. 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: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é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:Applies to. Hlavní uživatel instančního objektu Does not apply to.

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.

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

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

  2. Vyberte Nastavení klienta a posuňte se dolů k oddílu Nastavení pro vývojáře.

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

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

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.

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

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

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

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

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

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

  2. Vyberte Code (Kód) a pak vyberte Download ZIP (Stáhnout soubor 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 ke složce 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 architektury uvedené výše. Ukázková aplikace React podporuje pouze vložení řešení vaší organizace.

  2. Otevřete složku Vkládání pro zákazníky.

  1. Otevřete ukázkovou aplikaci vkládání pro zákazníky Použijte jednu z těchto metod:

  2. Otevřete soubor appsettings.json.

  3. 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
  4. 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í.

Další kroky