Vložení sestavy na zabezpečený portál nebo web

Pomocí možnosti Vložit pro Power BI sestav můžete snadno a bezpečně vkládat sestavy na interní webové portály. Může se jednat o cloudové nebo místně hostované portály, jako je SharePoint 2019. Vložené sestavy respektují všechna oprávnění k položkám a zabezpečení dat prostřednictvím zabezpečení na úrovni řádků (RLS). Zajišťují vkládání bez kódu na libovolný portál, který přijme adresu URL nebo prvek iFrame.

Možnost Vložit podporuje filtry adresy URL a nastavení adresy URL. Zároveň umožňuje integraci s portály s minimálním použitím kódu a vyžaduje jen základní znalosti HTML a JavaScriptu.

Jak vkládat sestavy Power BI na portály

  1. Ve službě Power BI otevřete sestavu.

  2. V nabídce File (Soubor) vyberte Embed reportWebsite or portal (Vložit web sestavy nebo portál).

    Website or portal option

  3. V dialogovém okně Bezpečnostní kód pro vložení vyberte Tento odkaz můžete vložit pomocí tohoto odkazu nebo Kód HTML, který jde vložit do blogu nebo na web v iFrame.

    Embed option dialog box

  4. Přístup k sestavě vyžaduje ověření bez ohledu na to, jestli uživatel otevře přímo adresu URL sestavy nebo sestavu vloženou na webovém portálu. Následující obrazovka se zobrazí v případě, že se uživatel během své relace v prohlížeči nepřihlásil do Power BI. Když vybere možnost pro přihlášení, může se otevřít nové okno nebo karta prohlížeče. Pokud se výzva k přihlášení nezobrazí, doporučte kontrolu nastavení blokování automaticky otevíraných oken.

    Sign in to view this report

  5. Když se uživatel přihlásí, sestava se otevře, zobrazí data a umožní přecházení mezi stránkami a nastavení filtrů. Sestavu můžou v Power BI zobrazit jen uživatelé s oprávněním k zobrazení. Zároveň se uplatňují všechna pravidla zabezpečení na úrovni řádků (RLS). Uživatel musí být také správně licencovaný – buď potřebuje licenci Power BI Pro nebo Premium na uživatele (PPU), nebo musí být sestava v pracovním prostoru, který je v Power BI Premium kapacitě. Uživatel se musí přihlásit pokaždé, když otevře nové okno prohlížeče. Jakmile se ale přihlásí, automaticky se načtou i jiné sestavy.

    Embed report

  6. Pokud používáte prvek iFrame, budete pravděpodobně muset upravit výšku a šířku, aby se vešel na webovou stránku portálu.

    Set height and width

Udělení přístupu k sestavě

Možnost Vložit nedovolí automaticky uživatelům sestavu zobrazit. Oprávnění k zobrazení se nastavují přes službu Power BI.

Prostřednictvím služby Power BI můžete sdílet vložené sestavy s uživateli, kteří k nim chtějí získat přístup. Pokud používáte skupinu Microsoftu 365, můžete uživatele zapsat mezi členy pracovního prostoru. Další informace získáte v postupu, který se týká správy pracovního prostoru v Power BI a Microsoftu 365.

Licensing

K zobrazení vložené sestavy uživatelé potřebují licenci Power BI Pro nebo Premium na uživatele (PPU) nebo obsah musí být v pracovním prostoru, který je v kapacitě Power BI Premium (SKU EMnebo P).

Přizpůsobení prostředí vložení pomocí nastavení URL

Uživatelské prostředí můžete přizpůsobit přes nastavení vstupu adresy URL pro vložení. V poskytnutém iFrame můžete aktualizovat nastavení src adresy URL.

Vlastnost Popis
pageName Pomocí řetězcového parametru pageName dotazu můžete nastavit, která stránka sestavy se má otevřít. Uvedenou hodnotu najdete na konci adresy URL sestavy při zobrazení sestavy ve službě Power BI, jak je znázorněno níže.
URL filtry Pomocí URL filtrů v adrese URL pro vložení, kterou jste získali z uživatelského rozhraní Power BI, můžete filtrovat vložený obsah. Tímto způsobem můžete vytvářet integrace s minimálním použitím kódu – jenom se základní znalostí HTML a JavaScriptu.

Nastavení stránky, která se pro vloženou sestavu otevře

Hodnotu pageName najdete na konci adresy URL sestavy při zobrazení sestavy v Power BI službě.

  1. Otevřete sestavu ze služby Power BI ve webovém prohlížeči a zkopírujte adresu URL z adresního řádku.

    Report section

  2. K adrese URL připojte nastavení pageName.

    Append pageName

Filtrování obsahu sestavy pomocí URL filtrů

Pomocí URL filtrů můžete nabídnout různá zobrazení sestavy. Například níže navržený URL filtr filtruje sestavu tak, aby zobrazovala data pro energetický průmysl.

Použití kombinace parametru pageName a URL filtrů může být velmi účinné. Uživatelské prostředí můžete vytvářet pomocí základního kódu HTML a JavaScriptu.

Tady je například tlačítko, které můžete přidat na stránku HTML:

<button class="textLarge" onclick='show("ReportSection", "Energy");' style="display: inline-block;">Show Energy</button>

Tlačítko při výběru zavolá funkci, která aktualizuje prvek iFrame upravenou adresou URL s filtrem pro odvětví Energy.

function show(pageName, filterValue)

{

var newUrl = baseUrl + "&pageName=" + pageName;

if(null != filterValue && "" != filterValue)

{

newUrl += "&$filter=Industries/Industry eq '" + filterValue + "'";

}

//Assumes there's an iFrame on the page with id="iFrame"

var report = document.getElementById("iFrame")

report.src = newUrl;

}

Filter

Můžete přidat libovolný počet tlačítek a vytvořit tak vlastní prostředí s minimálním použitím kódu.

Důležité informace a omezení

  • Stránkované sestavy jsou podporovány u scénářů zabezpečeného vložení a stránkované sestavy s parametry v adrese URL jsou také podporovány. Přečtěte si další informace o předávání parametrů stránkované sestavě v adrese URL.

  • Bezpečné vložení funguje pro sestavy publikované ve službě Power BI.

  • Aby se sestava uživateli zobrazila, musí se přihlásit pokaždé, když otevře nové okno prohlížeče.

  • Některé prohlížeče vyžadují aktualizaci stránky po přihlášení, zejména při použití režimu InPrivate nebo Incognito.

  • Pokud používáte nepodporované verze prohlížeče, můžete narazit na problémy. Power BI podporuje následující seznam prohlížečů.

  • Klasický SharePoint Server se nepodporuje, protože vyžaduje verze Internet Exploreru starší než 11 nebo ty, které umožňují režim kompatibilního zobrazení.

  • Pokud chcete docílit prostředí jednotného přihlašování, použijte možnost Vložit v rámci SharePointu Online nebo vytvořte vlastní integraci pomocí metody vkládání uživatel vlastní data.

  • U javascriptového rozhraní API Power BI nefunguje automatické ověřování, které poskytuje možnost Vložit. U javascriptového rozhraní API Power BI použijte při vkládání metodu uživatel vlastní data.

  • Doba životnosti ověřovacího tokenu se řídí na základě nastavení AAD. Po vypršení jeho platnosti bude uživatel muset aktualizovat svůj prohlížeč, aby získal aktualizovaný ověřovací token. Výchozí doba životnosti je jedna hodina, ale ve vaší organizaci může být nastavená kratší i delší doba. V tomto scénáři není možné token automaticky aktualizovat.

Další kroky