🍩 Dona · Propiedades del Widget
Objetivo Principal: Permite al usuario configurar el widget Dona, utilizado para representar la proporción de cada categoría sobre el total mediante sectores circulares con hueco central, en dashboards Analytics.
📸 Mapeo de Interfaz
La captura no muestra esto
La imagen corresponde a una versión anterior y al panel de un gráfico de líneas. En la 0.4.46 el gráfico de Dona no muestra la sección "Ejes y referencias" —no tiene ejes— y su sección "Grosor y tamaño" sólo contiene la casilla "Mostrar porcentajes"; además, la pestaña "Apariencia" incluye la sección "Paleta de colores" y la sección "Contenedor" ya no ofrece el selector "Fondo" ni el deslizador "Transparencia" cuando el gráfico se configura desde un dashboard.
🧩 Despiece de Elementos Funcionales
Los elementos marcados con — no aparecen señalados en la captura: existen en la versión 0.4.46 pero la imagen no los numera.
| # | Nombre del Elemento | Tipo | Destino / Acción | Descripción Funcional |
|---|---|---|---|---|
| 1 | Pestañas de configuración | Navegación interna | Cambia sección de propiedades | Permite alternar entre las distintas categorías de configuración del gráfico. Para utilizarlo, el usuario debe pulsar “Datos”, “Apariencia” o “Texto” según el tipo de configuración que quiera modificar. |
| 1.1 | Campo "Nombre del widget" | Campo de texto | Renombra el gráfico | Permite definir el nombre identificativo del gráfico dentro del dashboard. Para utilizarlo, el usuario debe escribir el nombre que quiera mostrar en la cabecera del widget. |
| 1.2 | Sección "Configuración General" | Configuración de datos | Configura variables y agregación | Permite seleccionar las variables que utilizará el gráfico y cómo se procesarán los datos. Para utilizarlo, el usuario debe pulsar “Editar”, seleccionar variables y configurar agregación e intervalo. |
| 1.3 | Sección "Rango de Tiempo" | Configuración temporal | Configura periodo de datos | Permite definir el rango temporal utilizado por el gráfico. Para utilizarlo, el usuario puede usar el filtro global o configurar un rango específico según las necesidades del dashboard. |
| 2 | Pestaña "Apariencia" | Configuración visual | Personaliza el gráfico | Permite acceder a todas las configuraciones visuales relacionadas con el diseño y estilo del gráfico. |
| 2.1 | Sección "Contenedor" | Configuración visual | Ajusta apariencia del widget | Permite modificar el estilo del contenedor del gráfico. Para utilizarlo, el usuario debe elegir el "Estilo de marco" y decidir con las casillas si oculta la cabecera, el borde, la ventana temporal o el conteo de variables. El selector de fondo y el deslizador de transparencia sólo se ofrecen al configurar el gráfico desde una vista SCADA. |
| 2.2 | Sección "Opciones de gráfico" | Configuración funcional | Ajusta visualización | Permite activar o desactivar "Mostrar leyenda", "Mostrar cuadrícula" y "Activar tooltip en hover". Al activar la leyenda se despliegan "Posición" ("Arriba", "Abajo", "Izquierda" o "Derecha"), "Alinear" y la casilla "Flotante — sobre el gráfico", que la superpone al área del gráfico. |
| 2.3 | Sección "Tipografía" | Configuración textual | Ajusta textos y fuentes | Permite modificar tamaños, colores y pesos tipográficos de títulos, subtítulos y leyendas. Para utilizarlo, el usuario debe seleccionar familia tipográfica y ajustar tamaños y estilos visuales. |
| 2.4 | Sección "Grosor y tamaño" | Configuración visual | Muestra los porcentajes | En los gráficos circulares esta sección no contiene ningún deslizador: su única opción es la casilla "Mostrar porcentajes", que hace que cada sector muestre su porcentaje sobre el total. |
| 2.5 | Sección "Ejes y referencias" | Configuración de ejes | No disponible en este gráfico | El gráfico de Dona no tiene ejes, por lo que esta sección no se muestra en su panel de configuración. Sólo aparece en los gráficos con ejes: líneas, área, series temporales, barras, columnas y sus versiones apiladas. |
| 3 | Pestaña "Texto" | Configuración textual | Configura textos adicionales | Permite acceder a configuraciones relacionadas con textos auxiliares y contenido adicional mostrado en el gráfico. |
| 3.1 | Sección "Textos adicionales" | Configuración textual | Añade información contextual | Permite añadir subtítulos y notas adicionales dentro del gráfico. Para utilizarlo, el usuario debe rellenar los campos disponibles con información contextual o aclaraciones visuales. |
| — | Sección "Filtros de contexto" | Configuración de datos | Elige de qué contexto salen los datos | Aparece en la pestaña "Datos", debajo de "Rango de tiempo", al configurar el gráfico desde un dashboard. Permite que el gráfico siga los filtros generales del dashboard o que fije un contexto propio de "Planta", "Zona", "Máquina", "Grupo" y "Turno". Se cambia con los botones "Filtro global" y "Contexto propio", y la cabecera de la sección indica en cuál de los dos modos está. |
| — | Secci ón "Paleta de colores" | Configuración visual | Elige la gama de colores de las series | Es la primera sección de la pestaña "Apariencia" y sólo se ofrece al configurar el gráfico desde un dashboard. Para utilizarla, el usuario debe pulsar la paleta con la que quiere que se pinten las series. |
💡 Guía de Uso · Dona
El widget Dona está diseñado para representar distribuciones porcentuales mediante gráficos circulares con espacio central libre.
Se utiliza principalmente para:
- Mostrar porcentajes
- Representar distribuciones
- Visualizar composiciones
- Mostrar resúmenes visuales
- Comparar partes de un conjunto
- Facilitar interpretación rápida
- Mostrar valores centrales destacados
✅ Cómo configurar correctamente el widget Dona
- Arrastra el widget al canvas.
- Selecciona el gráfico dentro del dashboard.
- Desde el panel de propiedades:
- Configura categorías y valores.
- Ajusta colores y estilos.
- Activa "Mostrar porcentajes" si quieres que cada sector muestre su porcentaje. El texto del centro de la dona (valor y total) se genera automáticamente y no requiere configuración.
- Configura leyendas y etiquetas.
- Guarda los cambios realizados.