Internacionalización y localización en Jitterbit App Builder

App Builder soporta la internacionalización y localización. Específicamente, App Builder puede representar fechas y valores numéricos en un formato específico de la región. Por ejemplo, App Builder puede representar la fecha 2023-05-16 como 5/16/2023 para un usuario en una configuración regional de inglés de EE. UU. (en-US) o 16.05.2023 para un usuario en una configuración regional alemana (de-DE).

Cultura

El soporte de localización de App Builder se basa en el concepto de cultura de Microsoft .NET. Una cultura proporciona reglas de formato de fecha y numéricas para una región específica. Las culturas están mapeadas a etiquetas de idioma IETF.

¿Cómo se determina la cultura del usuario?

App Builder puede determinar la cultura preferida del usuario de una de las siguientes maneras:

App Builder intentará determinar la cultura del usuario automáticamente. App Builder analizará el encabezado Accept-Language proporcionado por el navegador. El valor se empareja con una cultura de App Builder.
La cultura puede ser establecida explícitamente en la cuenta de usuario de App Builder. Esto puede ser realizado por un administrador o por los propios usuarios si se ha habilitado el autoservicio.
El agente de usuario puede establecer la cultura añadiendo $culture={language-tag} a la cadena de consulta de la URL.
Si la cultura no puede ser determinada de otra manera, se utiliza la cultura del sistema por defecto.

Cultura y trabajos en segundo plano

Al ejecutar trabajos en segundo plano, la cultura efectiva depende de cómo se programa el trabajo.

Si el trabajo es programado por un usuario (es decir, al hacer clic en un botón), se utiliza la cultura preferida del usuario.
Si el trabajo es programado por un horario, entonces se utiliza la cultura de la cuenta de usuario del servicio.

Extensibilidad

Las culturas son definidas por el entorno de ejecución. Los desarrolladores no pueden registrar nuevas culturas. Sin embargo, los desarrolladores pueden recuperar una lista de culturas existentes consultando el objeto de datos público Culture.

Cómo revisar y editar el idioma, la configuración regional y las zonas horarias

Abre el menú Action Drawer .
Haz clic en Ver perfil de usuario. Se abre un diálogo.
El diálogo muestra campos donde puedes editar la configuración de localización y zona horaria:

Nota

Si estás actualizando tu Idioma, necesitarás refrescar la ventana del navegador para ver la información actualizada.

Anular el formato de fecha y hora

Por defecto, App Builder formatea fechas y horas de acuerdo con la configuración cultural de cada usuario.

A partir de App Builder 4.60, los administradores pueden anular este comportamiento configurando cadenas de formato a nivel del sistema que se aplican a todos los usuarios, independientemente de su cultura individual.

Nota

Las cadenas de formato a nivel del sistema tienen prioridad sobre los formatos específicos de cultura. Cuando se establece un formato a nivel del sistema, todos los usuarios verán las fechas y horas en ese formato, independientemente de su cultura o configuración regional configurada.

Cadenas de formato

Los formatos de fecha y hora a nivel del sistema utilizan .NET format strings, el mismo estándar utilizado por los formatos específicos de cultura. Las siguientes configuraciones están disponibles:

Configuración	Descripción	Valor de ejemplo
`DateFormat`	Formato para valores solo de fecha.	`MM/dd/yyyy`
`TimeFormat`	Formato para valores solo de hora.	`HH:mm:ss`
`DateTimeFormat`	Formato para valores combinados de fecha y hora.	`MM/dd/yyyy HH:mm:ss`

Cuando una configuración se deja vacía, App Builder vuelve al formato definido por la cultura del usuario.

Nota

El control Date utiliza la biblioteca bootstrap-datetimepicker, que espera una sintaxis de cadena de formato diferente a la de .NET. App Builder mapea automáticamente las cadenas de formato .NET configuradas al formato esperado por la biblioteca. No se requiere configuración adicional.

Pasos de configuración

Para configurar los formatos de fecha y hora a nivel del sistema:

Inicie sesión en App Builder como administrador.
Navegue a IDE > Configuración Adicional.
En el panel Administrar, haga clic en Parámetros. Se abre un diálogo.
Haga clic en Más > Anulación Global de Fecha/Hora. Se abre otro diálogo.
Ingrese las cadenas de formato deseadas en Anular Formato de Fecha, Anular Formato de Hora y/o Anular Formato de Fecha y Hora.

Consejo

Estas configuraciones se almacenan en la configuración de App Builder y sobreviven a las actualizaciones. Este es el enfoque recomendado para aplicar un formato de fecha consistente entre todos los usuarios, reemplazando la solución anterior de modificar directamente la base de datos.

Problemas y limitaciones conocidas

Valores de calidad de `Accept-Language`

El encabezado Accept-Language permite a los agentes de usuario ponderar las preferencias de idioma asignando un "valor de calidad". App Builder no toma en cuenta el valor de calidad. En su lugar, App Builder utiliza la primera etiqueta de idioma.

Calendarios

App Builder solo admite el calendario gregoriano.