Ir para o conteúdo

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:

  1. 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 é comparado a uma cultura do App Builder.

  2. A cultura pode ser definida explicitamente na conta do usuário do App Builder. Isso pode ser feito por um administrador ou pelos próprios usuários, se o autoatendimento estiver habilitado.

  3. O agente do usuário pode definir a cultura anexando $culture={language-tag} à string de consulta da URL.

  4. Se a cultura não puder ser determinada de outra forma, a cultura padrão do sistema é utilizada. Veja Definir a cultura padrão.

Cultura e trabalhos em segundo plano

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

  • 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 agendado 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

  1. Abra o menu Action Drawer .

  2. Clique em Ver Perfil do Usuário. Um diálogo se abre.

  3. O diálogo mostra campos onde você pode editar as configurações de localização e fuso horário:

    localization.png

    Nota

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

Definir a cultura padrão

Por padrão, o App Builder usa en-US como a cultura do sistema. A partir do App Builder 4.61, os administradores podem alterar isso para qualquer cultura suportada.

Nota

A cultura padrão se aplica apenas quando a cultura de um usuário não pode ser determinada por nenhum outro método. Ela não substitui as culturas definidas em contas de usuários individuais ou via a string de consulta da URL.

Para definir a cultura padrão do sistema:

  1. Faça login no App Builder como administrador.

  2. Navegue até IDE > Configurações Adicionais.

  3. No painel Gerenciar, clique em Parâmetros. Um diálogo se abre.

  4. Clique em Mais > Substituição Global de Data/Hora. Outro diálogo se abre.

  5. Insira um rótulo de idioma IETF no campo Cultura Padrão (por exemplo, pt-BR ou de-DE).

    default culture

Substituir formato de data e hora

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

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

Nota

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

Format strings

Os formatos de data e hora em todo o sistema utilizam .NET format strings, o mesmo padrão usado 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 retorna ao formato definido pela cultura do usuário.

Nota

O controle Date utiliza a biblioteca bootstrap-datetimepicker, que espera uma sintaxe de formato de string 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.

Configuration steps

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

  1. Faça login no App Builder como administrador.

  2. Navegue até IDE > Configurações Adicionais.

  3. No painel Gerenciar, clique em Parâmetros. Um diálogo se abre.

  4. Clique em Mais > Substituição Global de Data/Hora. Outro diálogo se abre.

  5. 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 entre todos os usuários, substituindo a solução anterior de modificar o banco de dados diretamente.

Known issues and limitations

Accept-Language quality values

O cabeçalho Accept-Language permite que agentes de usuário ponderem as 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 utiliza a primeira tag de idioma.

Calendários

O App Builder suporta apenas o calendário gregoriano.