Widgets – Hermetry

Un widget es el tipo de tarjeta que colocas en un panel. Hermetry incluye un catálogo de widgets integrados, los módulos de IoT añaden los suyos y tu organización puede crear más (consulta Tus propios widgets). Esta página enumera todos ellos y explica los ajustes que tiene cada tarjeta. Las páginas de Tipos de tarjeta describen cada familia en detalle.

El catálogo

El selector Añadir widget tiene las pestañas Todos, Favoritos y Mis widgets, un cuadro de búsqueda (Buscar widgets…) y las categorías siguientes. Marca un widget con Añadir a favoritos para encontrarlo después.

Gráficos

Widget	Dibuja	Datos que necesita	Página
Gráfico de líneas	Una o más series en el tiempo como líneas	Una serie (hasta 8 fuentes)	Tarjetas de gráficos
Gráfico de barras	Series como barras, o una barra por fila de una tabla	Una serie, o una tabla	Tarjetas de gráficos
Gráfico de áreas	Series como áreas rellenas, apiladas o no	Una serie	Tarjetas de gráficos
Gráfico circular	Una tabla (etiqueta, valor) como sectores o un donut	Una tabla	Tarjetas de gráficos
Gráfico de dispersión	Una tabla (x, y, grupo opcional) como puntos, con una línea de tendencia	Una tabla	Tarjetas de gráficos
Histograma	La distribución de una columna numérica en intervalos	Una tabla	Tarjetas de gráficos
Mapa de calor	Una tabla (x, y, valor) como cuadrícula de colores, por ejemplo hora por día de la semana	Una tabla	Tarjetas de gráficos

Datos

Widget	Muestra	Datos que necesita	Página
Estadística	Un número con una etiqueta, un icono, rangos de color y una comparación opcional	Un valor	Tarjetas de valor
Estadística con tendencia	El último valor de una serie, su cambio y una línea de tendencia	Una serie	Tarjetas de valor
Indicador	Un número en un semicírculo, un donut, una barra o un nivel	Un valor	Tarjetas de valor
Progreso	Un número frente a un objetivo, como barra, anillo o semianillo	Un valor	Tarjetas de valor
Estado	Un valor asignado a un estado etiquetado y coloreado o a un piloto	Un valor	Tarjetas de valor
Atributos	Un registro como lista de etiquetas y valores	Un registro	Tarjetas de valor
Tabla	Filas y columnas con ordenación, búsqueda, paginación y descarga	Una tabla	Tablas y listas
Feed de actividad	Eventos en orden temporal con un color de severidad	Una tabla	Tablas y listas
Mapa	Filas con coordenadas como marcadores, zonas y rutas, en un mapa o un plano de planta	Una tabla	Tarjetas de mapa

Contenido

Widget	Muestra	Página
Texto	Texto en Markdown, opcionalmente con valores de un registro y parámetros del panel	Tarjetas de contenido
Imagen	Una imagen con un pie de foto y un enlace	Tarjetas de contenido
Enlaces rápidos	Una lista, tarjetas, mosaicos o botones que abren páginas	Tarjetas de contenido
Incrustar	Una página https externa en un marco aislado, solo de los sitios permitidos	Tarjetas de contenido
Reproductor de vídeo	Un archivo de vídeo o un directo (HLS)	Tarjetas de contenido

Controles

Widget	Hace	Página
Botón	Ejecuta acciones o un comando al pulsarlo; puede ser un interruptor de estado	Tarjetas de control
Interruptor	Lee un valor de encendido/apagado y envía un comando al cambiarlo	Tarjetas de control
Deslizador	Lee un número y envía el nuevo al soltar	Tarjetas de control
Punto de consigna	Un campo numérico con Aplicar, un selector incremental o un dial	Tarjetas de control
Formulario	Varios campos guardados juntos con un solo comando	Tarjetas de control

IoT

Widget	Muestra	Página
Tabla de dispositivos	Tus dispositivos con su estado de conexión en vivo	Tablas y listas
Tabla de alarmas	Alarmas con severidad y estado, en vivo	Tablas y listas
Reglas	La tarjeta de Reglas de un sitio o de un dispositivo	La tarjeta de Reglas

Proceso y SCADA y 3D

Widget	Muestra	Página
Diagrama de proceso	Un dibujo de proceso 2D cuyos símbolos siguen valores en vivo	SCADA
Símbolo de proceso	Un símbolo de proceso (un tanque, una bomba, una válvula) controlado por un valor	SCADA
Diseño, en vivo (3D)	Un diseño 3D guardado cuyos elementos siguen valores en vivo	Vistas 3D
Modelo 3D	Un modelo IFC publicado con marcadores de sensores	Vistas 3D

