Reglas de Migración¶

Reglas de migración son un tipo de regla que se ejecuta cuando se instala una versión de Vinyl en un servidor. Las reglas de migración se configuran en el área Business SQL de la capa de lógica empresarial.

Las Reglas de migración se utilizan para manipular o limpiar datos en una aplicación existente y también se utilizan para migrar datos después de realizar un cambio de esquema. Las reglas de migración permiten a un usuario modificar una base de datos mediante las acciones Cram, Delete, Insert o Update. Las reglas de migración se definen de manera similar a una regla CRUD y se ejecutan en el ambiente de desarrollo. Las reglas de migración (a diferencia de las reglas CRUD) se agregan para cambiar los pasos de administración que se ejecutan en orden al enviar un LP a un nuevo ambiente. Vinyl registra la regla y la ejecuta durante una actualización.

Las reglas de migración deben ser específicas para una Ejecución. Si necesita ejecutar reglas de migración similares dos veces, la mejor práctica es crear una nueva regla para la segunda ejecución. Cuando Ejecuta una regla de migración (es decir, hace clic en el botón Ejecutar para una regla de migración), Vinyl toma una instantánea de la regla y la incrusta en el conjunto de cambios. No se agregará nada al conjunto de cambios hasta que se haya ejecutado la regla de migración. Después de ejecutar la regla, la regla de migración se puede eliminar.

Tutorial de Reglas de Migración¶

Notas Importantes Sobre las Reglas de Migración¶

• Las reglas de migración no admiten Enum
• XP CRUD no es compatible con las reglas de migración
• Los datos no se pueden migrar hacia/desde columnas cifradas mediante una regla de migración. Los desarrolladores deben utilizar reglas comerciales CRUD para mover datos hacia y desde columnas cifradas.
• Actualmente no se puede modificar una regla CRUD para convertirla en una regla de migración. Si lo haces, no disparará.

Acciones de Reglas de Migración¶

La Acción seleccionada para una regla de migración se basa en lo que la regla pretende hacer. Las opciones de acción son:

• Cram: inserta registros distintos/únicos basados en los campos marcados como claves primarias
• Eliminar: elimina columnas de una tabla
• Insertar: crea columnas dentro de una tabla
• Actualizar: actualiza las columnas dentro de una tabla

Cree una Regla de Migración para Abarrotar Datos¶

1. Vaya a App Workbench > Reglas
2. Confirme que la fuente de datos de la aplicación seleccionada es donde desea agregar la regla.
3. Haga clic en + Regla
4. Asigne un Nombre para la regla de migración. Por ejemplo: EventDate (Migración de EventDate)
5. Seleccione Migración como propósito
6. Establezca la acción en Cram
7. Establezca Objetivo en la tabla con la que se actualizará. Por ejemplo: fecha del evento
8. Haga clic en Guardar
9. Haga clic en + Tablas y abra la tabla Destino. Por ejemplo: fecha del evento
10. En el panel Columnas, agregue la clave principal, la expresión para describir lo que se está actualizando, junto con el destino, que es la columna de destino para la expresión.
11. Dependiendo de su regla, es posible que necesite definir una lógica adicional.
12. Haga clic en Validar y verifique que la información sea la esperada (sin errores)

Crear una Regla de Migración para Eliminar Datos¶

1. Vaya a App Workbench > Reglas
2. Confirme que la fuente de datos de la aplicación seleccionada es donde desea agregar la regla.
3. Haga clic en + Regla
4. Asigne un Nombre para la regla de migración. Por ejemplo: Contacto (Eliminar contactos huérfanos)
5. Seleccione Migración como propósito
6. Establezca la acción en Eliminar
7. Establezca Objetivo en la tabla con la que se actualizará. Por ejemplo: contacto
8. Haga clic en Guardar
9. Haga clic en + Tabla y abra la tabla de destino.

10. En el panel Columnas, agregue la clave principal, la expresión para describir lo que se está actualizando, junto con el destino, que es la columna de destino de la expresión.

    Importante

    La clave principal debe estar asignada a un destino para que funcionen las reglas de eliminación; de lo contrario, la regla eliminará todo lo que hay en la tabla.

11. Haga clic en Validar y verifique que la información sea la esperada (sin errores)

Crear una Regla de Migración para Insertar Datos¶

Las reglas de migración con el tipo de acción Insertar pueden crear nuevas columnas dentro de una tabla. Todos los campos obligatorios para la tabla donde se crea una nueva columna deben asignarse desde la tabla de origen.

1. Vaya a App Workbench > Reglas
2. Confirme que la fuente de datos de la aplicación seleccionada es donde desea agregar la regla.
3. Haga clic en + Regla
4. Asigne un Nombre para la regla de migración. Por ejemplo: Sesión (Insertar sesión)
5. Seleccione Migración como propósito
6. Establezca la Acción en Insertar
7. Establezca Objetivo en la tabla con la que se actualizará. Por ejemplo: sesión
8. Haga clic en Guardar
9. Haga clic en + Tabla y abra la tabla de destino.
10. En el panel Columnas ingrese la Expresión para describir lo que se está insertando, junto con el Destino, que es la columna de destino para la Expresión.
11. Haga clic en Validar y verifique que la información sea la esperada (sin errores)

Crear una Regla de Migración para Actualizar Datos¶

1. Vaya a App Workbench > Reglas
2. Confirme que la fuente de datos de la aplicación seleccionada es donde desea agregar la regla.
3. Haga clic en + Regla
4. Asigne un Nombre para la regla de migración. Por ejemplo: alcance (migración de AuditID)
5. Seleccione Migración como propósito
6. Establezca la acción en Actualizar
7. Establezca Objetivo en la tabla con la que se actualizará. Por ejemplo: alcanzar
8. Haga clic en Guardar
9. Haga clic en + Tabla y abra la tabla de destino.
10. En el panel Columnas, agregue la clave principal, la expresión para describir lo que se está actualizando, junto con el destino, que es la columna de destino para la expresión.
11. Haga clic en Validar y verifique que la información sea la esperada (sin errores)