Power BI csempe-vezérlőelem a Power Apps rendszerben

Ez a vezérlőelem megjelenít egy Power BI csempét az alkalmazáson belül.

Nem rendelkezik Power BI alkalmazással? Regisztráció.

Ismertetés

Kihasználhatja a meglévő adatelemzéseit és jelentéskészítését a Power BI-csempék megjelenítésével az alkalmazásain belül. Adja meg a megjeleníteni kívánt csempét a Munkaterület, Irányítópult és Csempe tulajdonságok megadásával a beállításpanel Adatok lapján.

Megjegyzés

  • Power BI A csempevezérlés nem érhető el DoD-környezetekben GCC High .
  • Power BI a csempevezérlő nem érhető el Kínában.
  • Power BI csempe beágyazása esetén érvényes licencelési követelményekkel kapcsolatosan lásd: Licencelés.

Megosztás és biztonság

Ha Power BI-tartalommal rendelkező alkalmazást oszt meg, akkor nem csak az alkalmazást kell megosztania, hanem az irányítópult lehetőséget is, amelyről a csempe származik. Ellenkező esetben a Power BI-tartalom az alkalmazást megnyitó felhasználók számára sem lesz látható. A Power BI-tartalommal rendelkező alkalmazásoknak tiszteletben kell tartaniuk az erre a tartalomra vonatkozó engedélyeket.

Teljesítmény

Nem ajánlott egy alkalmazáson belül egyszerre háromnál több Power BI-csempét betölteni. A csempék betöltését és eltávolítását a LoadPowerBIContent tulajdonság beállításával szabályozhatja.

Beágyazás beállításai

A beágyazás az Power BI API különböző verziói között eltérő. Az új Power BI API hitelesítési rendszer miatt előfordulhat, hogy a csempe nem érhető el mobilon vagy más beágyazott helyzetekben (Teams vagy SharePoint).

Az API-verzió használatát az AllowNewAPI tulajdonság segítségével szabályozhatja. További információért lásd: Kulcstulajdonságok.

AllowNewAPI tulajdonságérték Viselkedésmód
Igaz Irányítópultot, jelentést vagy csempét úgy ágyazhat be, ha fogja az URL-cím beágyazása elemet a Power BI-ból és TileUrl értékké teszi.
Hamis Irányítópultcsempét úgy ágyazhat be, ha fogja az URL-cím beágyazása elemet a TileUrl értékké teszi, vagy a megadott grafikus felhasználói felületet használja.

Megjegyzés

A Power BI URL-címek beágyazása (például IFrame-keretben) nem támogatott a Power Apps mobil alkalmazáson, mivel az Power BI URL-kérés hitelesítését a mobil játékos nem kezeli.

Szűrés

A szűrés a Power BI-API-k verziói között különbözik. Tekintse meg a lenti megfelelő szakaszokat a vezérlő konfigurálásától függően.

Amikor az új API-t használja a Power BI-szolgáltatás meghívásához

Ha az AllowNewAPI tulajdonság beállítása "Igaz", akkor az új API-t használja a Power BI-szolgáltatáshoz meghívásához. További információ: Jelentés szűrése lekérdezésikarakterlánc-paraméter használatával az URL-ben.

Amikor az eredeti API-t használja a Power BI-szolgáltatás meghívásához

Ha az AllowNewAPI tulajdonság beállítása "Hamis", akkor az eredeti API-t használja a Power BI-szolgáltatáshoz meghívásához. Ebben az esetben ha egyetlen paramétert ad át az alkalmazásból, szűrheti a Power BI-csempén megjelenő eredményeket. Azonban csak a sztringértékek és az egyenlőségoperátor támogatottak, és előfordulhat, hogy a szűrő nem működik, ha a tábla vagy az oszlop neve szóközöket tartalmaz.

Ha egyetlen szűrőt szeretne átadni, módosítsa a TileURL tulajdonság értékét, amely a következő szintaxist követi:

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

Ehhez az értékhez fűzze hozzá a következő szintaxist:

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

Például egy listamezőből származó értéket használ:

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

A paraméter egy értéket szűr ki annak a jelentésnek az adatkészletében, ahonnan a csempe származik. A szűrési funkció azonban a következő korlátozásokkal jár:

  • Csak egy szűrőt lehet alkalmazni.
  • Csak az eq operátor támogatott.
  • A mező típusának sztringnek kell lennie.
  • A szűrés csak rögzített vizualizációs mozaikok esetén érhető el. Rögzített jelentések esetén nem támogatott.
  • Az R és a Python parancsfájlok megjelenítése nem szűrhető.

