Historial de Versiones - Control de cambios en Workflows

Que es el Historial de Versiones

El historial de versiones es un sistema de control de cambios integrado que permite guardar instantaneas (snapshots) del estado de un workflow a lo largo del tiempo. Cada vez que se realizan cambios significativos, puedes crear una version manual o el sistema crea automaticamente versiones de respaldo.

Funciona como un control de cambios que te permite:

Volver atras si una modificacion rompe el funcionamiento
Comparar dos versiones para ver que cambio
Auditar la evolucion de un workflow a lo largo del tiempo
Recuperar trabajo perdido o accidentalmente eliminado

Tipos de versiones

Versiones automaticas (Auto)

El sistema crea versiones automaticamente cuando se guarda un workflow. Estas versiones aparecen marcadas con la etiqueta Auto y son utiles como puntos de restauracion sin intervencion del usuario.

Versiones manuales

Las versiones manuales se crean explicitamente desde el panel de Historial. Permiten anadir una descripcion que explique el cambio, lo que las hace ideales para marcar hitos importantes (ej. “Antes de cambiar el flujo de pagos”, “Version estable v1.2”, etc.).

Acceder al historial

Abre un workflow en el editor visual
Haz clic en el icono de Historial en la barra superior del editor
Se abrira un panel lateral derecho con todas las versiones guardadas

Cada entrada del historial muestra:

Numero de version (v1, v2, v3…)
Tipo (Auto o Manual)
Fecha y hora de creacion
Numero de nodos y conexiones en esa version
Descripcion (si fue una version manual)

Crear una version manual

En el panel de Historial, haz clic en Crear Version
(Opcional) Anade una descripcion del cambio
Haz clic en Crear

La nueva version se anadira al inicio de la lista con la etiqueta Manual.

Comparar versiones

La comparacion permite ver exactamente que cambio entre dos versiones de un workflow.

Como comparar

En el panel de Historial, haz clic en una version para seleccionarla (se marcara con un borde naranja)
Haz clic en una segunda version
Pulsa el boton Diff

Que se compara

El sistema realiza un analisis profundo de los cambios entre las dos versiones. Compara:

Aspecto	Detalle
Nodos anadidos	Nodos que existen en la version mas reciente pero no en la antigua
Nodos eliminados	Nodos que existian en la version antigua pero ya no estan
Nodos modificados	Nodos cuya configuracion completa ha cambiado
Conexiones anadidas	Nuevas conexiones (edges) entre nodos
Conexiones eliminadas	Conexiones que ya no existen

Que incluye un nodo “modificado”

Un nodo se marca como modificado cuando cualquier parte de su configuracion ha cambiado. Esto incluye:

Variables del nodo (nombre, tipo, valor por defecto)
Scripts (codigo JavaScript, expresiones, formulas)
Parametros de configuracion (URLs, headers, mensajes, etc.)
Credenciales seleccionadas
Conexiones a bases de datos o servicios externos
Cualquier otra propiedad definida en el objeto config del nodo

Limitacion actual

Actualmente el sistema reporta que un nodo cambio, pero no muestra el diff linea por linea de los cambios internos. Para ver los cambios especificos, usa la Previsualizacion de cada version y compara visualmente la configuracion.

Restaurar una version

Si necesitas volver a una version anterior:

Ubica la version en el panel de Historial
Haz clic en el icono de Restaurar (icono de flecha circular)
Confirma la accion

Importante: Antes de restaurar, el sistema crea automaticamente una version de backup del estado actual, para que puedas deshacer la restauracion si fue un error.

Previsualizar una version

Si quieres ver el contenido de una version sin restaurarla:

Haz clic en el icono de Previsualizar (ojo) de la version
Se abrira un dialog mostrando:
- Metadatos (fecha, tipo, numero de nodos y conexiones)
- Vista previa del JSON del workflow

Desde la previsualizacion tambien puedes restaurar la version directamente.

Eliminar una version

Haz clic en el icono de Eliminar (papelera) de la version
Confirma la accion

Esta accion no se puede deshacer. No puedes eliminar la unica version restante de un workflow.

Buenas practicas

Crea versiones manuales antes de cambios grandes o riesgosos
Usa descripciones claras para identificar facilmente cada version
Compara versiones antes de restaurar para entender los cambios
No dependas solo de versiones automaticas para cambios criticos
Limpia versiones antiguas que ya no necesites para mantener el historial manejable