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 versión manual o el sistema crea automáticamente versiones de respaldo.

Funciona como un control de cambios que te permite:

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

Tipos de versiones

Versiones automáticas (Auto)

El sistema crea versiones automáticamente cuando se guarda un workflow. Estas versiones aparecen marcadas con la etiqueta Auto y son útiles como puntos de restauración sin intervención del usuario.

Versiones manuales

Las versiones manuales se crean explicitamente desde el panel de Historial. Permiten anadir una descripción que explique el cambio, lo que las hace ideales para marcar hitos importantes (ej. “Antes de cambiar el flujo de pagos”, “Versión 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 abrirá un panel lateral derecho con todas las versiones guardadas

Cada entrada del historial muestra:

Número de versión (v1, v2, v3…)
Tipo (Auto o Manual)
Fecha y hora de creación
Número de nodos y conexiones en esa versión
Descripción (si fue una versión manual)

Crear una versión manual

En el panel de Historial, haz clic en Crear Versión
(Opcional) Anade una descripción del cambio
Haz clic en Crear

La nueva versión se anadira al inicio de la lista con la etiqueta Manual.

Comparar versiones

La comparación permite ver exactamente que cambio entre dos versiones de un workflow.

Como comparar

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

Que se compara

El sistema realiza un análisis profundo de los cambios entre las dos versiones. Compara:

Aspecto	Detalle
Nodos anadidos	Nodos que existen en la versión mas reciente pero no en la antigua
Nodos eliminados	Nodos que existian en la versión antigua pero ya no estan
Nodos modificados	Nodos cuya configuración 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 configuración ha cambiado. Esto incluye:

Variables del nodo (nombre, tipo, valor por defecto)
Scripts (código JavaScript, expresiones, formulas)
Parámetros de configuración (URLs, headers, mensajes, etc.)
Credenciales seleccionadas
Conexiones a bases de datos o servicios externos
Cualquier otra propiedad definida en el objeto config del nodo

Limitación actual

Actualmente el sistema reporta que un nodo cambio, pero no muestra el diff línea por línea de los cambios internos. Para ver los cambios especificos, usa la Previsualización de cada versión y compara visualmente la configuración.

Restaurar una versión

Si necesitas volver a una versión anterior:

Ubica la versión en el panel de Historial
Haz clic en el icono de Restaurar (icono de flecha circular)
Confirma la acción

Importante: Antes de restaurar, el sistema crea automáticamente una versión de backup del estado actual, para que puedas deshacer la restauración si fue un error.

Previsualizar una versión

Si quieres ver el contenido de una versión sin restaurarla:

Haz clic en el icono de Previsualizar (ojo) de la versión
Se abrirá un dialog mostrando:
- Metadatos (fecha, tipo, número de nodos y conexiones)
- Vista previa del JSON del workflow

Desde la previsualización también puedes restaurar la versión directamente.

Eliminar una versión

Haz clic en el icono de Eliminar (papelera) de la versión
Confirma la acción

Esta acción no se puede deshacer. No puedes eliminar la única versión restante de un workflow.

Buenas practicas

Crea versiones manuales antes de cambios grandes o riesgosos
Usa descripciones claras para identificar fácilmente cada versión
Compara versiones antes de restaurar para entender los cambios
No dependas solo de versiones automáticas para cambios criticos
Limpia versiones antiguas que ya no necesites para mantener el historial manejable