Saltar al contenido

Zonas horarias en Jitterbit App Builder

Descripción general

App Builder admite mostrar campos de DateTime en la zona horaria local del usuario. La configuración de Zona Horaria en App Builder para una fuente de datos debe coincidir con la zona horaria de la fuente de datos. Por lo general, esto se establece igual que la zona horaria de la máquina misma. En cualquier caso, la zona horaria configurada para una fuente de datos debe coincidir con la zona horaria esperada que se devuelve al ejecutar una declaración Now() en la base de datos.

Advertencia

Se recomienda que el servidor de aplicaciones de App Builder y los servidores de bases de datos estén configurados con la misma zona horaria. Estos servidores deben estar sincronizados. Las versiones futuras de App Builder pueden negarse a ejecutarse si los relojes entre el servidor de aplicaciones y el servidor de bases de datos no están sincronizados.

Configuración

Hay dos ubicaciones donde se puede configurar una Zona Horaria:

  1. Servidor de Fuente de Datos
  2. Fuente de Datos

La configuración de Zona Horaria utiliza zonas horarias de IANA (por ejemplo, America/New_York).

Servidor de fuente de datos

Al configurar una Zona Horaria en un Servidor de Fuente de Datos, todas las Fuentes de Datos nuevas creadas en este servidor se configurarán con la misma Zona Horaria. Las Fuentes de Datos existentes no se ven afectadas.

Pasos de configuración

  • Navegar a IDE > Servidores de Datos
  • Localizar su Servidor de Datos y hacer clic en el botón de Detalles correspondiente
  • Ir a Más > Caso Especial
  • Hacer clic en Editar
  • Configurar la Zona Horaria Predeterminada de la Fuente de Datos
  • Hacer clic en Guardar

Fuente de datos

Al configurar una Zona Horaria en una Fuente de Datos, todos los campos de DateTime se mostrarán de acuerdo con la zona horaria local del usuario.

Pasos de configuración

  • Navegar a IDE > Servidores de Datos
  • Seleccionar el Servidor de Datos apropiado
  • Localizar la Fuente de Datos apropiada y hacer clic en el botón de Detalles correspondiente
  • Hacer clic en el botón de Configuraciones Avanzadas
  • Hacer clic en Editar
  • Seleccionar la Zona Horaria apropiada
  • Hacer clic en Guardar

Impacto

Todos los campos de DateTime se mostrarán en la zona horaria del usuario una vez que se haya establecido una zona horaria en una Fuente de Datos. Esto afectará lo siguiente:

  • Columnas DateTime de la tabla.
  • Columnas DateTime del Objeto de Negocio.
  • Columnas DateTime de la Regla (Puentes, CRUD, Validaciones, Webhooks, etc).
  • Controles de página que están vinculados a una de las columnas DateTime anteriores.
  • Pantalla de Resultados dinámica para todos los anteriores.

Para los Objetos de Negocio y Reglas, se seguirá la Zona Horaria de la Fuente de Datos objetivo.

Además, los campos DateTime de Auditoría Completa y Auditoría Lite tomarán en cuenta la Zona Horaria de la Fuente de Datos. Esto puede causar una divergencia con los datos históricos. Para manejar esto de manera más fluida, consulte la función de migración de fechas que migrará todos los datos existentes a la nueva Zona Horaria.

Determinando la zona horaria del usuario

App Builder sigue estos pasos en orden de prioridad para determinar la zona horaria del usuario:

  1. Primero, verifique si el perfil del usuario tiene una configuración de Zona Horaria. Si es así, úsela.
  2. De lo contrario, intente obtener la configuración de Zona Horaria del navegador.
  3. Por último, intente obtener la configuración de Desfase Horario del navegador.

Si ninguna de las configuraciones anteriores está disponible, la Zona Horaria del usuario se establecerá de forma predeterminada en la Zona Horaria del servidor de la aplicación App Builder.

Notas importantes

  • Establecer una Zona Horaria no afecta a ninguno de los datos existentes dentro de una Fuente de Datos. Si los datos DateTime necesitan ser ajustados de una zona horaria a otra (por ejemplo, datos de Auditoría), se debe utilizar la función de migración de fechas.
  • El ajuste de los datos DateTime a la zona horaria del usuario es un cambio puramente superficial. Las fechas que se envían a un cliente se ajustan a la Zona Horaria del usuario. Las fechas enviadas desde un cliente al servidor se ajustan de nuevo a la Zona Horaria del servidor antes de que se ejecuten las reglas de App Builder.
  • Además, los datos DateTime CRUD'ed de una Fuente de Datos a otra no serán ajustados de ninguna manera. Nuevamente, este es un cambio puramente superficial que solo impacta el DateTime visto por un cliente.
  • Tenga en cuenta que la pantalla dinámica de Resultados se verá afectada por la configuración de Zona Horaria. Esto significa que un desarrollador puede ver un DateTime diferente dentro de la pantalla de Resultados de App Builder que dentro de un visor de base de datos directo como SQL Server Management Studio.

Solución de problemas

Para solucionar problemas relacionados, consulte lo siguiente en la guía de solución de problemas del App Builder: