Control do mosaico de Power BI en Power Apps

  • Artigo

Un control que mostra un mosaico de Power BI dentro dunha aplicación.

Non ten Power BI? Rexistrarse.

Descripción

Aproveite a análise dos seus datos e informes existentes amosando os seus mosaicos de Power BI dentro das súas aplicacións. Especifique o mosaico que desexa mostrar axustando as súas propiedades Workspace, Dashboard e Tile no separador Datos do panel de operacións.

Nota

  • Power BI O control de mosaicos non está dispoñible en GCC High ambientes e doD .
  • O control de mosaicos de Power BI non está dispoñible en China.
  • Para requirimentos de licenza ao incorporar o mosaico de Power BI, consulte Licenzas.

Uso compartido e seguranza

Cando comparte unha aplicación que inclúe contido de Power BI, ten que compartir non só a aplicación en si, senón tamén o panel do que vén o mosaico. Do contrario, o contido de Power BI non aparecerá mesmo para os usuarios que abran a aplicación. As aplicacións que inclúen contido de Power BI respectan os permisos para ese contido.

Desempeño

Non se recomenda ter máis de tres mosaicos de Power BI cargados ao mesmo tempo dentro dunha aplicación. Pode controlar a carga e descarga de mosaicos configurando a propiedade LoadPowerBIContent.

Incorporar opcións

A incorporación é diferente entre as versións da API de Power BI. Por mor do novo esquema de autenticación da API de Power BI, é posible que o seu mosaico non sexa accesible no móbil ou noutros escenarios incorporados (Teams ou SharePoint).

Pode controlar o uso da versión da API usando a propiedade AllowNewAPI. Para obter máis información, consulte Propiedades clave.

Valor da propiedade AllowNewAPI Comportamento
Verdadeiro Pode incorporar un panel, informe ou mosaico tomando o URL de incorporación de Power BI e facéndoo o valor de TileUrl.
Falso Pode incorporar un mosaico de panel mediante o URL de incorporación e facelo o valor de TileUrl ou usar a interface gráfica proporcionada.

Nota

A incorporación dun URL de Power BI (por exemplo, nun IFrame) non é compatible en Power Apps móbil desde que a autenticación da solicitude de URL de Power BI non a xestiona o reprodutor móbil.

Filtraxe

O filtro difire entre as versións da API de Power BI. Vexa as seccións apropiadas a continuación dependendo de como configure o control.

Cando usar a nova API para chamar o servizo Power BI

Cando a propiedade AllowNewAPI está definida como "Verdadeiro", estás usando unha nova API para chamar o servizo Power BI. Para obter máis información, consulte Filtrar un informe utilizando parámetros da cadea de consulta no URL.

Cando usar a API orixinal para chamar o servizo Power BI

Cando a propiedade AllowNewAPI está definida como "Falso", estás usando a API orixinal para chamar o servizo Power BI. Neste caso, ao pasar un único parámetro da aplicación, pode filtrar os resultados que aparecen nun mosaico de Power BI. Non obstante, só se admiten os valores de cadea e o operador igual a, e é posible que o filtro non funcione se o nome da táboa ou o nome da columna conteñen espazos.

Para pasar un único valor de filtro, modifique o valor da propiedade TileURL que segue esta sintaxe:

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

A ese valor, engada esta sintaxe:

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

Por exemplo, usando un valor dunha caixa de lista:

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

O parámetro filtrará un valor no conxunto de datos do informe onde se orixina o mosaico. Non obstante, a función de filtrado ten as seguintes limitacións:

  • Só se pode aplicar un filtro.
  • Só se admite o operador eq.
  • O tipo de campo debe ser unha cadea.
  • O filtrado só está dispoñible en mosaicos de visualización fixados. Non se admite para informes fixados.
  • Non se poden filtrar os elementos visuais dos scripts de R e Python.

Pode empregar campos computados no informe de Power BI para converter outros tipos de valores en cadeas ou combina varios campos nun só.

Propiedades da clave

AllowNewAPI: Se se usa a nova API ao chamar ao servizo Power BI. Definindo o valor en Certo, permitirá o uso da nova API de Power BI (que non se admite en dispositivos móbiles e algúns escenarios incrustados, pero permite algúns filtros máis avanzados). Falso empregará a API orixinal. O valor predefinido é falso.

Panel - O panel de Power BI de onde provén o mosaico.

LoadPowerBIContent: Cando está establecido en verdadeiro, o contido de Power BI cárgase e móstrase. Cando está definido en falso, o contido de Power BI descárgase, o cal libera memoria e optimiza o rendemento.

PowerBIInteractions - Cando se define como Verdadeiro, pódese interactuar co contido de Power BI, pero o evento OnSelect de Power Apps non se activará. Cando se define como Falso, non se pode interactuar co mosaico, pero o evento OnSelect de Power Apps activarase cando se seleccione o mosaico.

Mosaico – O nome do mosaico de Power BI que desexa amosar.

Espazo de traballo - O espazo de traballo de Power BI de onde provén o mosaico.

Propiedades adicionais

BorderColor: cor do bordo dun control.

BorderStyle: se un bordo dun control é Sólido, A trazos, Punteado ou Ningún.

BorderThickness: grosor do bordo dun control.

DisplayMode: se o control permite a entrada do usuario (Editar), só mostra datos (Ver) ou está desactivado (Desactivado).

Altura: distancia entre os bordos superior e inferior dun control.

OnSelect - Accións a realizar cando o usuario selecciona un control. Por defecto, ábrese o informe de Power BI asociado co mosaico.

TileUrl - O URL polo que se solicita o mosaico do servizo de Power BI. Para engadir un filtro de cadeas de consulta ao seu URL, consulte a sección filtrado superior.

Visible: se aparece un control ou está oculto.

Largura: distancia entre os bordos esquerdo e dereito dun control.

X - A distancia entre o bordo esquerdo dun control e o bordo esquerdo do seu recipiente principal (pantalla—se non hai ningún recipiente principal).

Y: a distancia entre o bordo superior dun control e o bordo superior do contedor principal (pantalla—se non hai ningún contedor principal).

Exemplo

  1. No separador Inserir, abra o menú Gráficos e, a continuación, engada un control de mosaico de Power BI.

    Non sabe como engadir e configurar un control?

  2. No separador Datos do panel de opcións, seleccione O meu espazo de traballo para a configuración Espazo de traballo.

  3. Seleccione un panel na lista de paneis e logo seleccione un mosaico na lista de mosaicos.

    O control mostra o mosaico Power BI.

Directrices de accesibilidade

O mosaico de Power BI simplemente é un recipiente para contido Power BI. Aprenda a crear contido accesible con estes consellos de accesibilidade a Power BI.

Se o contido de Power BI non ten un título, considere a posibilidade de engadir unha cabeceira mediante un control de Label para soportar os lectores de pantalla. Pode colocar a etiqueta inmediatamente antes do mosaico de Power BI.

Nota

Pode indicarnos as súas preferencias para o idioma da documentación? Realice unha enquisa breve. (teña en conta que esa enquisa está en inglés)

Esta enquisa durará sete minutos aproximadamente. Non se recompilarán datos persoais (declaración de privacidade).