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

Vložené analytické možnosti Power BI umožňují do aplikace vkládat 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š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.

Vložení pro řešení vaší organizace obvykle používají podniky a velké organizace a jsou určené pro interní uživatele.

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 kurz obsahuje pokyny pro konfiguraci integrace ukázkové aplikace pro vaši organizaci v jednom z následujících rámců:

• .NET Framework
• .NET Core
• React TypeScript

Poznámka:

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

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 i kódu:

• Závislosti Power BI

  • Váš vlastní tenant Microsoft Entra.

  • Jedna z následujících licencí:

    • Microsoft Fabric

    • Power BI Pro

    • Premium na uživatele (PPU)

    Poznámka:

    Pokud chcete přesunout vloženou aplikaci do produkčního prostředí, budete potřebovat jednu z následujících konfigurací:

    • Všichni uživatelé s licencemi Pro.
    • Všichni uživatelé s licencemi PPU.
    • Skladová položka, která je ekvivalentní nebo vyšší než skladová položka F64. Tato konfigurace umožňuje všem uživatelům mít bezplatné licence.

• Závislosti kódu

  .NET Core

  • .NET Core 3.1 SDK (nebo novější)

  • Integrované vývojové prostředí (IDE). Doporučujeme použít jednu z následujících prostředí IDE:

    • Visual Studio

    • Visual Studio Code

  .NET Framework

  • .NET Framework 4.8

  • Visual Studio

  React TypeScript

  • Textový editor

  • Terminál příkazového řádku (nebo PowerShell)

---

metoda

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

1. Zaregistrujte aplikaci Microsoft Entra.
2. Vytvořte pracovní prostor Power BI.
3. Vytvořte a publikujte sestavu Power BI
4. Získejte hodnoty parametrů pro vložení.
5. Vložte obsah.

Krok 1 – registrace aplikace Microsoft Entra

Registrace aplikace pomocí Microsoft Entra ID umožňuje vytvořit identitu pro vaši aplikaci.

Pokud chcete aplikaci zaregistrovat v Microsoft Entra ID, postupujte podle pokynů v části Registrace aplikace.

Krok 2 : 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 3 : Vytvoření a publikování sestavy 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.

   

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.

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

Pokud chcete vložit obsah, budete muset získat několik hodnot parametrů. Hodnoty parametrů závisí na jazyce ukázkové aplikace, kterou chcete použít. Následující tabulka uvádí, které hodnoty parametrů jsou požadovány pro každý vzorek.

Parametr	.NET Core	.NET Framework	React TypeScript
ID klienta
Tajný klíč klienta
ID pracovního prostoru
ID zprávy

ID klienta

Návod

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

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

Tajný klíč klienta

Návod

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

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 pracovního prostoru

Návod

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

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 výkaz, který chcete zakomponovat.

3. Zkopírujte identifikátor GUID z adresy URL. Identifikátor GUID je číslo mezi /groups/ a /reports/.

   

ID zprávy

Návod

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

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.

   

Krok 5 : Vložení obsahu

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

Chcete-li upravit vložení ukázkové aplikace pro vaši organizaci a vložit sestavu Power BI, postupujte podle těchto kroků.

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

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

   

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

4. V závislosti na jazyce, který má vaše aplikace používat, otevřete jednu z následujících složek:

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

   Poznámka:

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

.NET Core

Konfigurace aplikace Microsoft Entra

1. Přihlaste se k webu Azure Portal.
2. Vyberte Registrace aplikací. Pokud tuto možnost nevidíte, vyhledejte ji.
3. Otevřete aplikaci Microsoft Entra, kterou jste vytvořili v kroku 1 – Zaregistrujte aplikaci Microsoft Entra.
4. V nabídce Spravovat vyberte Ověřování.

5. Ve Konfigurace platformy otevřete svou Web platformu a v sekci URI pro přesměrování přidejte https://localhost:5000/signin-oidc.

   Poznámka:

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

6. Uložte provedené změny.

Konfigurace ukázkové integrované aplikace

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

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

   • Pokud používáte Visual Studio, otevřete soubor UserOwnsData.sln .

   • Pokud používáte Visual Studio Code, otevřete složku UserOwnsData .

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

   • ClientId – Použijte identifikátor GUID ID klienta.

   • ClientSecret – Použití tajného klíče klienta

