Nejprve musíte vědět, že existují dva režimy pro vkládání Power BI – user owns data
a app owns data
. V prvním režimu se uživatel při vkládání ověří pomocí svého vlastního účtu Power BI Pro, tj. každý z vašich uživatelů potřebuje licenci Power BI Pro. U toho pozdějšího potřebujete pouze jeden „master account“, který bude použit pro autentizaci. Rozdíly v implementaci nejsou obrovské, proto popíšu app owns data
.
Musíte provést následující:
-
Zaregistrujte si aplikaci – přejděte na dev.powerbi.com/apps a zaregistrovat nativní aplikaci. Vyberte, která oprávnění chcete udělit (pokud si nejste jisti, při prvních testech je jednoduše udělte všechna). Zkopírujte guid – toto je ID aplikace, neboli ID klienta.
-
Dalším krokem je ověření z vaší aplikace a získání přístupového tokenu. Použijte Azure Active Directory Authentication Library ( ADAL) pro to - zavolejte některé z
acquireToken
metodyAuthenticationContext
třída. -
Tento přístupový token použijte k volání rozhraní Power BI REST API a získání
embedUrl
prvku, který chcete vložit, např. zpráva . -
Použijte Power BI JavaScript klienta skutečně vložit tento prvek. Musíte inicializovat jednu třídu konfigurace vložení a předat informace o typu prvku (sestava, řídicí panel, dlaždice), kde jej najít (embedUrl), ověření (přístupový token), některé další možnosti konfigurace (zobrazení nebo skrytí panelu filtrů, navigace atd.), filtry, které se mají použít a již brzy. V případě, že budete používat přístupový token získaný výše, nastavte
tokenType
býtAAD
. Tento token má mnoho privilegií, takže z bezpečnostních důvodů můžete chtít použítEmbed
místo toho token. V tomto případě použijte přístupový token k opětovnému volání REST API (např. Vygenerování přehledůTokenInGroup ). -
Zavolejte na
powerbi.embed
metoda klienta JavaScript předá vloženou konfiguraci k vizualizaci tohoto prvku Power BI ve vaší aplikaci.
Zde je několik zdrojů, které byste si měli přečíst:
- Výukový program:Embed Power BI obsahu do aplikace pro vaše zákazníky
- Výukový program:Vložení obsahu Power BI do aplikace pro vaši organizaci
- Základy vkládání
- Power BI Embedded Playground
- Ukázky pro vývojáře PowerBI