Fusos horários no Jitterbit App Builder

Visão geral

O App Builder suporta a exibição de campos DateTime no fuso horário local do usuário. A configuração de Fuso Horário no App Builder para uma fonte de dados deve corresponder ao fuso horário da fonte de dados. Normalmente, isso é definido da mesma forma que o fuso horário da máquina em si. Em qualquer um dos casos, o fuso horário definido para uma fonte de dados deve corresponder ao fuso horário esperado retornado ao executar uma instrução Now() no banco de dados.

Configuração

Existem dois locais onde um Fuso Horário pode ser configurado:

1. Servidor de Fonte de Dados
2. Fonte de Dados

A configuração de Fuso Horário utiliza fusos horários IANA (por exemplo, America/New_York).

Servidor de fonte de dados

Ao configurar um Fuso Horário de Servidor de Fonte de Dados, todas as Fontes de Dados novamente criadas neste servidor serão configuradas com o mesmo Fuso Horário. As Fontes de Dados existentes não são afetadas.

Etapas de configuração

• Navegue até IDE > Servidores de Dados
• Localize seu Servidor de Dados e clique no botão Detalhes correspondente
• Vá para Mais > Caso Excepcional
• Clique em Editar
• Configure o Fuso Horário Padrão da Fonte de Dados
• Clique em Salvar

Fonte de dados

Ao configurar um Fuso Horário em uma Fonte de Dados, todos os campos DateTime serão renderizados de acordo com o fuso horário local do usuário.

Etapas de configuração

• Navegue até IDE > Servidores de Dados
• Selecione o Servidor de Dados apropriado
• Localize a Fonte de Dados apropriada e clique no botão Detalhes correspondente
• Clique no botão Configurações Avançadas
• Clique em Editar
• Selecione o Fuso Horário apropriado
• Clique em Salvar

Impacto

Todos os campos DateTime serão exibidos no fuso horário do usuário uma vez que um fuso horário tenha sido definido em uma Fonte de Dados. Isso afetará o seguinte:

• Colunas DateTime da tabela.
• Colunas DateTime do Objeto de Negócio.
• Colunas DateTime de Regras (Bridges, CRUD, Validações, Webhooks, etc).
• Controles de página que estão vinculados a uma das colunas DateTime acima.
• Tela de Resultados dinâmica para todos os itens acima.

Para Objetos de Negócio e Regras, a Time Zone Fonte de Dados alvo será seguida.

Além disso, os campos DateTime de Full Audit e Audit Lite levarão em consideração a Time Zone da Fonte de Dados. Isso pode causar uma divergência em relação aos dados históricos. Para lidar com isso de forma mais tranquila, veja o recurso de migração de data que migrará todos os dados existentes para a nova Time Zone.

Determinando a zona de tempo do usuário

O App Builder segue estas etapas em ordem de prioridade para determinar a zona de tempo do usuário:

1. Primeiro, verifique se o perfil do usuário possui uma configuração de Time Zone. Se sim, use-a.
2. Caso contrário, tente obter a configuração de Time Zone do navegador.
3. Por último, tente obter a configuração de Time Zone Offset do navegador.

Se nenhuma das configurações acima estiver disponível, a Time Zone do usuário será definida como a Time Zone do servidor da aplicação App Builder.

Notas importantes

• Definir uma Time Zone não afeta nenhum dos dados existentes dentro de uma Fonte de Dados. Se os dados DateTime precisarem ser ajustados de uma zona de tempo para outra (por exemplo, dados de auditoria), o recurso de migração de data deve ser usado em vez disso.
• O ajuste dos dados DateTime para a zona de tempo do usuário é uma mudança puramente superficial. As datas enviadas para um cliente são ajustadas para a Time Zone do usuário. As datas enviadas de um cliente para o servidor são ajustadas de volta para a Time Zone do servidor antes que quaisquer regras do App Builder sejam executadas.
• Além disso, os dados DateTime CRUD'ed de uma Fonte de Dados para outra não serão ajustados de forma alguma. Novamente, isso é uma mudança puramente superficial que impacta apenas o DateTime visto por um cliente.
• Tenha cuidado, pois a tela dinâmica de Resultados será impactada pela configuração de Time Zone. Isso significa que um desenvolvedor pode ver um DateTime diferente na tela de Resultados do App Builder em comparação com um visualizador de banco de dados direto, como o SQL Server Management Studio.

Solução de Problemas

Para solução de problemas relacionados, consulte o seguinte no guia de solução de problemas do App Builder:

• O servidor de aplicativos do App Builder e o servidor de banco de dados devem usar o mesmo fuso horário