Migration from v1.8 to v1.9

Resumen

La versión 1.9 sigue usando Flyway para todos los cambios de esquema de base de datos introducidos en v1.8. Las instalaciones v1.8 existentes ya están bajo el control de Flyway, así que esta actualización no requiere propiedades de línea base: todas las migraciones pendientes se aplican automáticamente en el primer arranque.

El principal cambio que requiere atención durante la migración es cómo se configura el cuerpo del correo de notificación de tarea: ahora apunta a un fichero de plantilla HTML en lugar de contener el texto del mensaje directamente en okmflow.properties.

Pasos de migración para instalaciones v1.8 existentes

Descargue OKMFlow 1.9 desde https://download.openkm.com/pro/tools.
Detenga Tomcat y sustituya el archivo okmflow.war.
Revise $TOMCAT_HOME/okmflow.properties:
- Si task.notification.body o task.notification.overdue.body se habían personalizado con texto en línea, deben convertirse. A partir de v1.9, estas propiedades apuntan a un fichero de plantilla HTML en lugar de contener el texto directamente:
```
# Antes (v1.8)
task.notification.body=A workflow task has been assigned

# Después (v1.9)
task.notification.body=file:/path/to/custom-task-assignment-body.html
```
  Traslade el texto anterior a un fichero HTML en disco y haga que la propiedad apunte a él con el prefijo file:, o elimine la personalización por completo para usar la nueva plantilla incluida por defecto (un correo de notificación más agradable y mejor formateado).
- task.notification.subject sigue funcionando como antes (una cadena de texto plano/FreeMarker). Ahora está disponible una nueva propiedad equivalente, task.notification.overdue.subject, para personalizar las notificaciones de tareas atrasadas de forma independiente de las notificaciones de asignación.
- Opcionalmente, active los nuevos trabajos de purga para evitar que la base de datos crezca indefinidamente. Todos están desactivados por defecto, así que no es necesaria ninguna acción para conservar el comportamiento actual de v1.8:
```
# Elimina las instancias de proceso finalizadas (y sus tareas, variables
# y logs) más antiguas que el periodo de retención
process.instance.purge.enabled=false
process.instance.purge.cron=0 0 3 * * *
process.instance.purge.retention.days=90

# Elimina filas del log de auditoría de instancias de proceso más
# antiguas que el periodo de retención
process.instance.log.purge.enabled=false
process.instance.log.purge.cron=0 0 2 * * *
process.instance.log.purge.retention.days=90

# Elimina filas del log de auditoría de variables más antiguas que el
# periodo de retención
variable.log.purge.enabled=false
variable.log.purge.cron=0 0 2 * * *
variable.log.purge.retention.days=90
```
Inicie Tomcat. Flyway aplica automáticamente todas las migraciones posteriores a v1.8, incluida la nueva tabla de registro de actividad para los cambios de variables de flujo de trabajo y los índices añadidos para mejorar el rendimiento en instalaciones grandes.

Instalaciones nuevas

Las instalaciones nuevas no requieren ningún paso de migración manual. Flyway detecta una base de datos vacía y aplica todas las migraciones en orden.