Normas de Migración

Las Reglas de migración son un tipo de regla que se ejecuta cuando se lanza una versión App Builder se instala en un servidor. Las reglas de migración se configuran en el área SQL empresarial 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 a los pasos de administración de cambios que se ejecutan en orden al enviar un LP a un nuevo ambiente. App Builder 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), App Builder toma una instantánea de la regla y la incorpora al 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, se puede eliminar la regla de migración.

Tutorial de Reglas de Migración

Notas Importantes Sobre las Reglas de Migración

Las reglas de migración no admiten Enum
Las reglas de migración no admiten CRUD XP
Los datos no se pueden migrar hacia o desde columnas cifradas mediante una regla de migración. Los desarrolladores deben usar reglas de negocios CRUD para mover datos hacia o desde columnas cifradas.
Actualmente, no se puede modificar una regla CRUD para convertirla en una regla de migración. Si lo hace, no se activará.

Acciones de la Regla 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 según los campos marcados como claves principales
Eliminar: elimina columnas de una tabla
Insertar: crea columnas dentro de una tabla
Actualizar: actualiza columnas dentro de una tabla

Crear una Regla de Migración para Comprimir Datos

Vaya a App Workbench > Rules
Confirme que la fuente de datos de la aplicación seleccionada es donde desea agregar la regla
Haga clic en + Rule
Asigne un Name para la regla de migración. Por ejemplo: EventDate (EventDate Migration)
Seleccione Migration como Purpose
Establezca la acción en Cram
Establezca el Target en la tabla que se actualizará. Por ejemplo: EventDate
Haga clic en Save
Haga clic en + Tables y traiga la tabla Target. Por ejemplo: EventDate
En el panel Columns agregue la clave principal, la expresión para describir lo que se está actualizando, junto con el Target, que es la columna de destino para la expresión
Según su regla, es posible que necesite definir lógica adicional
Haga clic en Validate y verifique que la información sea la esperada (sin errores)

Crear una Regla de Migración para Eliminar Datos

Vaya a App Workbench > Rules
Confirme que la fuente de datos de la aplicación seleccionada es donde desea agregar la regla
Haga clic en + Rule
Asigne un Name para la regla de migración. Por ejemplo: Contacto (Eliminar contactos huérfanos)
Seleccione Migration como Purpose
Establezca la acción en Delete
Establezca el Target en la tabla que se actualizará. Por ejemplo: Contacto
Haga clic en Save
Haga clic en + Table y traiga la tabla Target
En el panel Columns, agregue la clave principal, la expresión para describir lo que se está actualizando, junto con el Target, que es la columna de destino para la expresión.

Importante

La clave principal debe estar asignada a un destino para que las reglas de eliminación funcionen; de lo contrario, la regla eliminará todo lo que haya en la tabla.
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 en la que se crea una nueva columna deben asignarse desde la tabla de origen.

Vaya a App Workbench > Rules
Confirme que la fuente de datos de la aplicación seleccionada es donde desea agregar la regla
Haga clic en + Rule
Asigne un Nombre a la regla de migración. Por ejemplo: Sesión (Insertar sesión)
Seleccione Migración como Propósito
Establezca la acción en Insertar
Establezca el Destino en la tabla que se actualizará. Por ejemplo: Sesión
Haga clic en Guardar
Haga clic en + Tabla y traiga la tabla de destino
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
Haga clic en Validar y verifique que la información sea la esperada (sin errores)

Crear una Regla de Migración para Actualizar los Datos

Vaya a App Workbench > Rules
Confirme que la fuente de datos de la aplicación seleccionada es donde desea agregar la regla
Haga clic en + Rule
Asigne un Name a la regla de migración. Por ejemplo: Reach (AuditID Migration)
Seleccione Migration como Purpose
Establezca la acción en Update
Establezca el Target en la tabla que se actualizará. Por ejemplo: Reach
Haga clic en Save
Haga clic en + Table y traiga la tabla Target
En el panel Columns agregue la clave principal, la expresión para describir lo que se está actualizando, junto con el Target, que es la columna de destino para la expresión
Haga clic en Validate y verifique que la información sea la esperada (sin errores)