[Somente no local/híbrido]{class="badge yellow" title="Aplica-se somente a implantações locais e híbridas"}

Gerenciamento de fuso horário time-zone-management

Princípio operacional operating-principle

O Adobe Campaign permite expressar datas em função de seu fuso horário: isso permite que usuários internacionais trabalhem em vários fusos horários do mundo inteiro. Cada país que usa a mesma instância pode gerenciar a execução de campanhas, rastreamento, arquivamento etc. dependendo da hora local.

Para permitir o uso da plataforma Adobe Campaign em escala internacional, todas as datas usadas pelos sistemas devem ser vinculáveis a um fuso horário. Uma data cujo fuso horário é conhecido pode, portanto, ser importada para qualquer outro fuso horário, ou independentemente do fuso horário.

O Adobe Campaign permite armazenar datas/horas no formato UTC (Tempo universal coordenado). Quando os dados são expostos, eles são convertidos na data/hora local do operador. A conversão é executada automaticamente quando o banco de dados é configurado em UTC (consulte Configuração). Se o banco de dados não estiver configurado em UTC, as informações sobre o fuso horário das datas na plataforma serão armazenadas em uma opção.

As principais funcionalidades da plataforma relacionadas ao gerenciamento de fuso horário são: dados de importação/exportação e gerenciamento de operador e fluxo de trabalho. O conceito de herança está disponível para importações/exportações ou Fluxos de trabalho. Por padrão, eles são configurados para o fuso horário do servidor de banco de dados, no entanto, você pode redefinir novos fusos horários para um fluxo de trabalho e até mesmo para uma única atividade.

Os operadores podem modificar fusos horários durante a configuração de entrega e podem especificar o fuso horário específico no qual a entrega será executada.

IMPORTANT
Se o banco de dados não gerenciar vários fusos horários, para todas as manipulações de filtragem de dados, as consultas SQL deverão ser executadas no fuso horário do servidor de banco de dados.

Cada operador do Adobe Campaign está vinculado a um fuso horário: essas informações são configuradas em seu perfil. Para obter mais informações, consulte este documento.

Quando a plataforma do Adobe Campaign não requer o gerenciamento de fuso horário, você pode manter um modo de armazenamento no formato local com um fuso horário vinculado específico.

Recomendações recommendations

Os fusos horários combinam várias realidades: a expressão pode descrever um intervalo de tempo constante com a data UTC, ou os horários de uma região que pode mudar os horários duas vezes por ano (horário de verão).

Por exemplo, no postgreSQL, o comando SET TIME ZONE 'Europe/Paris'; levará em conta os horários de verão e inverno: a data será expressa em UTC+1 ou UTC+2, dependendo da hora do ano.

No entanto, se você usar o comando SET TIME ZONE 0200;, o atraso será sempre UTC+2.

Configuração configuration

O modo de armazenamento para datas e horas é selecionado durante a criação do banco de dados (consulte Criando uma nova instância). No caso de uma migração, as horas vinculadas às datas são convertidas em datas e horas locais (consulte Migração).

Do ponto de vista técnico, há duas maneiras de armazenar informações do tipo Data+hora no banco de dados:

  1. Formato TIMESTAMP WITH TIMEZONE: o mecanismo de banco de dados armazena datas em UTC. Cada sessão aberta terá um fuso horário e as datas serão convertidas de acordo com ele.
  2. Formato local + fuso horário local: todas as datas são armazenadas no formato local (sem gerenciamento de atraso de tempo) e um único fuso horário é atribuído a elas. O fuso horário é armazenado na opção WdbcTimeZone da instância do Adobe Campaign e pode ser alterado por meio do menu Administration > Platform > Options da árvore.
IMPORTANT
Esteja ciente de que essa modificação pode resultar em problemas de sincronização e consistência de dados.

Criação de uma nova instância creating-a-new-instance

Para que vários usuários internacionais trabalhem na mesma instância, é necessário configurar fusos horários ao criar a instância para gerenciar intervalos de tempo entre países. Durante a criação da instância, selecione o modo de gerenciamento de data e hora na seção Time zone do estágio de configuração do banco de dados.

Marque a opção UTC database (date fields with time zone) para armazenar todos os dados com datas e horas no formato UTC (campos SQL e campos XML).

IMPORTANT
Se você estiver usando o Oracle, os arquivos de fuso horário (.dat) das camadas de cliente do Oracle deverão ser compatíveis com os arquivos de fusos horários instalados no servidor.

Se o banco de dados não for UTC, você poderá selecionar um dos fusos horários oferecidos na lista suspensa. Você também pode usar o fuso horário do servidor ou selecionar a opção UTC (Tempo universal coordenado).

Quando a opção UTC Database (date fields with time zone) é selecionada, os campos SQL são armazenados no formato TIMESTAMP WITH TIMEZONE.

Caso contrário, eles serão armazenados no formato local e será necessário selecionar o fuso horário a ser aplicado ao banco de dados.

Migração migration

Ao migrar para uma versão anterior (sem gerenciamento de fuso horário), será necessário definir o modo de armazenamento de data no banco de dados.

Para garantir a compatibilidade com ferramentas externas que acessam o banco de dados do Adobe Campaign, os campos SQL do tipo Data+hora permanecem armazenados no formato local por padrão.

Os campos XML que contêm datas agora estão armazenados em UTC. Durante o carregamento, os campos que não estão no formato UTC são convertidos automaticamente usando o fuso horário dos servidores. Isso significa que todos os campos XML serão progressivamente convertidos no formato UTC.

Para usar uma instância existente, adicione a opção WdbcTimeZone e insira o fuso horário da instância.

IMPORTANT
Verifique se o valor correto está configurado para a opção WdbcTimeZone: as alterações feitas posteriormente podem levar a inconsistências.

Exemplo de valores possíveis:

Fuso horário do servidor e do banco de dados do Oracle

Para o banco de dados principal, o Campaign usa o fuso horário do servidor para definir o fuso horário da sessão na conexão de banco de dados. A opção "WdbcTimeZone" não tem impacto. Portanto, o fuso horário do servidor deve corresponder ao fuso horário do banco de dados principal usado pelo Campaign. Se não for possível alterar o fuso horário do servidor, o fuso horário usado pelo Campaign poderá ser substituído pela configuração da variável de ambiente TZ em customer.sh.

recommendation-more-help
601d79c3-e613-4db3-889a-ae959cd9e3e1