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. ExemploCampos |
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:
- Um tipo de campo do Domino Data/Hora é representado como xsd:string na entrada e na saída do mapa da atividade.
- A única sintaxe suportada dos valores de entrada para os campos Data/Hora na entrada do mapa é:
- Se o campo representar somente data: MM/dd/aaaa.
Exemplo : 27/05/2012.
- Se o campo representar somente a hora (formato 24 horas): HH:mm:ss.
Exemplo: 22:15:30.
- 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.
- A saída a partir da atividade segue também a mesma sintaxe dos campos Data/Hora, na maioria dos casos.
- A sintaxe precedente é usada pela entrada e saída de mapa independentemente de:
- O formato da data e hora do sistema operacional em que o servidor Domino está sendo executado.
- As definições do formato de data e hora configuradas ao criar o formulário no Domino Designer.
- 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: - 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.
- 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).
- 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.
- 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.