Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Control que muestra un icono de Power BI dentro de una aplicación.
¿No tiene Power BI? Regístrese.
Description
Aproveche los informes y el análisis de datos existentes mostrando los iconos de Power BI dentro de las aplicaciones. Especifique el icono que desea mostrar estableciendo sus propiedades Área de trabajo, Panel y Icono en la pestaña Datos del panel de opciones.
Nota:
- El control de iconos de Power BI no se admite en algunos entornos GCC High y DoD .
- El control de iconos de Power BI no está disponible en China.
- Para conocer los requisitos de licencia al insertar el icono de Power BI, consulte Licencias.
Uso compartido y seguridad
Al compartir una aplicación que contiene contenido de Power BI, debe compartir no solo la propia aplicación, sino también el panel desde el que procede el icono. De lo contrario, el contenido de Power BI no aparecerá incluso para los usuarios que abran la aplicación. Las aplicaciones que contienen contenido de Power BI respetan los permisos de ese contenido.
Performance
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 estableciendo la propiedad LoadPowerBIContent .
Opciones de inserción
La inserción es diferente entre las versiones de la API de Power BI. Debido al nuevo esquema de autenticación de la API de Power BI, es posible que el icono no sea accesible en dispositivos móviles o en otros escenarios incrustados (Teams o SharePoint).
Puede controlar el uso de la versión de API mediante la propiedad AllowNewAPI . Para obtener más información, consulte Propiedades de clave.
| Valor de la propiedad AllowNewAPI | Comportamiento |
|---|---|
| Cierto | Puede insertar un panel, un informe o un icono tomando la dirección URL de inserción de Power BI y convirtiéndolo en el valor TileUrl . |
| Falso | Puede insertar un icono de panel mediante la dirección URL de inserción y convertirlo en el valor TileUrl o mediante la interfaz gráfica proporcionada. |
Nota:
No se admite la inserción de una dirección URL de Power BI (por ejemplo, en un IFrame) en power Apps mobile, ya que la autenticación de la solicitud de dirección URL de Power BI no se controla mediante el reproductor móvil.
Filtros
El filtrado difiere entre las versiones de la API de Power BI. Consulte las secciones adecuadas a continuación en función de cómo configure el control.
Al usar la nueva API para llamar al servicio Power BI
Cuando la propiedad AllowNewAPI está establecida en "True", se usa la nueva API para llamar al servicio Power BI. Para obtener más información, consulte Filtrado de un informe mediante parámetros de cadena de consulta en la dirección URL.
Al usar la API original para llamar al servicio Power BI
Cuando la propiedad AllowNewAPI se establece en "False", se usa la API original para llamar al servicio Power BI. En este caso, pasando un único 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 equals, y es posible que el filtro no funcione si el nombre de la tabla o el nombre de columna contiene espacios.
Para pasar un único 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, anexe esta sintaxis:
&$filter=<TableName>/<ColumnName> eq '<Value>'
Por ejemplo, con un valor de un cuadro de lista:
"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"
El parámetro filtrará un valor en el conjunto de datos del informe donde se origina el icono. Sin embargo, la característica de filtrado tiene las siguientes limitaciones:
- Solo se puede aplicar un filtro.
- Solo se admite el
eqoperador . - El tipo de campo debe ser string.
- El filtrado solo está disponible en iconos de visualización anclados. No se admite para los informes anclados.
- No se pueden filtrar los objetos visuales de script de R y Python.
Puede usar campos calculados en el informe de Power BI para convertir otros tipos de valor en cadenas o combinar varios campos en uno.
Propiedades importantes
AllowNewAPI : indica si se usa la nueva API al llamar al servicio Power BI. Si se establece el valor en True , se permitirá el uso de la nueva API de Power BI (que no se admite en escenarios móviles y algunos incrustados, pero permite un filtrado más avanzado). False usará la API original. El valor predeterminado es false.
Panel : panel de Power BI desde el que procede el icono.
LoadPowerBIContent : cuando se establece en True, el contenido de Power BI se carga y se muestra. Cuando se establece en False, el contenido de Power BI se descarga, que libera memoria y optimiza el rendimiento.
PowerBIInteractions : cuando se establece en True, el contenido de Power BI se puede interactuar con , pero el evento OnSelect de Power Apps no se desencadenará. Cuando se establece en False, el icono no se puede interactuar con , pero el evento OnSelect de Power Apps se desencadenará cuando se seleccione el icono.
Icono : el nombre del icono de Power BI que desea mostrar.
Área de trabajo : área de trabajo de Power BI desde la que procede el icono.
Propiedades adicionales
BorderColor : color del borde de un control.
BorderStyle : indica si el borde de un control es Sólido, Discontinuo, Punteado o Ninguno.
BorderThickness : grosor del borde de un control.
DisplayMode : indica si el control permite la entrada del usuario (Editar), solo muestra datos (Vista) o está deshabilitado (Deshabilitado).
Alto : distancia entre los bordes superior e inferior de un control.
OnSelect : acciones que se deben realizar cuando el usuario selecciona un control. De forma predeterminada, se abre el informe de Power BI asociado al icono.
TileUrl : la dirección URL por la que se solicita el icono desde el servicio Power BI. Para agregar el filtrado de cadenas de consulta a la dirección URL, consulte la sección de filtrado anterior.
Visible : indica si un control aparece o está oculto.
Ancho : distancia entre los bordes izquierdo y derecho de un control.
X : distancia entre el borde izquierdo de un control y el borde izquierdo de su contenedor primario (pantalla, si no hay ningún contenedor primario).
Y : la distancia entre el borde superior de un control y el borde superior del contenedor primario (pantalla, si no hay ningún contenedor primario).
Example
En la pestaña Insertar , abra el menú Gráficos y agregue un control de icono de Power BI .
¿No sabe cómo agregar y configurar un control?
En la pestaña Datos del panel de opciones, seleccione Mi área de trabajo para la configuración Área de trabajo .
Seleccione un panel en la lista de paneles y, a continuación, seleccione un icono en la lista de iconos.
El control representa el icono de Power BI.
Directrices de accesibilidad
El icono de Power BI es simplemente un contenedor para el 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 título, considere la posibilidad de agregar un encabezado mediante un control Label para admitir lectores de pantalla. Puede colocar la etiqueta inmediatamente antes del icono de Power BI.