Spuštění ukázkové aplikace

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

2. Přihlaste se do ukázkové aplikace pro embedování.

   Poznámka:

   Během prvního přihlášení se zobrazí výzva, abyste aplikaci povolili oprávnění Microsoft Entra.

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

   

.NET Framework

Konfigurace aplikace Microsoft Entra

1. Přihlaste se k webu Azure Portal.
2. Vyberte Registrace aplikací. Pokud tuto možnost nevidíte, vyhledejte ji.
3. Otevřete aplikaci Microsoft Entra, kterou jste vytvořili v kroku 1 – Zaregistrujte aplikaci Microsoft Entra.
4. V nabídce Spravovat vyberte Ověřování.

5. V konfiguracích platformy nakonfigurujte následující možnosti:

   1. Ve vaší webové platformě, v sekci URI přesměrování, přidejte https://localhost:44300/.

      Poznámka:

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

   2. Ve implicitním udělení a hybridních tocích povolte možnost ID tokenů.

6. Uložte provedené změny.

Konfigurace ukázkové integrované aplikace

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

2. Pomocí Visual Studio otevřete soubor UserOwnsData.sln.

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

   • clientId – Použijte GUID klienta.

   • clientSecret - Použijte tajný klíč klienta.

Spuštění ukázkové aplikace

1. Spusťte projekt výběrem služby IIS Express (přehrát).

2. Přihlaste se do ukázkové aplikace pro embedování.

   Poznámka:

   Během prvního přihlášení se zobrazí výzva, abyste aplikaci povolili oprávnění Microsoft Entra.

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

   

React TypeScript

Konfigurace aplikace Microsoft Entra

1. Přihlaste se k webu Azure Portal.
2. Vyberte Registrace aplikací. Pokud tuto možnost nevidíte, vyhledejte ji.
3. Otevřete aplikaci Microsoft Entra, kterou jste vytvořili v kroku 1 – Zaregistrujte aplikaci Microsoft Entra.
4. V nabídce Spravovat vyberte Ověřování.

5. V konfiguraci platformy nakonfigurujte webovou platformu následujícím způsobem:

   1. V Přesměrovací URI přidejte https://localhost:3000 a vyberte Konfigurovat.

      Poznámka:

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

   2. V implicitních oprávněních a hybridních tocích zapněte obě možnosti:

      • Přístupové tokeny
      • ID tokeny

6. Uložte provedené změny.

Konfigurace ukázkové integrované aplikace

1. Otevřete složku Embed pro vaši organizaci>UserOwnsData>src.

2. V textovém editoru otevřete soubor Config.ts a vyplňte následující hodnoty parametrů:

   • clientId – Použijte GUID klienta.

   • workspaceId – Použijte ID pracovního prostoru.

   • reportId – Použijte ID sestavy.

3. Uložte soubor.

Spuštění ukázkové aplikace

1. Otevřete terminál a přejděte na Vložit pro vaši organizaci>UserOwnsData.

2. Nainstalujte požadované závislosti zadáním následujícího příkazu:

   npm install

3. Spusťte aplikaci zadáním následujícího příkazu:

   npm run start

   Poznámka:

   Během prvního přihlášení se zobrazí výzva, abyste aplikaci povolili oprávnění Microsoft Entra.

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.

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

Uživatelé potřebují oprávnění pro přístup ke složce Power BI, ve které se nachází zpráva. Když uživateli udělíte oprávnění pro přístup ke složce, změna se obvykle projeví až po přihlášení uživatele k portálu Power BI. Aby se nová oprávnění projevila okamžitě, ve scénáři embedded proveďte explicitní volání rozhraní REST API pro aktualizace uživatelských oprávnění při spuštění. Toto volání rozhraní API aktualizuje oprávnění a zabrání selhání autorizace pro uživatele s nově udělenými oprávněními.

Související obsah

• Kurz: Vložení obsahu Power BI pomocí ukázkového vložení pro aplikaci vašich zákazníků
• Vložení stránkovaných sestav
• Máte další otázky? Zkuste se zeptat komunity Power BI.