Versiones

El modelo de borrador frente a en vivo

Cada entorno tiene dos cosas ocurriendo a la vez: un borrador de trabajo (el aspecto actual de tus conexiones, funciones, botones de la cinta y panel de tareas en el panel) y una versión en vivo (una instantánea guardada que es la que realmente se sirve a Excel).

• Editar siempre es un borrador. Añadir una función, cambiar una conexión, ajustar el panel de tareas — nada de eso crea una versión, y nada de eso llega a Excel por sí solo.
• Una versión solo se crea deliberadamente — con Save version o con Promote. No existe una versión automática de "edición"; por eso una función recién creada sigue sin devolver nada hasta que publicas.
• En vivo es un puntero, no una copia del borrador. El entorno apunta a una versión guardada; el agent sirve exactamente la instantánea de esa versión. Un entorno sin ninguna versión en vivo todavía no sirve nada — su agent muestra cero funciones.

Guardar una versión

Desde la página Versions del entorno, Save version guarda una instantánea del borrador de trabajo actual con el nombre que elijas. Su modal tiene un interruptor:

• Make this version live (activado por defecto) — publica la instantánea de inmediato; el agent empieza a servirla.
• Desactivado — guarda un punto de control sin cambiar lo que está en vivo ahora mismo. Útil para capturar un hito a mitad de una edición sin publicarlo todavía.

Poner en vivo (Make live)

Cualquier versión guardada en el historial puede volver a ponerse en vivo con un clic — una acción Make live que simplemente mueve el puntero en vivo a esa versión. No toca tu borrador de trabajo ni crea una versión nueva; es un interruptor puro de publicar/revertir. Úsala para volver a una versión que sabes que funciona tras una mala publicación, o para volver a promover una versión antigua sin repetir Promote.

Comparar (Compare)

La acción Compare (o marcar dos filas en el historial) abre un diff a página completa entre dos versiones cualesquiera. Los dos selectores son:

• From — cualquier versión guardada.
• To — cualquier versión guardada, o una opción especial Current state (con la insignia Draft) que trae tu borrador de trabajo real y sin versionar directamente de las tablas en vivo del entorno.

Comparar una versión guardada contra Current state es cómo ves exactamente qué cambiaría al publicar antes de hacerlo — la misma comprobación que impulsa el banner de "cambios sin publicar" en la página Versions. Para comparar contra la versión en vivo del entorno específicamente (no el borrador), elígela de la lista de versiones — la fila que el historial marca Live.

El diff clasifica cada elemento cambiado como añadido, eliminado o modificado, y para los elementos modificados muestra exactamente qué campos cambiaron — incluida una marca para los cambios que solo tocan los campos de valor de una conexión (host, URL, referencia de secreto) en lugar de su estructura.

Restaurar (Restore)

Restore es la alternativa más antigua y más contundente a Make live: sobrescribe el borrador de trabajo del entorno con el contenido de una versión guardada y registra una entrada restore. Las filas de versión del panel usan Make live para las reversiones del día a día (sin sobrescritura, sin advertencia destructiva); Restore sigue disponible como acción de poder cuando específicamente quieres que se reemplace el propio borrador.

Promover entre entornos

Promote trae la estructura de un entorno de origen a un entorno destino y la publica ahí en un solo paso — así es como los cambios estructurales (una función nueva, la forma cambiada de una conexión) llegan a QA, Staging o Production. Promote:

• Copia la estructura del entorno de origen (Development).
• Nunca toca los valores propios del destino — sus credenciales, host del agent y ajustes de caché quedan exactamente como están configurados para ese entorno.
• Registra una entrada promote en el historial de versiones del destino, con un título como "Promote from Development" y las insignias de diff correspondientes.

Leer el historial

El historial de versiones lista todas las versiones de más reciente a más antigua, cada fila mostrando:

• Un icono de tipo — Saved (un Save version manual), Promote, o Restore.
• El título de la versión (lo que le hayas puesto de nombre, o un valor por defecto derivado del tipo).
• Una insignia azul Live y un resaltado en la versión que se está sirviendo actualmente.
• El entorno de origen, quién hizo el cambio, y cuándo.
• Insignias de diff que resumen qué cambió respecto a la versión anterior.

Por fila puedes hacer Make live, Compare (contra otra fila), o Delete (borrado suave; la versión en vivo no se puede eliminar). Un banner ámbar en la parte superior de la página te dice cuando el borrador de trabajo tiene cambios sin publicar esperando un Save version.