Publicar y versionar paquetes

Publicar es subir tu automatización del Designer a Nexus, donde queda guardada como un paquete con un número de versión. Solo después de publicarla puedes crear un proceso y ejecutarla desatendida o programada.

Cada vez que publicas, se crea una nueva versión del paquete. Las versiones anteriores se conservan: nunca se sobrescriben.

Publicar desde el Designer

1. Abre tu proyecto en el Designer y verifica que funciona ejecutándolo localmente. Ver Depuración.
2. En la toolbar, haz clic en Publicar.
3. Indica la versión (ver versionado semántico) y, opcionalmente, notas de la versión.
4. Confirma. El Designer empaqueta el proyecto en un archivo .zoan y lo sube a tu tenant.

El paquete aparece en la sección Paquetes del portal, listo para asociarse a un proceso.

Qué contiene un paquete

Un paquete .zoan es un archivo comprimido con tu proyecto. En su raíz lleva un manifiesto project.json que describe el paquete:

{
  "name": "Facturación",
  "version": "1.2.0",
  "entry": "playbooks/main.json"
}

Campo	Qué es
name	Nombre del paquete
version	Versión semántica de esta publicación
entry	Playbook principal que se ejecuta primero

No necesitas editar este archivo a mano: el Designer lo genera al publicar.

Versionado semántico

Las versiones siguen el formato MAYOR.MENOR.PARCHE (semantic versioning). Cada número comunica el tipo de cambio respecto a la versión anterior:

Incrementa…	Cuándo	Ejemplo
PARCHE	Corrección de errores, sin cambiar el comportamiento	1.0.0 → 1.0.1
MENOR	Nueva funcionalidad compatible con lo anterior	1.0.0 → 1.1.0
MAYOR	Cambios que modifican el comportamiento esperado	1.0.0 → 2.0.0

Esto le dice a quien opera el proceso qué tan arriesgado es adoptar la versión: un PARCHE debería ser seguro; un MAYOR requiere validar antes.

Historial de versiones

Desde Paquetes en el portal ves todas las versiones publicadas de un paquete, con su fecha y sus notas. Esto te da trazabilidad: qué cambió, cuándo y por qué.

Buenas prácticas

• Nunca modifiques una versión ya publicada. Si encontraste un error, publica una versión nueva. Una versión publicada es inmutable: así un proceso que apunta a 1.2.0 siempre ejecuta exactamente lo mismo.
• Escribe notas de versión aunque sean breves (“corrige el cálculo de IVA”). Tu yo del futuro lo agradecerá.
• Prueba en local antes de publicar, y valida la versión en el entorno de Pruebas antes de apuntar Producción a ella.
• Sube de PARCHE/MENOR/MAYOR según el cambio real, para que el número signifique algo.

Siguientes pasos

• Crear un proceso — asociar esta versión a un entorno.
• Promover entre entornos — de Pruebas a Producción.