Eventos
31 mar, 23 - 2 abr, 23
El último evento dirigido por la comunidad de Power BI, Fabric, SQL y AI. 31 de marzo - 2 de abril. Use el código MSCUST para un descuento de 150 USD. Los precios sube el 11 de febrero.
Regístrate hoyEste explorador ya no se admite.
Actualice a Microsoft Edge para aprovechar las características y actualizaciones de seguridad más recientes, y disponer de soporte técnico.
En un objeto visual de Power BI, un icono de advertencia de presentación puede notificar al usuario un posible problema o un error. Mostrar iconos de advertencia puede servir de ayuda en muchos casos, como:
Un objeto visual de mapa puede mostrar un icono de advertencia cuando los valores estén fuera del rango válido de latitud o longitud.
Un objeto visual de gráfico circular puede mostrar un icono de advertencia cuando muestre valores negativos mezclados con otros positivos.
Un gráfico cartesiano puede mostrar un icono de advertencia cuando se calculen valores infinitos. Por ejemplo, si Y es cero, al dividir X por Y el resultado es infinito.
Cuando aparezca el icono, el usuario puede mantener el puntero sobre él para ver el título del mensaje de advertencia.
Cuando el usuario selecciona el icono de advertencia, aparece un mensaje que describe el problema en una ventana emergente.
Puede crear un icono de advertencia con un mensaje personalizado para un objeto visual personalizado. La decisión de si se debe generar el icono de advertencia o no la toma el usuario. Como muestran estos ejemplos, el objeto visual sigue funcionando cuando se muestra el icono de advertencia.
Para agregar un icono de advertencia de presentación al objeto visual, invoque el método displayWarningIcon
. El método forma parte de IVisualHost
y se expone mediante powerbi-visuals-api
.
Agregue la siguiente importación al archivo:
import powerbiVisualsApi from "powerbi-visuals-api";
Después de agregar la importación, agregue una condición que determine cuándo mostrar el icono de advertencia. Use los ejemplos de este artículo para ver dos condiciones opcionales.
La localización se usa para mostrar los objetos visuales en el idioma nativo del cliente, que lo determina la configuración del sistema operativo.
En este ejemplo, el objeto visual compara el idioma del objeto visual (establecido en inglés de EE. UU.) con el idioma del sistema operativo. Si los idiomas no coinciden, se muestra el icono de advertencia.
if (this.locale != 'en-US') {
this.host.displayWarningIcon('Language inconsistency', 'This visual supports only US English. For the visual to work as expected, set your browser's language to US English.');
}
En este ejemplo, aparece el icono de advertencia de presentación cuando dos columnas contiguas entre sí tienen el mismo color.
El método getColumnColorByIndex
recorre en iteración todas las columnas. Si dos columnas adyacentes tienen el mismo color, se muestra un icono de advertencia.
let category = options.dataViews[0].categorical.categories[0];
let dataValue = options.dataViews[0].categorical.values[0];
let colorPalette = this.host.colorPalette;
for (let i = 0, len = Math.max(category.values.length, dataValue.values.length); i < len-1; i++) {
const color1: string = getColumnColorByIndex(category, i, colorPalette);
const color2: string = getColumnColorByIndex(category, i+1, colorPalette);
if (color1 == color2) {
this.host.displayWarningIcon('Adjacent columns have the same color.', 'Columns that are next to each other have the same color. To change a column's color, use the data colors option in the Format tab.');
}
}
Algunos errores y advertencias no se deben al objeto visual. Por ejemplo, el error Demasiados valores. No se muestran todos los datos se deriva del servicio Power BI. Estos errores y advertencias se propagan antes a las llamadas del objeto visual. Tienen prioridad sobre los errores que se originan en el código del objeto visual. Si se produce un error al cargar datos, antes de que se ejecute el código del objeto visual y de que se cumpla la condición del icono de advertencia de presentación, el objeto visual muestra ese error en lugar del error del icono de advertencia de presentación.
La advertencia de presentación se borra durante cada representación del objeto visual como, por ejemplo, cuando se arrastran datos nuevos al objeto visual. El método update()
del objeto visual se invoca después de que se represente el objeto visual. Si la advertencia del objeto visual se genera en función de una condición que está activada en el método de actualización, cada vez que se represente el objeto visual, si se cumple la condición el objeto visual vuelve a mostrar la advertencia.
El cambio de tamaño de un objeto visual no afecta al icono de advertencia.
Las limitaciones siguientes hacen referencia al texto del icono de presentación:
La longitud máxima del título es de 70 caracteres.
La longitud máxima del texto es de 2000 caracteres.
El texto solo se muestra como texto sin formato.
Eventos
31 mar, 23 - 2 abr, 23
El último evento dirigido por la comunidad de Power BI, Fabric, SQL y AI. 31 de marzo - 2 de abril. Use el código MSCUST para un descuento de 150 USD. Los precios sube el 11 de febrero.
Regístrate hoyCursos
Módulo
Usar objetos visuales en Power BI - Training
Cree y personalice objetos visuales para mostrar datos de forma atractiva e interesante.
Documentación
Creación de un cuadro de diálogo en un objeto visual de Power BI - Power BI
Aprenda a crear un cuadro de diálogo en un objeto visual de Power BI para mostrar información adicional al cliente en una ventana independiente.
Modo de edición avanzada en objetos visuales de Power BI - Power BI
Aprenda a habilitar y usar el modo de edición avanzada para configurar los controles avanzados de la interfaz de usuario en objetos visuales de Power BI.
Aplicación de la selección a la característica de varios objetos visuales en Power BI - Power BI
En este artículo se describe cómo aplicar una selección a varios objetos visuales mediante la característica de compatibilidad con la selección de varios objetos visuales en Power BI.