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

Vložená analýza Power BI umožňuje vložit 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í.
  • Nakonfigurujte ukázkovou aplikaci pro vložení pro vaši organizaci (označovanou také jako uživatel vlastní data).

Pokud chcete aplikaci používat, budou se vaši uživatelé muset přihlásit k Power BI.

Řešení vkládání pro organizace obvykle používají podniky a velké organizace. Je určené interním uživatelům.

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 vaší organizace v jedné z následujících architektur:

  • .NET Framework
  • .NET Core
  • React TypeScript

Poznámka

Ukázky rozhraní .NET Core a .NET Framework umožní koncovému uživateli zobrazit libovolný řídicí panel, sestavu nebo dlaždici Power BI, ke kterým má přístup v služba Power BI. Ukázka React TypeScriptu umožňuje vložit pouze jednu sestavu, ke které už má koncový uživatel přístup k služba Power BI.

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

Pokud chcete vytvořit vložení pro ukázkovou aplikaci vaší organizace, postupujte takto:

  1. Zaregistrujte aplikaci do Azure AD.

  2. Vytvořte pracovní prostor Power BI.

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

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

  5. Vložte obsah.

Krok 1 – registrace aplikace Azure AD

Registrace aplikace pomocí Azure AD umožňuje vytvořit identitu vaší aplikace.

Pokud chcete aplikaci zaregistrovat do Azure AD, postupujte podle pokynů v tématu o registraci své aplikace.

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

Krok 3 – 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).

    Snímek obrazovky s možností stažení souboru ZIP s ukázkami Power BI Desktopu z GitHubu

  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.

Krok 4 – Získání hodnot parametrů pro vložení

Pokud chcete vložit obsah, budete muset získat několik hodnot parametrů. Hodnoty parametrů, které budete potřebovat, závisí na jazyce ukázkové aplikace, kterou chcete použít. Následující tabulka uvádí, které hodnoty parametrů se vyžadují pro každou ukázku.

Parametr .NET Core .NET Framework React TypeScript
ID klienta Pro toto platí. Platí pro. Pro toto platí.
Tajný kód klienta Pro toto platí. Platí pro. Nepoužívá se.
ID pracovního prostoru Nepoužívá se. Nepoužívá se. Pro toto platí.
ID sestavy Nepoužívá se. Nepoužívá se. Pro toto platí.

ID klienta

Tip

Platí pro:Platí pro.. NET Core platí pro.. NET Framework platí pro. React TypeScript

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 Azure AD aplikaci, kterou používáte pro vkládání obsahu Power BI.

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

Tajný klíč klienta

Tip

Platí pro:Platí pro.. NET Core platí pro.. NET Framework se nevztahuje na. React TypeScript

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 Azure AD aplikaci, kterou používáte pro vkládání 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 pracovního prostoru

Tip

Platí pro:Nevztahuje se na.. NET Core se nevztahuje na.. NET Framework platí pro. React TypeScript

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

    Snímek obrazovky znázorňuje jedinečný identifikátor ID pracovního prostoru v adrese URL služby Power BI

ID sestavy

Tip

Platí pro:Nevztahuje se na.. NET Core se nevztahuje na.. NET Framework platí pro. ReactTypeScript

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.

    Snímek obrazovky znázorňuje jedinečný identifikátor ID sestavy v adrese URL služby Power BI

5\. krok – Vložte obsah

Ukázková aplikace Power BI Embedded umožňuje vytvořit vložení pro aplikaci Power BI ve vaší organizaci .

Podle těchto kroků upravte vložení ukázkové aplikace vaší organizace a vložte sestavu Power BI.

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

    Snímek obrazovky s možností stažení souboru ZIP s ukázkami Power BI pro vývojáře z GitHubu

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

  1. Otevřete jednu složek podle toho, jaký jazyk aplikace používá:

    • .NET Core
    • .NET Framework
    • React-TS

    Poznámka

    Vložení pro ukázkové aplikace vaší organizace podporuje jenom architektury uvedené výše. Ukázkové aplikace Java, Node JS a Python podporují pouze vkládání pro vaše zákazníky .

Konfigurace aplikace Azure AD

  1. Přihlaste se k webu Azure Portal.

  2. Vyberte Registrace aplikací. Pokud tuto možnost nevidíte, vyhledejte ji.

  3. Otevřete aplikaci Azure AD, kterou jste vytvořili v kroku 1 – Zaregistrujte Azure AD aplikaci.

  4. V nabídce Spravovat vyberte Ověřování.

  1. V konfiguracích platformy otevřete webovou platformu a v části Identifikátory URI přesměrování přidejte https://localhost:5000/signin-oidc.

    Poznámka

    Pokud webovou platformu nemáte, vyberte Přidat platformu a v okně Konfigurovat platformy vyberte Web.

  2. Uložte provedené změny.

Snímek obrazovky znázorňující konfigurace ověřování aplikací Azure AD včetně přesměrování webu U R I pro ukázku aplikace .NET Core

Konfigurace ukázkové vložené aplikace

  1. Otevřete složku Vložit pro vaši organizaci .

  2. Otevřete ukázkovou aplikaci pro vložení pro vaši organizaci pomocí jedné z těchto metod:

  3. Otevřete appsettings.json a vyplňte následující hodnoty parametrů:

Spuštění ukázkové aplikace

  1. 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í.

  1. Přihlaste se k ukázkové aplikaci pro vložení.

    Poznámka

    Během prvního přihlášení se zobrazí výzva k povolení Azure AD oprávnění pro aplikaci.

  2. Když se ukázková aplikace pro vložení načte, vyberte obsah Power BI, který chcete vložit, a pak vyberte Vložit.

    Snímek obrazovky znázorňující ukázkovou aplikaci pro vložení Power BI

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.

Aktualizace uživatelských oprávnění

Aby mohl kdokoli získat přístup k sestavě, musí mít oprávnění pro přístup ke složce Power BI, ve které je sestava. Když někomu udělíte oprávnění pro přístup ke složce, změna se obvykle projeví až poté, co se uživatel přihlásí k portálu Power BI. Aby se nová oprávnění projevila okamžitě, proveďte ve scénáři Embedded explicitní volání rozhraní REST API s oprávněními refreshuser při spuštění. Toto volání rozhraní API aktualizuje oprávnění a zabrání chybám autorizace pro uživatele s nově udělenými oprávněními.

Další kroky