Estos cuatro aparecen solo cuando tu organización usa los módulos SCADA y 3D del complemento de IoT. Cuando un módulo está desactivado, sus tarjetas permanecen en los paneles, conservan sus ajustes y muestran una tarjeta «Widget no disponible» («Este widget ya no está disponible: su módulo puede estar desactivado o es posible que ya no tengas acceso.»). Vuelve a activar el módulo y se dibujarán como antes.

Añadir una tarjeta

Abre el panel y selecciona Personalizar.
Selecciona Añadir widget y elige un widget.
En el cajón de ajustes, abre la pestaña Datos y elige de dónde llegan los valores. Hasta entonces la tarjeta dice, por ejemplo, «Vincula una serie de datos en los ajustes de este widget.» Consulta Fuentes de datos y parámetros.
Define el Título. Un título puede mostrar un parámetro con {{param_<key>}}, por ejemplo Bomba {{param_device}}, que se lee como el nombre del dispositivo elegido.
Selecciona Guardar. Después selecciona Listo para salir de Personalizar.

El cajón de ajustes

El cajón tiene pestañas. Las pestañas que aparecen dependen del widget.

Pestaña	Contiene
Tarjeta	Título, subtítulo, icono del título, texto de ayuda, estilo de tarjeta (Elevada, Plana, Contorno, Sin marco), espaciado interior, fondo, botones de la tarjeta, pantallas pequeñas
Datos	Las fuentes de datos de cada ranura, la ventana temporal, el intervalo de actualización, qué mostrar sin datos o con datos antiguos, el script (bajo Avanzado: calcular los valores con un script)
Visualización	El aspecto propio del widget: series, ejes, rangos, disposición, colores
Comportamiento	Qué ocurre al hacer clic (acciones), textos de respuesta de los controles

Los ajustes marcados como avanzados se ocultan bajo Ajustes avanzados. Guardar del cajón conserva la tarjeta; Cancelar pregunta «¿Descartar los cambios sin guardar?» si has cambiado algo. Guardar como widget… guarda la tarjeta como widget reutilizable en tu biblioteca.

Ajustes que tienen todas las tarjetas

Ajuste	Valores	Predeterminado
Botones de la tarjeta	Pantalla completa, Descargar datos (CSV), Actualizar ahora	Pantalla completa para tarjetas con datos. Con CSV activado, aparece junto a él un botón de Excel.
Actualizar cada (segundos)	Un número, o Desactivado	El Actualizar cada (segundos) del panel; si no, ninguno
Cuando no hay datos	Tu texto	«Sin datos»
Mostrar última actualización	Desactivado, «hace 2 min», una hora, una fecha, fecha y hora	Desactivado
Los datos caducan tras (segundos)	0 a 604.800; 0 = nunca	0
Cuándo los datos son antiguos	Mostrar una insignia «Datos antiguos», Atenuar la tarjeta y mostrar la insignia, Mostrar el mensaje de sin datos	Insignia
Mostrar el intervalo de tiempo en la tarjeta	Permite a los visualizadores elegir un intervalo solo para esta tarjeta (nunca se guarda)	Desactivado
Ocultar en pantallas pequeñas, Ocultar en pantallas grandes, Orden en pantallas pequeñas, Altura en pantallas pequeñas (px)	Diseño para móvil	Desactivado, orden de cuadrícula, automático

Los valores numéricos también tienen un Formato de valor: Unidad, Decimales (0 a 10), Posición de la unidad y Números grandes (1,250,000 o 1.25M).

Solución de problemas

La tarjeta muestra	Qué hacer
«Esta tarjeta no está terminada: elija su … en su configuración.»	Falta un campo de datos obligatorio. Abra la configuración y complételo.
«Elija un valor en los filtros de arriba para cargar este widget.»	La tarjeta depende de un parámetro que aún no tiene valor. Seleccione uno en la barra de filtros.
«Es posible que no vea los datos de esta tarjeta.»	No tiene el permiso de lectura para esos datos. Pida ayuda a un administrador.
«No actualizado»	Demasiadas solicitudes: la tarjeta muestra los últimos datos y vuelve a intentarlo en breve.
«Widget no disponible»	Su módulo está desactivado o ha perdido el acceso. Quitar del panel elimina la tarjeta.

Más causas: Un panel no muestra datos.