Además de los widgets integrados, tu organización puede tener los suyos propios. La forma más sencilla es guardar una tarjeta que hayas configurado como widget. Los administradores también pueden crear widgets a partir de una plantilla HTML, con su propio formulario de ajustes y sus propias ranuras de datos, y publicar versiones de ellos. Los widgets se guardan en la biblioteca de widgets.
La biblioteca de widgets
Abre Widgets en el menú (en Configuración). «Todo lo que puede colocarse en un panel.»
| Estantería | Contiene |
|---|---|
| Sistema | Los widgets integrados y los que añaden los módulos («Los módulos aportan widgets al activarse.») |
| Organización | Widgets compartidos con toda la organización |
| Mis widgets | Tus widgets privados («Los widgets que creas aparecen en esta estantería.») |
| Favoritos | Los widgets que has marcado con una estrella, de cualquier estantería |
La tabla muestra Nombre, Categoría y Usado por (cuántas tarjetas lo usan), con un filtro Tipo: Integrado, Plantilla HTML, Marco de plugin. Editar abre un widget que puedes modificar.
| Quién | Puede |
|---|---|
| Todos los miembros (Crear y editar tus propios widgets privados) | Crear widgets privados para sí mismos |
| Administradores (Crear y editar widgets, Publicar versiones de widgets) | Crear, editar y publicar widgets para todos |
Tu plan determina cuántos widgets personalizados compartidos puede tener tu organización. Los widgets privados de cada miembro cuentan contra su propia cuota dentro del mismo límite, de modo que los widgets privados nunca consumen los compartidos.
Guardar una tarjeta como widget
- Configura una tarjeta en un panel como quieras.
- En sus ajustes, selecciona Guardar como widget… («Guarda los ajustes y datos actuales de esta tarjeta como un widget reutilizable en tu biblioteca.»).
- El widget aparece en Mis widgets: «Guardado como widget en tu biblioteca.» Colócalo en cualquier panel desde Añadir widget > Mis widgets.
Crear un widget
- En la biblioteca de widgets, selecciona Nuevo widget.
- Elige cómo empezar: Desde un gráfico listo (un gráfico integrado con tus valores predeterminados) o Desde una plantilla HTML.
- Introduce un Nombre y una Categoría, y elige Solo yo o Todos (solo administradores).
- Selecciona Crear. Se abre el editor de widgets.
El editor de widgets
El editor muestra una Vista previa en directo a la izquierda y el formulario de Ajustes a la derecha. La vista previa la dibuja el mismo marco aislado que usa un panel, así que lo que ves es lo que reciben los paneles. Las pestañas:
| Pestaña | Contiene |
|---|---|
| Plantilla | El HTML de un widget de plantilla HTML. Un widget integrado o de plugin indica que «se muestra mediante código que incluimos, por lo que aquí no hay ninguna plantilla que editar». |
| Esquema | Los campos de ajustes: Clave, Etiqueta, Tipo. «Cada campo que añadas aquí aparece en el panel de la derecha, y en el cajón que un operador abre en una colocación.» Al eliminar un campo, también se elimina su valor predeterminado. |
| Datos | Hasta 6 ranuras de datos: Clave de ranura, Etiqueta, Forma (escalar, serie, tabla, registro), Obligatoria. «Una ranura indica lo que el widget NECESITA (un escalar, una serie), nunca de dónde procede.» Cada tarjeta elige el origen. |
| Acciones | Solo lectura: las acciones se definen por tarjeta, en el cajón de ajustes del panel. |
Usar como valores predeterminados escribe los ajustes en pantalla en los valores predeterminados del widget.
Escribir una plantilla HTML
- Un campo de ajustes es un token: el campo
titlees{{title}}. - Una ranura de datos escalar
maines{{data_main}}. Las formas más complejas están enwindow.WIDGET_DATA.<slot>para el propio script de la plantilla. - Para hacer clicable algo, llama a
window.widgetAction()o asigna a un elementodata-widget-action. La tarjeta ejecuta entonces las acciones que configuró su panel; la plantilla nunca indica un destino.
<div style="font: 600 32px system-ui">{{data_main}} {{unit}}</div>
<div style="color: #666">{{caption}}</div>
<button data-widget-action>Details</button>
La plantilla se ejecuta en un marco sin acceso a Hermetry, a tu sesión ni a otras tarjetas, bajo su propia política de seguridad de contenido. Los widgets de plantilla se muestran en pantallas de visualización.
Borradores, versiones y publicación
Un widget tiene un estado: Borrador, Publicado o Archivado. Tus cambios van al borrador y se guardan mientras escribes (también con Ctrl+S); la cabecera muestra «sin guardar…» y luego Guardado. Deshacer y rehacer (Ctrl+Z, Ctrl+Mayús+Z) funcionan mientras editas. Los paneles solo ven las versiones publicadas, así que un borrador nunca cambia un panel.
| Acción | Efecto |
|---|---|
| Publicar | Convierte el borrador en una nueva versión (desde Borrador o Publicado). Las tarjetas de los paneles la siguen. |
| Despublicar | Devuelve un widget publicado a Borrador. |
| Archivar | Retira un widget en borrador o publicado (Archivado). |
| Restaurar | Devuelve un widget archivado como Borrador. |
El editor ofrece solo las acciones que permite el estado del widget.
Cuando una publicación cambia ajustes que ya usan tarjetas, el cuadro Cambios de ajustes desde la última publicación los enumera: campos renombrados, eliminados, de tipo cambiado, restringidos o en desuso. Si un campo nuevo sustituye a uno eliminado, indícalo («caption ahora es …») y los valores pasarán a él. Las tarjetas ya en paneles mantienen los valores predeterminados anteriores conserva las tarjetas existentes tal como se ven ahora; si está desactivado, las tarjetas que nunca han fijado un valor seguirán el nuevo valor predeterminado.
Si dos personas editan el mismo widget, el segundo guardado se rechaza en lugar de sobrescribir en silencio el primero.
Widgets del sistema
Un widget del sistema se incluye con la plataforma. Al editarlo se muestra «Este es un widget del sistema. Se incluye con la plataforma, así que los cambios aquí no son los que conservará una actualización.» Un widget compartido propio no puede usar el nombre de tipo de un widget de la plataforma.
Mover widgets
Un archivo de panel indica los widgets que usan sus tarjetas, pero no incluye sus definiciones. Antes de importar a otra organización un panel que use tus widgets, vuelve a crear esos widgets allí. Consulta Plantillas de paneles y archivos de panel.

