Control Icono de Power BI en Power Apps

Control que muestra un icono de Power BI dentro de una aplicación.

¿No tiene Power BI? Suscribirse.

Descripción

Para sacar provecho de las funciones de informes y análisis de datos existentes, muestre sus iconos de Power BI dentro de las aplicaciones. Especifique el icono que quiere mostrar mediante el establecimiento de sus propiedades Workspace, Dashboard y Tile en la pestaña Datos del panel de opciones.

Nota

  • El control Icono de Power BI no está disponible en entornos de GCC High y DoD.
  • El control Icono de Power BI no está disponible en China.
  • Para conocer los requisitos de licencia al incrustar mosaicos de Power BI, vea Licencias.

Recursos compartidos y seguridad

Cuando se comparte una aplicación que incluye contenido de Power BI, no solo se debe compartir la propia aplicación, sino también el panel de donde procede el icono. De lo contrario, no aparecerá el contenido de Power BI ni siquiera para los usuarios que abran la aplicación. Las aplicaciones que incluyen contenido de Power BI respetan los permisos de ese contenido.

Rendimiento

No se recomienda tener más de tres iconos de Power BI cargados al mismo tiempo dentro de una aplicación. Puede controlar la carga y descarga de iconos si establece la propiedad LoadPowerBIContent.

Opciones para incrustar

La incrustación es diferente entre las versiones de la API de Power BI. Debido al nuevo esquema de autenticación de API de Power BI, es posible que su mosaico no sea accesible en dispositivos móviles o dentro de otros escenarios integrados (Teams o SharePoint).

Puede controlar el uso de la versión de API utilizando la propiedad AllowNewAPI. Para obtener más información, consulte Propiedades clave.

Valor de la propiedad AllowNewAPI Comportamiento
True Puede incrustar un panel, informe o mosaico tomando Insertar URL de Power BI y convirtiéndolo en el valor TileUrl.
False Puede incrustar un panel, informe o mosaico tomando Insertar URL y convirtiéndolo en el valor TileUrl, o usando la interfaz gráfica proporcionada.

Nota

Incrustar una URL de Power BI (por ejemplo, en un IFrame) no es compatible con Power Apps móvil ya que el reproductor móvil no se ocupa de la autenticación de la solicitud de URL de Power BI.

Filtering

El filtrado difiere entre las versiones de la API de Power BI. Consulte las secciones correspondientes a continuación, según cómo configure el control.

Al usar la nueva API para llamar al servicio de Power BI

Cuando la propiedad AllowNewAPI está establecida en "Verdadero", está usando una nueva API para llamar al servicio Power BI. Para obtener más información, consulte Filtro de un informe con parámetros de cadena de consulta en la URL.

Al usar la API original para llamar al servicio de Power BI

Cuando la propiedad AllowNewAPI está establecida en "False", está usando la API original para llamar al servicio Power BI. En este caso, al pasar un solo parámetro de la aplicación, puede filtrar los resultados que aparecen en un icono de Power BI. Sin embargo, solo se admiten valores de cadena y el operador igual, y el filtro podría no funcionar si el nombre de la tabla o el nombre de la columna contienen espacios.

Para pasar un solo valor de filtro, modifique el valor de la propiedad TileURL, que sigue esta sintaxis:

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

A ese valor, agregue esta sintaxis:

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

Por ejemplo, usando un valor de un cuadro de lista:

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

El parámetro filtrará un valor del conjunto de datos del informe donde se origina el mosaico. Sin embargo, la función de filtrado tiene las siguientes limitaciones:

  • Solo se puede aplicar un filtro.
  • Solo se admite el operador eq.
  • El tipo de campo debe ser una cadena.
  • El filtrado solo está disponible en iconos de visualización anclados. No se admite para informes anclados.
  • No se pueden filtrar los elementos visuales de script de R y Python.

Puede usar campos calculados en el informe de Power BI para convertir otros tipos de valor a cadena o combinar múltiples campos en uno.

Propiedades de la clave

AllowNewAPI: si se usará la nueva API al llamar al servicio Power BI. Establecer el valor en Verdadero permitirá el uso de la nueva API Power BI (que no es compatible con dispositivos móviles y algunos escenarios integrados, pero permite un filtrado más avanzado). Falso utilizará la API original. El valor predeterminado es Falso.

Dashboard: panel de Power BI de dónde procede el icono.

LoadPowerBIContent: cuando se establece en Verdadero, el contenido de Power BI se carga y se muestra. Cuando se establece en Falso, el contenido de Power BI se descarga, lo que libera memoria y optimiza el rendimiento.

PowerBIInteractions: cuando se establece en True, se puede interactuar con el contenido de Power BI, pero el evento OnSelect de Power Apps no se activará. Cuando se establece en False, no se podrá interactuar con el icono, pero se desencadenará el evento OnSelect de Power Apps cuando se seleccione el icono.

Tile: nombre del icono de Power BI que quiere mostrar.

Workspace: área de trabajo de Power BI de dónde procede el icono.

Propiedades adicionales

BorderColor: el color del borde de un control.

BorderStyle: si el borde del control es Solid, Dashed, Dotted o None.

BorderThickness: el grosor del borde de un control.

DisplayMode: indica si el control permite entradas de usuario (Editar), solo muestra datos (Ver) o si está deshabilitado (Deshabilitado).

Height: la distancia entre los bordes superior e inferior de un control.

OnSelect: acciones para llevar a cabo cuando el usuario selecciona un control. De forma predeterminada, se abre el informe de Power BI asociado al icono.

TileUrl: dirección URL por medio de la cual se solicita un icono desde el servicio Power BI. Para agregar un filtrado de cadenas de consulta a su URL, consulte la sección Filtración anterior.

Visible: indica si un control aparece o está oculto.

Width: la distancia entre los bordes derecho e izquierdo de un control.

X: la distancia entre el borde izquierdo de un control y el borde izquierdo de su contenedor primario (la pantalla, si no hay un contenedor primario).

Y: la distancia entre el borde superior de un control y el borde superior de su contenedor primario (la pantalla, si no hay un contenedor primario).

Ejemplo

  1. En la pestaña Insertar, abra el menú Gráficos y luego agregue un control Icono de Power BI.

    ¿No sabe cómo agregar y configurar un control?

  2. En la pestaña Datos del panel de opciones, seleccione Mi área de trabajo como valor de Workspace.

  3. Seleccione un panel en la lista de paneles y luego seleccione un icono en la lista de iconos.

    El control representa el icono de Power BI.

Instrucciones para accesibilidad

El Power BI tile es simplemente un contenedor para contenido de Power BI. Aprenda a crear contenido accesible con estas sugerencias de accesibilidad de Power BI.

Si el contenido de Power BI no tiene un icono, considere la posibilidad de agregar un encabezado mediante un control Etiqueta para admitir lectores de pantalla. Puede colocar la etiqueta inmediatamente delante del icono de Power BI.

Nota

¿Puede indicarnos sus preferencias de idioma de documentación? Realice una breve encuesta. (tenga en cuenta que esta encuesta está en inglés)

La encuesta durará unos siete minutos. No se recopilan datos personales (declaración de privacidad).