Historial de versiones
Explora el historial de versiones de reglas en Kilo IoT y restaura cualquier versión anterior — auditoría completa de quién cambió qué y cuándo.
Cada guardado — ya sea manual, automático o activado por un evento de sesión — crea una versión de tu regla. El historial de versiones le da a tu equipo un registro de auditoría completo de cómo evolucionó una regla de automatización, quién la cambió y cuándo. Si un cambio introduce un comportamiento inesperado, puedes restaurar cualquier versión anterior sin perder nada en el proceso.
Por qué el control de versiones importa en producción
Las reglas de automatización afectan directamente los resultados operativos. Un umbral mal configurado, una condición invertida o una rama de respaldo faltante pueden generar falsas alarmas, silenciar las reales o inundar tus canales de notificación. El historial de versiones significa que nunca quedas atrapado por una mala edición. Puedes revisar qué cambió, restaurar una versión conocida como buena y volver a desplegar — todo sin reconstruir la regla de memoria.
Dónde encontrarlo
Abre una regla en Edición y haz clic en la Historial pestaña debajo de la barra de encabezado. La pestaña Historial forma parte únicamente de la ruta de edición. Si actualmente estás viendo una regla en /rules/:id/view, cambia primero a Edición . La página de historial se encuentra en /rules/:id/edit/history.
Encima de la tabla, un campo de búsqueda te permite filtrar versiones por:
nombre de la versión
autor
tipo de guardado
Tabla de historial de versiones
La pestaña Historial muestra una tabla de todas las versiones guardadas, ordenadas con la versión más reciente arriba.
Columnas
Nombre de la versión
Una etiqueta legible para humanos para la versión. Por defecto, usa el nombre generado automáticamente. Editable en línea.
Fecha y hora
Cuándo se guardó la versión, con formato "dd MMM yyyy, HH:mm"
Tipo de guardado
Cómo se creó la versión (ver abajo)
Usuario
El miembro del equipo cuya sesión creó la versión
Tipos de guardado
Cada versión registra cómo se creó:
manual
El usuario hizo clic en el Guardar botón explícitamente
automático
Autoguardado periódico durante una sesión de edición activa
cierre_del_editor
Guardado automáticamente cuando el usuario salió del editor
desconexión
Guardado cuando el navegador se cerró o la conexión se perdió inesperadamente
tiempo_de_espera_de_sesión
Guardado después de que expiró el tiempo de espera por inactividad y la sesión se cerró
limpieza_de_bloqueo
Guardado por un proceso en segundo plano cuando detectó un bloqueo vencido y lo liberó
restaurado
Esta versión se creó al restaurar una versión anterior
Los tipos de guardado te ayudan a entender el contexto de cada versión. Una serie de entradas "auto" seguida de una entrada "manual" te dice que alguien estaba trabajando activamente y luego guardó deliberadamente. Una entrada "disconnect" te dice que la sesión terminó inesperadamente — comprueba si el trabajo de esa versión está completo.
Cambiar el nombre de las versiones
De forma predeterminada, las versiones llevan nombres generados automáticamente. Puedes cambiar el nombre de cualquier versión para que tenga sentido para tu equipo — por ejemplo, "Antes de la refactorización de la puerta de enlace" o "Línea base de producción v3."
Para cambiar el nombre de una versión:
Haz clic en el icono de lápiz junto al nombre de la versión en la tabla de historial.
Escribe el nuevo nombre (hasta 100 caracteres).
Pulsa Enter o haz clic fuera para confirmar.
Restricciones de nombres:
Máximo de 100 caracteres
No puede duplicar el nombre de otra versión en la misma regla
Los caracteres
<,>, y/no están permitidos
Las versiones con buenos nombres hacen más rápido identificar el punto de restauración correcto cuando algo sale mal a las 2 AM.
Ver una versión anterior
Para inspeccionar cómo se veía una regla en un punto específico en el tiempo:
Encuentra la versión en la tabla de historial.
Haz clic en el icono de ojo (Acción Ver) en esa fila.
El editor abre un visor BPMN de solo lectura que muestra el diagrama tal como existía en esa versión, en una ruta bajo
/rules/:id/edit/history/....
En la navegación normal, el segmento final de la ruta corresponde a la versión guardada seleccionada de la tabla.
En esta vista, no puedes editar ni modificar el diagrama. Hay dos botones disponibles:
Restaurar esta versión — Inicia el flujo de restauración (ver abajo)
Salir del modo de vista — Te devuelve a la pestaña Historial
Restaurar una versión
Restaurar una versión la convierte en el estado actual de la regla. La restauración no sobrescribe ni elimina ningún historial — crea una nueva entrada en la parte superior de la tabla de historial como la versión actual, y la versión que estaba activa anteriormente se conserva en el historial.
Cómo restaurar
Visualiza la versión que quieres restaurar (haz clic en el icono de ojo).
Haz clic en Restaurar esta versión.
Aparece un cuadro de diálogo de confirmación, que explica que la restauración creará una nueva versión actual y conservará la versión activa anterior en el historial.
Haz clic en Restaurar para confirmar.
La versión se restaura como la nueva versión actual con el tipo de guardado "restaurado."
La plataforma te devuelve al editor con la versión restaurada como el borrador actual.
La pestaña Historial se actualiza para mostrar la nueva entrada en la parte superior.
Qué ocurre después de una restauración
La versión restaurada se convierte en la versión activa en el editor.
La versión que estaba activa antes de la restauración permanece en la tabla de historial — el trabajo guardado sigue siendo recuperable mediante el historial de versiones.
La nueva entrada de versión muestra el tipo de guardado restaurado y registra al usuario que realizó la restauración.
La versión restaurada es un borrador. No se despliega hasta que la compilas y la despliegas. Si el artefacto desplegado anterior sigue en ejecución, continuará ejecutando la lógica antigua hasta que despliegues una nueva compilación.
Buenas prácticas
Nombra las versiones después de cambios significativos. Antes de refactorizar una regla compleja, guarda manualmente y nombra la versión con algo reconocible. Esto te da un punto de restauración limpio si la refactorización sale mal.
Usa los nombres de las versiones para documentar la intención. Una versión llamada "Se agregó una rama de respaldo para la humedad" es mucho más útil que "Versión 14" cuando estás revisando el historial seis meses después.
Revisa los tipos de guardado antes de restaurar. Una versión "auto" o "disconnect" puede representar trabajo incompleto. Prefiere restaurar desde un guardado "manual" cuando sea posible.
Restaura antes de reconstruir. Si una regla desplegada se está comportando mal, restaura primero a la última versión conocida como buena, y luego compila y despliega. No edites la versión rota bajo presión.
Última actualización