Internacionalização e localização no Jitterbit App Builder

O App Builder suporta internacionalização e localização. Especificamente, o App Builder pode renderizar datas e valores numéricos em um formato específico da região. Por exemplo, o App Builder pode renderizar a data 2023-05-16 como 5/16/2023 para um usuário em um local de inglês dos EUA (en-US) ou 16.05.2023 para um usuário em um local alemão (de-DE).

Cultura

O suporte à localização do App Builder é baseado no conceito de cultura do Microsoft .NET. Uma cultura fornece regras de formatação de data e numérica para uma região específica. As culturas são mapeadas para etiquetas de idioma IETF.

Como a cultura do usuário é determinada?

O App Builder pode determinar a cultura preferida do usuário de uma das seguintes maneiras:

O App Builder tentará determinar a cultura do usuário automaticamente. O App Builder analisará o cabeçalho Accept-Language fornecido pelo navegador. O valor é correspondido a uma cultura do App Builder.
A cultura pode ser definida explicitamente na conta de usuário do App Builder. Isso pode ser feito por um administrador ou pelos próprios usuários, se o autoatendimento estiver habilitado.
O agente do usuário pode definir a cultura anexando $culture={language-tag} à string de consulta da URL.
Se a cultura não puder ser determinada de outra forma, a cultura padrão do sistema é utilizada.

Cultura e trabalhos em segundo plano

Ao executar trabalhos em segundo plano, a cultura efetiva depende de como o trabalho é enfileirado.

Se o trabalho for agendado por um usuário (ou seja, clicando em um botão), a cultura preferida do usuário é utilizada.
Se o trabalho for enfileirado por um cronograma, então a cultura da conta de usuário do serviço é utilizada.

Extensibilidade

As culturas são definidas pelo ambiente de execução. Os desenvolvedores não podem registrar novas culturas. No entanto, os desenvolvedores podem recuperar uma lista de culturas existentes consultando o objeto de dados público Culture.

Como revisar e editar idioma, localidade e fusos horários

Abra o menu Action Drawer .
Clique em Ver Perfil do Usuário. Um diálogo será aberto.
O diálogo mostra campos onde você pode editar as configurações de localização e fuso horário:

Nota

Se você estiver atualizando seu Idioma, será necessário atualizar a janela do navegador para ver as informações atualizadas.

Substituir formato de data e hora

Por padrão, o App Builder formata datas e horas de acordo com as configurações culturais de cada usuário.

A partir do App Builder 4.60, os administradores podem substituir esse comportamento configurando strings de formato em todo o sistema que se aplicam a todos os usuários, independentemente de sua cultura individual.

Nota

Strings de formato em todo o sistema têm precedência sobre formatos específicos de cultura. Quando um formato em todo o sistema é definido, todos os usuários verão datas e horas nesse formato, independentemente de sua cultura ou localidade configurada.

Strings de formato

Os formatos de data e hora em todo o sistema usam .NET format strings, o mesmo padrão utilizado por formatos específicos de cultura. As seguintes configurações estão disponíveis:

Configuração	Descrição	Valor de exemplo
`DateFormat`	Formato para valores apenas de data.	`MM/dd/yyyy`
`TimeFormat`	Formato para valores apenas de hora.	`HH:mm:ss`
`DateTimeFormat`	Formato para valores combinados de data e hora.	`MM/dd/yyyy HH:mm:ss`

Quando uma configuração é deixada em branco, o App Builder volta ao formato definido pela cultura do usuário.

Nota

O controle Date utiliza a biblioteca bootstrap-datetimepicker, que espera uma sintaxe de string de formato diferente da .NET. O App Builder mapeia automaticamente as strings de formato .NET configuradas para o formato esperado pela biblioteca. Nenhuma configuração adicional é necessária.

Etapas de configuração

Para configurar formatos de data e hora em todo o sistema:

Faça login no App Builder como administrador.
Navegue até IDE > Configurações Adicionais.
No painel Gerenciar, clique em Parâmetros. Um diálogo se abre.
Clique em Mais > Substituição Global de Data/Hora. Outro diálogo se abre.
Insira as strings de formato desejadas em Substituir Formato de Data, Substituir Formato de Hora e/ou Substituir Formato de Data e Hora.

Dica

Essas configurações são armazenadas na configuração do App Builder e sobrevivem a atualizações. Esta é a abordagem recomendada para aplicar um formato de data consistente para todos os usuários, substituindo a solução anterior de modificar o banco de dados diretamente.

Problemas conhecidos e limitações

Valores de qualidade `Accept-Language`

O cabeçalho Accept-Language permite que agentes de usuário ponderem preferências de idioma atribuindo um "valor de qualidade". O App Builder não considera o valor de qualidade. Em vez disso, o App Builder usa a primeira tag de idioma.

Calendários

O App Builder suporta apenas o calendário gregoriano.