Manipulando Tipos de Dados de Data/Hora e Fuso Horário

No formulário do Lotus Domino, um campo de tipo Data/Hora pode ser configurado para representar somente um valor de data, valor de hora ou ambos os valores de data e hora. Esta configuração é feita ao criar/editar o formulário no Domino Designer. Assim, quando um documento é criado para tal formulário, o valor pode ser uma data, hora ou data/hora.

Por exemplo, se um formulário que representa um Calendário possui os seguintes campos:
Tabela 1. Exemplo
Campos Tipo de Dados Domino
startDate Data/Hora (representa somente a data)
startTime Data/Hora (representa somente a hora)
endDate Data/Hora (representa somente a data)
endTime Data/Hora (representa somente a hora)
bothDateAndTime Data/Hora (representa ambos data e hora)
timeZone Fuso horário
Assunto Texto
Corpo Texto

Se um documento válido for criado para este formulário, então:
  • startDate e endDate aceitarão somente um valor de data
  • startTime e endTime aceitarão somente um valor de hora
  • bothDateAndTime aceitarão somente data e hora
  • timeZone aceitará somente um valor de fuso horário
Do Cast Iron versão 6.1.0.9 em diante, o tipo de dados Data/Hora é manipulado conforme descrito nos seguintes pontos:
  1. Um tipo de campo do Domino Data/Hora é representado como xsd:string na entrada e na saída do mapa da atividade.
  2. A única sintaxe suportada dos valores de entrada para os campos Data/Hora na entrada do mapa é:
    1. Se o campo representar somente data: MM/dd/aaaa. Exemplo : 27/05/2012.
    2. Se o campo representar somente a hora (formato 24 horas): HH:mm:ss. Exemplo: 22:15:30.
    3. Se o campo representar ambos a data e hora (formato 24 horas): MM/dd/aaaa HH:mm:ss. Exemplo: 31/05/2012 23:59:59.
  3. A saída a partir da atividade segue também a mesma sintaxe dos campos Data/Hora, na maioria dos casos.
  4. A sintaxe precedente é usada pela entrada e saída de mapa independentemente de:
    1. O formato da data e hora do sistema operacional em que o servidor Domino está sendo executado.
    2. As definições do formato de data e hora configuradas ao criar o formulário no Domino Designer.
  5. O valor do fuso horário também é representado como xsd:string na entrada e saída do mapa. A nota técnica a seguir do Lotus Domino fornece mais informações sobre a sintaxe: http://www-01.ibm.com/support/docview.wss?uid=swg21163045. Para obter mais informações sobre Fuso Horário no Lotus Domino, consulte a documentação do Lotus Domino.
Nota:
  1. Na versão do Cast Iron 6.1.0.6 e nas versões anteriores, o campo Data/Hora do Domino foi gerado como xsd:date, que não foi capaz de manipular todas as combinações dos valores da entrada.
  2. Projetos antigos foram desenvolvidos utilizando a versão 6.1.0.6 ou versões anteriores que já estão sendo executadas, funcionarão bem com o mesmo comportamento antigo, isto é, Data/Hora representada como xsd:date).
  3. Para todas as orquestrações criadas recentemente utilizando a versão 6.1.0.9 e versões posteriores, o campo Data/Hora será gerado como xsd:string.
  4. Se projetos antigos precisarem do novo comportamento, isto é, para gerar Data/Hora como xsd:string, então os objetos precisarão ser atualizados a partir do painel Configurar da atividade na versão do Studio 6.1.0.9 ou em versões posteriores. O mapeamento deve ser validado após esta mudança.