Saltar al contenido principal
Versión: v20 R4

Uso del sello global

Generalidades​

4D gestiona automáticamente un sello de modificación global interno, útil para manejar implementaciones de seguimiento de cambios de datos, por ejemplo para monitorear la actividad, realizar copias de seguridad, ejecutar sincronizaciones incrementales, etc.

El sello de modificación global es un número, siempre mantenido por 4D, incluso en caso de restauración de la base de datos, importación, etc. Sin embargo, tenga en cuenta que el sello puede modificarse utilizando la función .setGlobalStamp().

Una vez configurado y habilitado el seguimiento de cambios de datos, las siguientes acciones son ejecutadas automáticamente por 4D en cada modificación de registro (añadir, modificar, borrar):

  1. El valor actual del sello de modificación global se guarda en el atributo especial "GlobalStamp" de la entidad implicada. En caso de eliminación, una nueva entidad también se añade a la tabla `DeletedRecords` con información sobre la entidad eliminada y el valor actual del sello de modificación global se guarda en el atributo "__Stamp".

  2. Se incrementa el valor del sello de modificación global.

Este mecanismo permite identificar las entidades que han sido modificadas, añadidas o suprimidas desde un momento dado, y aplicar las medidas oportunas (ver el ejemplo).

info

No confunda el sello de modificación global con el sello de entidad interna, utilizado para la funcionalidad bloqueo optimista.

Configuración del seguimiento de cambios en los datos​

Por defecto, el sello de modificación global no se crea (la función .getGlobalStamp() devuelve 0. Para habilitar el seguimiento de cambios en los datos, debe añadir campos especiales y una tabla a su estructura. Puede utilizar el menú contextual del Editor de estructura para crear automáticamente todos los elementos necesarios.

Requisitos de estructura​

Para habilitar el seguimiento de cambios de datos, la estructura de la aplicación debe contener al menos una tabla con un campo __GlobalStamp.

Además, para garantizar el correcto funcionamiento de la funcionalidad, se requieren las siguientes condiciones:

  • El campo __GlobalStamp debe ser del tipo Entero 64 bits, con las propiedades índice automático, Exponer como recurso REST e Invisible seleccionadas.
  • Debe añadirse una tabla __DeletedRecords, con los siguientes campos:
CampoTipoDescripción
__PrimaryKeyTextLlave primaria de la entidad eliminada
__StampEntero 64 bitsSello global justo antes de la eliminación
__TableNameTextNombre de la tabla de entidades eliminada
__TableNumberEntero largoNúmero de la tabla de entidades eliminada

Sólo puede realizar un seguimiento de los cambios de los datos de las tablas que tengan el campo __GlobalStamp.

nota

En el lenguaje 4D, el valor del campo __GlobalStamp debe manejarse a través de una variable de tipo Real.

Uso del Editor de estructuras​

El editor de estructura 4D le permite activar o desactivar el seguimiento de cambios de datos mediante un único elemento de menú.

Para activar el seguimiento de cambios en los datos:

  1. Seleccione la(s) tabla(s) para las cuales desea habilitar el seguimiento de cambios de datos.
  2. Haga clic derecho en una tabla seleccionada y seleccione Enable data change tracking en el menú contextual.
  3. Aparece una caja de diálogo de confirmación. Haga clic en OK.

4D realiza entonces los siguientes cambios:

  • Se añade un campo preconfigurado __GlobalStamp a la(s) tabla(s).
  • Si no existe ya, se añade a la estructura una tabla __DeletedRecords.

Para desactivar el seguimiento de cambios de datos:

  1. Seleccione la tabla o tablas para las que desea eliminar el seguimiento de cambios de datos.
  2. Haga clic derecho en una tabla seleccionada y seleccione Disable data change tracking en el menú contextual.
  3. Aparece una caja de diálogo de confirmación. Haga clic en OK.

4D elimina entonces el campo __GlobalStamp de la(s) tabla(s). Tenga en cuenta que si desea eliminar la tabla __DeletedRecords, deberá hacerlo manualmente.

Ejemplo​


$tableName:="Employee" $oldStamp:=... //cargar el valor del sello anterior  
///desde el cual desea comparar el sello actual

If ($oldStamp # ds.getGlobalStamp()) //get all new or modified entities $modifiedEmps:=ds[$tableName].query("__GlobalStamp > :1"; $oldStamp) //get all deleted entities     $deletedEmpsInfo:=ds.__DeletedRecords.query("__Stamp > :1 and __TableName = :2";\
    $oldStamp; $tableName) End if