Ovládací prvek Dlaždice Power BI v Power Apps

Ovládací prvek, který zobrazuje dlaždici Power BI uvnitř aplikace.

Nemáte Power BI? Registrovat.

Popis

Využijte výhod existující analýzy dat a vytváření sestav a zobrazte své dlaždice Power BI uvnitř aplikací. Požadovanou dlaždici zvolíte nastavením vlastností Workspace, Dashboard a Tile na kartě Data na panelu možností.

Sdílení a zabezpečení

Když sdílíte aplikaci, která má obsah Power BI, nestačí sdílet jen aplikaci samotnou, ale je třeba sdílet také řídicí panel, z něhož dlaždice pochází. V opačném případě se obsah Power BI nezobrazí ani uživatelům, kteří aplikaci otevřou. Aplikace, které obsahují obsah Power BI, respektují oprávnění pro daný obsah.

Výkon

Nedoporučujeme mít v aplikaci načtené více než tři dlaždice Power BI současně. Načítání dlaždic a jejich uvolňování můžete řídit tak, že nastavíte vlastnost LoadPowerBIContent.

Možnosti vkládání

Vkládání se v různých verzích Power BI API liší. Kvůli novému schématu autentizace API Power BI vaše dlaždice nemusí být přístupná na mobilním zařízení nebo v rámci jiných vložených scénářů (Teams nebo SharePoint).

Používání verze API můžete řídit pomocí vlastnosti AllowNewAPI. Další informace najdete v tématu Klíčové vlastnosti.

Filtrování

Filtrování se v různých verzích Power BI API liší. Podívejte se na příslušné části níže v závislosti na tom, jak konfigurujete ovládací prvek.

Při použití nového rozhraní API k volání služby Power BI

Když je vlastnost AllowNewAPI nastavena na „True“, používáte k volání nové rozhraní API služby Power BI. Další informace najdete v tématu Filtrování sestavy pomocí parametrů řetězce dotazu v adrese URL.

Při použití původního rozhraní API k volání služby Power BI

Když je vlastnost AllowNewAPI nastavena na „False“, používáte k volání původní rozhraní API služby Power BI. V takovém případě můžete předáním jediného parametru z aplikace filtrovat výsledky, které se zobrazují v dlaždici Power BI. Jsou však podporovány pouze hodnoty řetězců a operátoru rovná se a filtr nemusí fungovat, pokud název tabulky nebo název sloupce obsahuje mezery.

Chcete-li předat jednu hodnotu filtru, upravte hodnotu vlastnosti TileURL, která má tuto syntaxi:

"https://app.powerbi.com/embed?dashboardId=<DashboardID>&tileId=<TileID>&config=<SomeHash>"

K této hodnotě připojte tuto syntaxi:

&$filter=<TableName>/<ColumnName> eq '<Value>'

Například pomocí hodnoty ze seznamu:

"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"

Parametr bude filtrovat hodnotu v datovém souboru sestavy, odkud dlaždice pochází. Funkce filtrování má však následující omezení:

• Lze použít pouze jeden filtr.
• Je podporován jenom operátor eq.
• Typ pole musí být řetězec.
• Filtrování je k dispozici pouze u připnutých dlaždic vizualizací. U připnutých zpráv to není podporováno.
• Vizuály skriptů R a Python nelze filtrovat.

V sestavě Power BI můžete použít vypočtená pole pro převod ostatních typů hodnot na řetězec nebo zkombinování více polí do jednoho.

Vlastnosti klíče

AllowNewAPI – Zda použít nové rozhraní API při volání služby Power BI. Nastavení hodnoty na True umožní použití nového rozhraní Power BI API (které není podporováno v mobilních a některých vestavěných scénářích, ale umožňuje o něco více pokročilejšího filtrování). False použije původní rozhraní API. Výchozí hodnotou je false.

Dashboard – Řídicí panel Power BI, z něhož dlaždice pochází.

LoadPowerBIContent – pokud je nastavená na hodnotu true, obsah Power BI se načte a zobrazí. Pokud je nastavená na hodnotu false, obsah Power BI se uvolní, čímž dojde k uvolnění paměti a optimalizaci výkonu.

PowerBIInteractions – Když je nastaveno na True, s obsahem Power BI lze interagovat, ale událost Power Apps OnSelect se nespustí. Při nastavení na False, s dlaždicí nelze interagovat, ale událost Power Apps OnSelect se spustí, když je vybrána dlaždice.

Tile – název zobrazované dlaždice Power BI.

Workspace – Pracovní prostor Power BI, z něhož dlaždice pochází.

Další vlastnosti

BorderColor – barva ohraničení ovládacího prvku.

BorderStyle – styl ohraničení ovládacího prvku Solid (Plné), Dashed (Čárkované), Dotted (Tečkované) nebo None (Žádné).

BorderThickness – tloušťka ohraničení ovládacího prvku.

DisplayMode – ovládací prvek umožňuje zadávání uživatelem (Edit, Úpravy), pouze zobrazuje data (View, Prohlížení) nebo je zakázaný (Disabled, Zakázáno).

Height – vzdálenost mezi horním a dolním okrajem ovládacího prvku.

OnSelect – Akce k provedení, když uživatel vybere ovládací prvek. Ve výchozím nastavení se otevře sestava Power BI, která je s dlaždicí spojená.

TileUrl – adresa URL, pomocí které se dlaždice požaduje ze služby Power BI. Chcete-li do své adresy URL přidat filtrování řetězce dotazu, přečtěte si výše uvedenou část o filtrování.

Visible – možnost zobrazení nebo skrytí ovládacího prvku.

Width – vzdálenost mezi levým a pravým okrajem ovládacího prvku.

X – vzdálenost mezi levým okrajem ovládacího prvku a levým okrajem jeho nadřazeného kontejneru (nebo obrazovky, pokud se nadřazený kontejner nepoužívá)

Y – vzdálenost mezi horním okrajem ovládacího prvku a horním okrajem jeho nadřazeného kontejneru (nebo obrazovky, pokud se nadřazený kontejner nepoužívá).

Příklad

1. Na kartě Vložení otevřete nabídku Grafy a potom přidejte ovládací prvek Dlaždice Power BI.

   Podívejte se, jak přidat a nakonfigurovat ovládací prvek.

2. Na kartě Data na panelu možností vyberte u nastavení Pracovní prostor možnost Můj pracovní prostor.

3. V seznamu řídicích panelů vyberte řídicí panel a pak v seznamu dlaždic vyberte dlaždici.

   Ovládací prvek vykreslí dlaždice Power BI.

Pokyny pro přístupnost

Dlaždice Power BI je jednoduše kontejner pro obsah Power BI. Naučte se vytvářet přístupný obsah pomocí těchto tipů pro přístupnost v Power BI.

Pokud obsah Power BI nemá dlaždici, zvažte přidání záhlaví pomocí ovládacího prvku Popisek, který zajistí podporu čteček obrazovky. Popisek může být umístěný bezprostředně před dlaždicí Power BI.