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í 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š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 vložení ukázkové aplikace vaší organizace v jedné z následujících architektur:

• .NET Framework
• .NET Core
• React TypeScript

Poznámka:

Ukázky .NET Core a rozhraní .NET Framework umožňují 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 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

  • Vlastního tenanta Microsoft Entra.

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

      • Power BI Pro

      • Premium na uživatele (PPU)

    Poznámka:

    K přechodu 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šší SKU 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ření a publikování sestavy 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.

Tip

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 pracovní prostor a vyberte Uložit.

Krok 3 : Vytvoření a publikování sestavy Power BI

Dalším krokem je vytvoření sestavy a nahrání sestavy do pracovního prostoru. Vlastní sestavu můžete vytvořit pomocí Power BI Desktopu a pak ji publikovat do svého pracovního prostoru. Nebo můžete nahrát ukázkovou sestavu do pracovního prostoru.

Tip

Pokud už máte pracovní prostor se sestavou, můžete tento krok přeskočit.

Pokud chcete stáhnout ukázkovou sestavu a publikovat ji do pracovního prostoru, postupujte takto:

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

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 sestavy

Client ID

Tip

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

Tip

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

Tajný klíč 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 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: .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 sestavu, kterou chcete vložit.

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

   

ID sestavy

Tip

Platí pro: .NET Core .NET Framework ReactTypeScript

Pokud chcete získat identifikátor GUID ID 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 .

Pokud chcete vložit sestavu Power BI, postupujte podle těchto kroků a upravte vložení ukázkové aplikace vaší organizace .

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 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. V konfiguraci 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 zvolte Web.

6. Uložte provedené změny.

Konfigurace ukázkové vložené 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 spuštění > ladění.

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

   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 webové platformě přidejte https://localhost:44300/v části Identifikátory URI přesměrování .

      Poznámka:

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

   2. V případě implicitního udělení a hybridních toků povolte možnost tokenů ID.

6. Uložte provedené změny.

Konfigurace ukázkové vložené aplikace

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

2. V sadě Visual Studio otevřete soubor UserOwnsData.sln .

3. Otevřete Web.config 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 služby IIS Express (přehrát).

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

   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 identifikátorech URI pro přesměrování 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 a hybridních tocích povolte obě možnosti:

      • Přístupové tokeny
      • Tokeny ID

6. Uložte provedené změny.

Konfigurace ukázkové vložené 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 identifikátor GUID ID 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í vložení pro ukázkovou aplikaci pro zákazníky 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é je sestava. 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 oprávnění refreshuser 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

Zeptejte se Komunita Power BI