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


Metoda

Pokud chcete vytvořit ukázkovou aplikaci pro vložení pro vaši organizaci, 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 v Azure AD vám umožní vytvořit identitu pro vaši aplikaci.

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

Krok 2 : Vytvoření Power BI pracovního prostoru

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í Power BI sestavy

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.

Krok 4 – získání hodnot parametrů vkládání

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ů jsou pro jednotlivé ukázky potřeba.

Parametr .NET Core .NET Framework React TypeScriptu
ID klienta Applies to. Applies to. Applies to.
Tajný kód klienta Applies to. Applies to. Does not apply to.
ID pracovního prostoru Does not apply to. Does not apply to. Applies to.
ID sestavy Does not apply to. Does not apply to. Applies to.

ID klienta

Tip

Platí pro:Applies to. . NET Core Applies to. .NET Framework Applies to. 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 aplikaci Azure AD, kterou používáte pro vkládání obsahu Power BI obsahu.

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

Tajný klíč klienta

Tip

Platí pro:Applies to. . NET Core Applies to. .NET Framework Does not apply to. 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 aplikaci Azure AD, kterou používáte pro vkládání obsahu Power BI obsahu.

  4. V části Spravovatvyberte 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

Nezapomeňte při prvním spuštění zkopírovat hodnotu tajného klíče klienta. Po přechodu z této stránky bude tajný kód klienta skrytý a nebudete moct načíst jeho hodnotu.

ID pracovního prostoru

Tip

Platí pro:Does not apply to. . NET Core Does not apply to. .NET Framework Applies to. 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/ .

    A screenshot showing workspace ID GUID in the Power B I service U R L

ID sestavy

Tip

Platí pro:Does not apply to. . NET Core Does not apply to. .NET Framework Applies to. 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 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

5\. krok – Vložte obsah

Vložená Power BI aplikace umožňuje vytvořit vložení pro vaši organizaci do Power BI aplikace.

Postupujte podle těchto kroků a upravte ukázkovou aplikaci vložení pro vaši organizaci, abyste vkláda Power BI sestavu.

  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. Otevřete jednu složek podle toho, jaký jazyk aplikace používá:

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

    Poznámka

    Ukázkové aplikace pro vložení pro vaši organizaci podporují pouze výše uvedené architektury. Ukázkové aplikace Java,Node JS a Python podporují pouze řešení 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 – Registrace aplikace služby Azure AD.

  4. V nabídce Správa vyberte ověřování.

  1. V části Konfigurace platforemotevřete webovou platformu a v části identifikátory URI pro přesměrování přidejte .

    Poznámka

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

  2. Uložte provedené změny.

Screenshot showing the Azure AD app authentication configurations including the web redirect U R I for the .NET core app sample.

Konfigurace ukázkové aplikace pro vkládání

  1. Otevřete složku pro vložení do složky vaší organizace .

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

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

    • ClientId-Použít identifikátor GUID ClientId

    • ClientSecret -Použít ClientSecret

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í spustit ladění.

  1. Přihlaste se k ukázkové aplikaci vkládání.

    Poznámka

    Při prvním přihlášení se zobrazí výzva k povolení oprávnění služby Azure AD pro aplikaci.

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

    Screenshot showing the Power BI embedding sample app.

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.

Další kroky

Power BI embedded analytics umožňuje vložit do aplikace Power BI obsah, jako jsou sestavy, řídicí panely a dlaždice.

V tomto kurzu se naučíte:

  • Nastavit prostředí pro vkládání.
  • Konfigurace vložení pro ukázkovou aplikaci vaší organizace (označuje se také jako uživatelsky vlastní data)

Aby bylo možné používat vaši aplikaci, uživatelé se budou muset přihlašovat 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, několik prvních kroků tohoto kurzu se liší. Podrobnosti najdete v tématu věnovaném 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 jednom z následujících platforem:

  • .NET Framework
  • .NET Core
  • React TypeScript

Poznámka

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

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: