Share via


Control Peça del Power BI al Power Apps

Un control que mostra una peça del Power BI dins d'una aplicació.

No teniu el Power BI? Registreu-vos.

Descripció

Aprofiteu l'anàlisi i els informes de dades existents mostrant les vostres peces del Power BI dins de les aplicacions. Especifiqueu la peça que voleu que es mostri establint les propietats Workspace, Dashboard i Tile a la pestanya Dades de la subfinestra d'opcions.

Nota

  • Power BI El control de peces no està disponible en GCC High entorns DoD i DoD .
  • El control de peces de Power BI no està disponible a l'aplicació Vessar.
  • Per conèixer els requisits de llicències en incrustar la peça del Power BI, vegeu Llicències.

Ús compartit i seguretat

Quan compartiu una aplicació que conté contingut del Power BI, heu de compartir no només l'aplicació en si mateix, sinó també l'escriptori digital d'on prové la peça. Altrament, el contingut del Power BI no es mostrarà fins i tot per als usuaris que obrin l'aplicació. Les aplicacions que contenen contingut del Power BI respecten els permisos per a aquest contingut.

Rendiment

No es recomana tenir més de tres peces del Power BI carregades a la vegada dins d'una aplicació. Per controlar la càrrega i la descàrrega de la peça, definiu la propietat LoadPowerBIContent.

Opcions d'incrustació

La incrustació és diferent entre les versions de l'API del Power BI. A causa del nou esquema d'autenticació de l'API del Power BI, és possible que la vostra peça no sigui accessible en mòbils o en altres escenaris d'incrustació (Teams o SharePoint).

Podeu controlar l'ús de la versió de l'API utilitzant la propietat AllowNewAPI. Per obtenir més informació, consulteu Propietats clau.

Valor de la propietat AllowNewAPI Comportament
Cert Podeu incrustar un escriptor digital, un informe o una peça prenent l'URL d'incrustació del Power BI i convertint-la en el valor TileUrl.
Fals Podeu incrustar una peça de l'escriptori digital amb l'URL d'incrustació i fent-la el valor TileUrl, o utilitzant la interfície gràfica proporcionada.

Nota

No es permet la incrustació d'una adreça URL del Power BI (per exemple, en un IFrame) des de l'aplicació mòbil del Power Apps degut a que el reproductor mòbil no controla la sol·licitud d'autenticació d'adreça URL del Power BI.

Filtratge

El filtratge difereix entre les versions de l'API del Power BI. Vegeu les seccions adequades a continuació segons com configureu el control.

En utilitzar la nova API per cridar al servei del Power BI

Quan la propietat AllowNewAPI està establerta a "True", esteu utilitzant una nova API per cridar al servei del Power BI. Per a més informació, vegeu Filtrar un informe mitjançant paràmetres de cadena de consulta a l'adreça URL.

En utilitzar l'API original per cridar al servei del Power BI

Quan la propietat AllowNewAPI està establerta a "False", esteu utilitzant l'API original per cridar al servei del Power BI. En aquest cas, enviant un únic paràmetre de l'aplicació, podeu filtrar els resultats que apareixen en una peça del Power BI. No obstant, només s'admeten els valors de cadena i l'operador igual, i podria ser que el filtre no funcionés si el nom de la taula o el nom de la columna contenen espais.

Per passar un valor de filtre únic, modifiqueu el valor de la propietat TileURL, que segueix aquesta sintaxi:

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

Per a aquest valor, afegiu aquesta sintaxi:

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

Per exemple, utilitzant un valor d'un quadre de llista:

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

El paràmetre filtra un valor al conjunt de l'informe on s'origina la peça. Tanmateix, la característica de filtratge té les limitacions següents:

  • Només es pot aplicar un filtre.
  • Només es permet l'operador eq.
  • El tipus de camp ha de ser una cadena.
  • El filtratge només està disponible als mosaics de visualització ancorats. No està admès per als informes ancorats.
  • No es poden filtrar els scripts visuals d'R i Python.

Podeu utilitzar camps calculats a l'informe del Power BI per convertir altres tipus de valors en cadena o combinar diversos camps en un.

Propietats de la clau

AllowNewAPI: si voleu utilitzar la nova API quan truqueu al servei de Power BI. Si s'ajusta el valor en True, es permet l'ús de la nova API de Power BI (que no està admesa als mòbils i a alguns casos incrustats, però permet uns filtres més avançats). Fals utilitzarà l'API original. El valor per defecte és fals.

Dashboard: l'escriptori digital del Power BI d'on prové la peça.

LoadPowerBIContent: quan es defineix com a cert, el contingut del Power BI es carrega i es mostra. Si es defineix com a fals, el contingut del Power BI es descarrega, que allibera memòria i optimitza el rendiment.

PowerBIInteractions: si s'estableix com a Cert, es pot interactuar amb el contingut del Power BI, però la incidència OnSelect del Power Apps no s'activarà. Quan es defineix com a Fals, no es pot interactuar amb la peça, però la incidència OnSelect del Power Apps s'activarà quan se seleccioni la peça.

Tile: el nom de la peça del Power BI que voleu visualitzar.

Workspace: l'àrea de treball del Power BI d'on prové la peça.

Propietats addicionals

BorderColor: el color de la vora d'un control.

BorderStyle: si la vora d'un control és Sòlid, Amb guions, Amb punts o Cap.

BorderThickness: el gruix de la vora d'un control.

DisplayMode: si el control permet l'entrada de l'usuari (Edita), només mostra les dades (Visualitza) o està inhabilitada (Inhabilitat).

Height: la distància entre les vores superior i inferior d'un control.

OnSelect: accions que cal dur a terme quan l'usuari selecciona un control. Per defecte, l'informe del Power BI associat amb la peça s'obre.

TileUrl: l'adreça URL per la qual se sol·licita la peça des del servei del Power BI. Per afegir el filtratge de la cadena de consulta a la vostra URL, consulteu la secció Filtratge anterior.

Visible: si es mostra o s'amaga un control.

Width: la distància entre les vores esquerra i dreta d'un control.

X: la distància entre la vora esquerra d'un control i la vora esquerra del seu contenidor principal (la pantalla, si no hi ha cap contenidor principal).

Y: la distància entre la vora superior d'un control i la vora superior del seu contenidor principal (la pantalla, si no hi ha cap contenidor principal).

Exemple

  1. A la pestanya Insereix, obriu el menú Gràfics i, a continuació, afegiu un control de Power BI tile.

    No sabeu com afegir i configurar un control?

  2. A la pestanya Dades de la subfinestra d'opcions, seleccioneu La meva àrea de treball per al paràmetre Workspace.

  3. Seleccioneu un escriptori digital a la llista d'escriptoris digitals i, a continuació, seleccioneu una peça a la llista de peces.

    El control representa la peça del Power BI.

Pautes d'accessibilitat

Power BI tile és simplement un contenidor per al contingut del Power BI. Més informació sobre com crear contingut accessible amb aquests consells d'accessibilitat del Power BI.

Si el contingut del Power BI no té cap títol, considereu la possibilitat d'afegir una capçalera mitjançant un control Label per admetre els lectors de pantalla. Podeu posicionar l'etiqueta immediatament abans de la peça del Power BI.

Nota

Ens podeu dir quines són les vostres preferències d'idioma per a la documentació? Responeu una breu enquesta. (tingueu en compte que l'idioma de l'enquesta és l'anglès)

Trigareu uns set minuts a completar l'enquesta. No es recopilen dades personals (declaració de privadesa).