A Power BI-jelentés számított mezőivel más típusú értékeket is sztringgé alakíthat, illetve több mezőt is egyesíthet.

Kulcs tulajdonságai

AllowNewAPI – Az új API-t használja-e a Power BI-szolgáltatás hívásakor. Ha az értéket Igaz értékre állítja, akkor használható az új Power BI API (amelyet a mobilok és bizonyos beágyazott forgatókönyvek nem támogatnak, de néhány fejlettebb szintű szűrést is lehetővé tesz). A Hamis esetén az eredeti API-t fogja használni. Az alapértelmezett érték hamis.

Irányítópult – Az a Power BI-irányítópult, ahonnan a csempe származik.

LoadPowerBIContent – Ha Igaz értékre van beállítva, akkor a Power BI-tartalom be lesz töltve és látható lesz. Ha értéke Hamis, a Power BI-tartalom el lesz távolítva a memóriából, a memória felszabadításával javítva a teljesítményt.

PowerBIInteractions - Ha Igaz értékre van állítva, a Power BI tartalommal lehet interakcióba lépni, de a Power Apps OnSelect esemény nem fog kiváltódni. Ha Hamis értékre van állítva, a csempével nem lehet interakcióba lépni, de a Power Apps OnSelect eseményt a csempe kijelölésekor elindítja.

Csempe – A megjeleníteni kívánt Power BI-csempe neve.

Workspace – Az a Power BI-munkaterület, ahonnan a csempe származik.

További tulajdonságok

BorderColor – Egy vezérlőelem szegélyének színe.

BorderStyle – Azt határozza meg, hogy egy vezérlőelem szegélye Folytonos, Szaggatott, Pontozott, vagy Nincs értékű.

BorderThickness – Egy vezérlőelem szegélyének vastagsága.

DisplayMode – Azt határozza meg, hogy a vezérlőelem ad-e lehetőséget a felhasználónak bementet megadására (Szerkesztés) vagy csak megjeleníti az adatokat (Megtekintés), vagy egyik sem, és ki van kapcsolva (Kikapcsolva).

Magasság – Egy vezérlőelem felső és alsó széle közötti távolság.

OnSelect – Elvégzendő műveletek, amikor a felhasználó kiválaszt egy vezérlőt. Alapértelmezés szerint a csempéhez társított Power BI-jelentés nyílik meg.

TileUrl – Az az URL-cím, amellyel lekérhető a csempe a Power BI szolgáltatásból. Ha az URL-cím szűréséhez lekérdezési karakterláncot szeretne, lásd a fenti szűrés szakaszt.

Látható – Azt határozza meg, hogy egy vezérlőelem látható vagy rejtett legyen.

Szélesség – Egy vezérlőelem bal és jobb széle közötti távolság.

X- A vezérlőelem bal széle és a szülőkonténer bal széle közötti távolság (képernyő—, ha nincs szülőkonténer).

Y- A vezérlőelem felső széle és a szülőkonténer felső széle közötti távolság (képernyő—, ha nincs szülőkonténer).

Példa

  1. Nyissa meg a Diagramok menüt a Beszúrás lapon, majd adjon hozzá egy Power BI-csempe vezérlőt.

    Nem tudja, hogyan adhat hozzá és konfigurálhat vezérlőelemeket?

  2. A beállításpanel Adatok lapján válassza a Saját munkaterület lehetőségre a Munkaterület beállításban.

  3. Válasszon egy irányítópultot az irányítópultok listájáról, majd egy csempét a csempék listájáról.

    A vezérlőelem rendereli a Power BI-csempét.

Akadálymentességi irányelvek

A Power BI-csempe egyszerűen egy tároló Power BI tartalmakhoz. Olvassa el a Power BI akadálymentességi tippek részt, ha szeretné megtudni, hogy hogyan készíthet akadálymentes tartalmat.

Ha a Power BI-tartalomnak nincs címe, akkor a képernyőolvasók támogatásához ajánlott fejlécet megadni egy Label vezérlőelem használatával. A címke elhelyezhető közvetlenül a Power BI-csempe előtt.

Megjegyzés

Megosztja velünk a dokumentációja nyelvi preferenciáit? Rövid felmérés elvégzése. (ne feledje, hogy ez a felmérés angol nyelvű)

A felmérés elvégzése körülbelül hét percet vesz igénybe. Semmilyen személyes adatot nem gyűjtünk (adatvédelmi nyilatkozat).