Ovládací prvok Dlaždica Power BI v Power Apps
Ovládací prvok zobrazujúci dlaždicu Power BI v aplikácii.
Nemáte Power BI? Zaregistrujte sa.
Popis
Využite existujúce analýzy údajov a zostavy tak, že budete vo svojich aplikáciách zobrazovať dlaždice Power BI. Určite dlaždicu, ktorú chcete zobraziť, nastavením jej vlastností Workspace, Dashboard a Tile na karte Údaje panela s možnosťami.
Poznámka
- Power BI ovládanie dlaždíc nie je dostupné v prostrediach GCC High a DoD .
- Ovládaci prvok dlaždice Power BI nie je v Číne dostupný.
- Pre licenčné požiadavky pri vkladaní dlaždice Power BI si prečítajte Licencovanie.
Zdieľanie a zabezpečenie
Pri zdieľaní aplikácie, ktorá obsahuje obsah Power BI, je potrebné zdieľať nielen samotnú aplikáciu, ale aj tabuľu, z ktorej dlaždica pochádza. V opačnom prípade sa obsah Power BI nezobrazí ani pre používateľov, ktorí otvoria aplikáciu. Aplikácie, ktoré obsahujú obsah Power BI, dodržiavajú povolenia pre daný obsah.
Výkon
Neodporúča sa mať v aplikácii načítané viac ako tri dlaždice Power BI súčasne. Načítanie a uvoľňovanie dlaždíc z pamäte môžete ovládať pomocou vlastnosti LoadPowerBIContent.
Možnosti vkladania
Vkladanie sa líši medzi verziami Power BI API. Z dôvodu novej schémy API overovania Power BI nemusí byť vaša dlaždica dostupná pre mobilné zariadenia alebo v rámci iných vložených scenárov (Teams alebo SharePoint).
Používanie verzie API môžete ovládať pomocou vlastnosti AllowNewAPI. Ďalšie informácie nájdete v časti Kľúčové vlastnosti.
Hodnota vlastnosti AllowNewAPI | Správanie |
---|---|
Pravdivé | Tabuľu, zostavu alebo dlaždicu môžete vložiť prevzatím Vloženej URL adresy z Power BI a je premenou na hodnotu TileUrl. |
Nepravdivé | Dlaždicu tabule môžete vložiť buď pomocou Vloženej URL adresy a je premenou na hodnotu TileUrl alebo použitím poskytnutého grafického prostredia. |
Poznámka
Vkladanie adresy URL Power BI (napríklad v prvku IFrame) nie je podporovaná v Power Apps mobile, pretože overenie adresy URL požiadavky Power BI na adresu URL mobilný prehrávač nespracuje.
Filtrovanie
Filtrovanie sa líši medzi verziami Power BI API. V závislosti od konfigurácie ovládacieho prvku si pozrite nižšie uvedené príslušné sekcie.
Pri použití nového API na volanie služby Power BI
Keď je vlastnosť AllowNewAPI nastavená na „Pravda“, na volanie služby Power BI používate nové API. Ďalšie informácie sú uvedené v časti Filtrovanie zostavy pomocou parametrov reťazca dotazu v adrese URL.
Pri použití originálneho API na volanie služby Power BI
Keď je vlastnosť AllowNewAPI nastavená na „Nepravda“, na volanie služby Power BI používate originálne API. V takom prípade môžete odovzdaním jedného parametra z aplikácie filtrovať výsledky, ktoré sa zobrazujú na dlaždici Power BI. Podporované sú však iba hodnoty reťazca a operátor rovnosti a filter nemusí fungovať, ak názov tabuľky alebo názov stĺpca obsahuje medzery.
Ak chcete odovzdať jednu hodnotu filtra, upravte hodnotu vlastnosti TileURL s nasledujúcou syntaxou:
"https://app.powerbi.com/embed?dashboardId=<DashboardID>&tileId=<TileID>&config=<SomeHash>"
K tejto hodnote pripojte túto syntax:
&$filter=<TableName>/<ColumnName> eq '<Value>'
Napríklad pomocou hodnoty z poľa so zoznamom:
"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"
Parameter bude filtrovať hodnotu v množine údajov zostavy, z ktorej dlaždica pochádza. Funkcia filtrovania má však nasledujúce obmedzenia:
- Môže sa použiť iba jeden filter.
- Podporovaný je len operátor
eq
. - Typ poľa musí byť reťazec.
- Filtrovanie je k dispozícii iba pre pripnuté dlaždice vizualizácie. Pre pripnuté správy to nie je podporované.
- Vizuály skriptov R a Python nie je možné filtrovať.
Vypočítané polia môžete použiť v zostave Power BI na konverziu iných typov hodnôt na reťazec alebo kombináciu viacerých polí do jedného.
Vlastnosti kľúča
AllowNewAPI – Či sa má pri volaní služby Power BI použiť nové API. Nastavenie hodnoty na Pravda umožní používanie nového Power BI API (ktoré nie je podporované v mobilných a niektorých vložených scenároch, ale umožňuje pokročilejšie filtrovanie). Nepravda bude používať pôvodné API. Predvolená hodnota je nepravda.
Dashboard – tabuľa služby Power BI, z ktorej dlaždica pochádza.
LoadPowerBIContent – keď je nastavená hodnota Pravda, obsah Power BI sa načíta a zobrazí. Keď je nastavená hodnota Nepravda, obsah Power BI sa uvoľní z pamäte, čím sa uvoľní pamäť a optimalizuje výkon.
PowerBIInteractions – Keď je nastavené na True, s obsahom Power BI s obsahom je možné interagovať, ale udalosť Power Apps OnSelect sa nespustí. Keď je nastavené na False, s dlaždicou nemožno interagovať, ale udalosť Power Apps OnSelect sa spustí, keď je vybraná dlaždica.
Tile – názov dlaždice Power BI, ktorú chcete zobraziť.
Workspace – pracovný priestor služby Power BI, z ktorého dlaždica pochádza.
Ďalšie vlastnosti
BorderColor – farba orámovania ovládacieho prvku.
BorderStyle – štýl orámovania ovládacieho prvku Solid (Plné), Dashed (Prerušované), Dotted (Bodkované) alebo None (Žiadne).
BorderThickness – hrúbka orámovania ovládacieho prvku.
DisplayMode – údaj o tom, či ovládací prvok umožňuje vstup používateľa (Edit), iba zobrazuje údaje (View) alebo je zakázaný (Disabled).
Height – vzdialenosť medzi horným a dolným okrajom ovládacieho prvku.
OnSelect – Akcie, ktoré sa majú vykonať, keď používateľ vyberie ovládací prvok. Predvolene sa otvorí zostava Power BI, ktorá je priradená k dlaždici.
TileUrl – URL adresa, podľa ktorej sa požaduje dlaždica zo služby Power BI. Ak chcete do svojej adresy URL pridať filtrovanie reťazcov dotazov, pozrite si sekciu filtrovanie vyššie.
Visible – možnosť zobrazenia alebo skrytia ovládacieho prvku.
Width – vzdialenosť medzi ľavým a pravým okrajom ovládacieho prvku.
X – vzdialenosť medzi ľavým okrajom ovládacieho prvku a ľavým okrajom jeho nadradeného kontajnera (alebo obrazovky — ak sa nadradený kontajner nepoužíva).
Y – vzdialenosť medzi horným okrajom ovládacieho prvku a horným okrajom jeho nadriadeného kontajnera (alebo obrazovky — ak sa nadradený kontajner nepoužíva).
Príklad
Na karte Vložiť otvorte ponuku Ovládacie prvky a potom pridajte ovládací prvok Dlaždica Power BI.
Neviete, ako pridať a nakonfigurovať ovládací prvok?
Na karte Údaje na paneli s možnosťami vyberte položku Môj pracovný priestor a vyberte nastavenie Pracovný priestor.
V zozname tabúľ vyberte tabuľu a potom vyberte dlaždicu zo zoznamu dlaždíc.
Ovládací prvok vykreslí dlaždicu Power BI.
Pokyny na zjednodušenie ovládania
Dlaždica Power BI je jednoducho kontajner pre obsah Power BI. Naučte sa vytvárať prístupný obsah pomocou týchto tipov pre prístupnosť v službe Power BI.
Ak obsah Power BI nemá názov, zvážte pridanie nadpisu pomocou ovládacieho prvku Label, aby sa umožnila podpora čítačky obrazovky. Označenie sa môže nachádzať bezprostredne pred dlaždicou Power BI.
Poznámka
Môžete nás informovať o svojich voľbách jazyka pre dokumentáciu? Absolvujte krátky prieskum. (upozorňujeme, že tento prieskum je v angličtine)
Prieskum bude trvať približne sedem minút. Nezhromažďujú sa žiadne osobné údaje (vyhlásenie o používaní osobných údajov).