Open Office Hours Temporada 1: Sesión 6 – Marcas de tiempo y RTI

Campos datetime frente a marcas de tiempo: ¿cuál es la diferencia?

La expresión "marca de tiempo" se usa con bastante ligereza, así que conviene ser precisos. Hay dos tipos distintos de campos que puedes usar para seguir los cambios en Rapidi.

Los campos datetime son legibles para las personas. Muestran una fecha y una hora concretas, por ejemplo, cuándo se creó o se actualizó por última vez un registro. Cualquier usuario puede mirar un campo datetime y entender enseguida lo que significa.

Los campos de versión de fila son diferentes. Son números enteros generados por el sistema que registran cada registro nuevo o actualizado como un número de secuencia. Los encontrarás en sistemas más antiguos como Microsoft Dynamics. El número en sí no tiene ningún significado de fecha. No puedes convertirlo en una fecha y una hora. Solo te indica que existe un registro nuevo o que algo ha cambiado.

Ambos tipos pueden funcionar como Source Control en Rapidi, pero el formato que verás almacenado en la RTI dependerá de cuál estés usando.

Antes de nada: indexa el campo

Sea cual sea el campo que pienses usar como Source Control, debe estar indexado en tu sistema de origen. No es opcional. Cuando Rapidi ejecuta una transferencia, consulta tu sistema de origen basándose en ese campo. Si el campo no está indexado, el rendimiento se resiente y le añades una carga innecesaria al sistema.

En algunos sistemas, como Microsoft Business Central, el campo también tiene que publicarse e implementarse antes de poder consultarlo. El campo de marca de tiempo del sistema existe en Business Central, pero no está disponible en la página de forma predeterminada. Los usuarios finales no pueden verlo, y Rapidi no puede acceder a él hasta que se publique. Una vez implementado en tu entorno de producción, el campo queda disponible para filtrar y puedes usarlo como Source Control.

¿Qué es la RTI?

RTI significa Runtime Information. Piensa en ella como el libro de referencia interno de Rapidi para tus transferencias. Cada vez que una transferencia se ejecuta correctamente con el Source Control activado, Rapidi escribe una entrada en la RTI. Esa entrada registra el valor más alto del campo de Source Control en el momento de la ejecución.

La próxima vez que se ejecuta la transferencia, Rapidi consulta la RTI, encuentra ese valor almacenado y busca en tu sistema de origen los registros cuyo campo de Source Control sea mayor que ese valor. Así es como sabe qué ha cambiado.

Algunas cosas que debes saber sobre las entradas de la RTI:

• Una entrada de la RTI solo existe si el Source Control está activado en la transferencia.
• Si nunca has ejecutado la transferencia, no hay ninguna entrada en la RTI. Se crea en la primera ejecución correcta.
• Cada entrada de la RTI es única y se identifica mediante la combinación del código de transferencia, el sistema de origen y el sistema de destino.
• Si una transferencia falla, la RTI no avanza. Rapidi volverá a intentarlo desde el mismo punto en la siguiente ejecución, así que no se omite nada.

El valor almacenado en la RTI está en formato Unix, tanto si usas un campo datetime como una versión de fila. Si quieres convertir un valor Unix almacenado en una fecha legible, puedes usar cualquier conversor de timestamps Unix en línea.

Un ejemplo práctico

Así es como se ve en la práctica con dos ejecuciones de una transferencia separadas por 30 minutos.

Precisamente por eso es importante el Source Control. Sin él, cada ejecución consulta la tabla completa. Con él, solo se extrae el delta.

Cómo restablecer la RTI

Hay dos situaciones en las que puede que quieras cambiar manualmente el valor de la RTI.

Resincronización completa: establece a cero el valor de Source Control en la RTI. La siguiente ejecución buscará todos los registros cuyo campo de Source Control sea mayor que cero, es decir, todos. Usa esta opción si necesitas llevar todos los datos al sistema de destino desde cero.

Volver a ejecutar desde un punto concreto: edita el campo de Source Control en la RTI y asígnale un valor concreto. La siguiente ejecución extraerá los registros a partir de ese punto. Es útil si algo salió mal y necesitas volver a transferir datos a partir de una fecha o un número de secuencia determinados.

Ambas opciones están disponibles en la página RTI de Rapidi. Puedes llegar a ella desde la navegación principal en la parte superior o directamente desde la transferencia con el icono RTI. Cualquiera de las dos vías sirve.

La única regla que debes seguir

Sin él, cada ejecución consulta toda tu tabla de origen, cada vez. Eso genera una carga innecesaria en el sistema de origen y lo ralentiza todo. Con el Source Control activado y el campo correctamente indexado, las transferencias son más rápidas y tu sistema de origen no se ve afectado.

Configúralo bien una vez y la RTI se encarga del resto automáticamente.