Reglas de migración en Jitterbit App Builder

Las Reglas de Migración son un tipo de regla que se ejecuta al instalar una versión de App Builder en un servidor. Se configuran en el área SQL de Negocios de la Capa de Lógica de Negocios.

Las Reglas de Migración se utilizan para manipular o limpiar datos en una aplicación existente y también para migrar datos tras realizar un cambio de esquema. Permiten al usuario modificar una base de datos mediante las acciones Cram, Eliminar, Insertar o Actualizar. Se definen de forma similar a una regla CRUD y se ejecutan en el ambiente de desarrollo. A diferencia de las reglas CRUD, las reglas de migración se añaden a los pasos de gestió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 de una ejecución. Si necesita ejecutar reglas de migración similares dos veces, se recomienda crear una nueva regla para la segunda ejecución. Al ejecutar una regla de migración (es decir, al hacer clic en el botón Ejecutar), App Builder toma una instantánea de la regla y la integra en el conjunto de cambios. No se añadirá nada al conjunto de cambios hasta que se haya ejecutado la regla de migración. Después de ejecutar la regla, 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.
Las reglas de migración no admiten XP CRUD.
No se pueden migrar datos a/desde columnas cifradas mediante una regla de migración. Los desarrolladores deben usar reglas de negocio CRUD para mover datos a/desde columnas cifradas.
Actualmente no se puede modificar una regla CRUD para convertirla en una regla de migración. Si lo hace, no se ejecutará.

Acciones de la regla de migración

La Acción seleccionada para una regla de migración se basa en su función. Las opciones de acción son:

Insertar: inserta registros únicos/distintos según los campos marcados como claves primarias
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 saturar los datos

Vaya a App Workbench > Reglas
Confirme que la fuente de datos de la aplicación seleccionada sea donde desea agregar la regla
Haga clic en + Regla
Asigne un Nombre a la regla de migración. Por ejemplo: EventDate (Migración de EventDate)
Seleccione Migración como Propósito
Establezca la acción en Cram
Establezca el Destino en la tabla que se actualizará. Por ejemplo: EventDate
Haga clic en Guardar
Haga clic en + Tablas e incorpore la tabla de destino. Por ejemplo: EventDate
En el panel Columnas, agregue la clave principal, la expresión que describe lo que se está actualizando y el destino, que es la columna de destino de la expresión.
Dependiendo de la regla, es posible que necesite definir lógica adicional
Haga clic en Validar y compruebe que la información sea la esperada (sin errores)

Crear una regla de migración para eliminar datos

Vaya a App Workbench > Reglas
Confirme que la fuente de datos de la aplicación seleccionada sea donde desea agregar la regla
Haga clic en + Regla
Asigne un Nombre a la regla de migración. Por ejemplo: Contacto (Eliminar contactos huérfanos)
Seleccione Migración como Propósito
Establezca la acción en Eliminar
Establezca el Destino en la tabla que se actualizará. Por ejemplo: Contacto
Haga clic en Guardar
Haga clic en + Tabla y seleccione la tabla de destino
En el panel Columnas, agregue la clave principal, la expresión que describe lo que se está actualizando y el destino, que es la columna de destino de 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 el contenido de la tabla.
Haga clic en Validar y compruebe 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 de la tabla donde se crea la nueva columna deben asignarse desde la tabla de origen.

Vaya a App Workbench > Reglas
Confirme que la fuente de datos de la aplicación seleccionada sea donde desea agregar la regla
Haga clic en + Regla
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 Destino
En el panel Columnas, introduzca 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 compruebe que la información sea la esperada (sin errores)

Crear una regla de migración para actualizar los datos

Vaya a App Workbench > Reglas
Confirme que la fuente de datos de la aplicación seleccionada sea donde desea agregar la regla
Haga clic en + Regla
Asigne un Nombre a la regla de migración. Por ejemplo: Reach (Migración de AuditID)
Seleccione Migración como Propósito
Establezca la acción en Actualizar
Establezca el Objetivo en la tabla que se actualizará. Por ejemplo: Reach
Haga clic en Guardar
Haga clic en + Tabla y seleccione la tabla Objetivo
En el panel Columnas, agregue la clave principal, la expresión que describe lo que se está actualizando y el Objetivo, que es la columna de destino de la expresión
Haga clic en Validar y compruebe que la información sea la esperada (sin errores)
Haga clic en Validar y compruebe que la información sea la esperada (sin errores)