Propriedades do Conjunto de Mensagens CWF

A tabela abaixo define as propriedades que podem ser definidas para o conjunto de mensagens. Algumas das propriedades do conjunto de mensagens (marcadas com um asterisco(*)) são relevantes apenas se a mensagem que está sendo processada não estiver utilizando WebSphere MQ como protocolo de transporte. Se o protocolo de transporte for WebSphere MQ, os valores serão derivados dos cabeçalhos de mensagem (por exemplo, MQMD) e as propriedades do conjunto de mensagens, se definidas, serão ignoradas.

Representação Binária de Valores Booleanos

Propriedade Type Significado
Boolean True Value STRING Insira até oito dígitos hexadecimais. Não inclua o indicador hexadecimal (0x) antes deste número. Cada dígito representa meio byte. O comprimento máximo é de 4 bytes. Você deve inserir um número par de dígitos (um número inteiro de bytes). Este valor deve ser diferente, mas tem o mesmo comprimento que o Valor Booleano Falso. O valor padrão é 00000001.
Boolean False Value STRING Insira até oito dígitos hexadecimais. Não inclua o indicador hexadecimal (0x) antes deste número. Cada dígito representa meio byte. O comprimento máximo é de 4 bytes. Você deve inserir um número par de dígitos (um número inteiro de bytes). Este valor deve ser diferente, mas tem o mesmo comprimento que o Valor Booleano Verdadeiro. O valor padrão é 00000000.
Boolean Null Value STRING Insira até oito dígitos hexadecimais. Não inclua o indicador hexadecimal (0x) antes deste número. Cada dígito representa meio byte. O comprimento máximo é de 4 bytes. Você deve inserir um número par de dígitos (um número inteiro de bytes). Este valor pode ser igual ao Valor Booleano Verdadeiro ou Valor Booleano Falso ou diferente. O valor padrão é 00000000.

Configurações de Saída

Estas configurações são utilizadas quando as mensagens estão sendo serializadas.

Propriedade Type Significado
Preenchimento de Alinhamento de Bytes String Se as propriedades do Custom Wire Format xsd:element Byte Alignment, Leading Skip Count e Trailing Skip Count fizerem com que os bytes sejam ignorados no fluxo de bits, quando a mensagem for serializada, essa propriedade fornecerá o caractere a ser utilizado nas posições ignoradas. Defina este caractere de uma das seguintes formas:
  • Selecione SPACE, NUL ou 0 (o padrão) na lista drop-down.
  • Digite um caractere entre aspas, por exemplo, "c" ou 'c', em que c é qualquer caractere alfanumérico.
  • Digite um código de caractere decimal no formato YY em que YY é um valor decimal.
  • Digite um código de caractere hexadecimal no formato 0xYY em que YY é um valor hexadecimal.
  • Digite um valor Unicode no formato U+xxxx em que xxxx é um valor Unicode especificado em formato hexadecimal.
Política para Elementos Ausentes Tipo enumerado A configuração desta propriedade administra a ação utilizada pelo intermediário quando os campos estão ausentes da árvore de mensagem quando a mensagem é serializada:
  • Utilizar Default Value (o padrão). Se um Default Value existir para o elemento, utilizá-lo como saída; caso contrário uma exceção será emitida.
  • Utilizar Null Value. Se a propriedade do elemento Nillable for verificada e um Encoding Null Value estiver especificado para o elemento, utilize como saída o Encoding Null Value de acordo com as regras definidas pela propriedade Encoding Null. Caso contrário uma exceção será emitida.

Representação Binária de Valores Decimais

Propriedade Type Significado
Código Positivo Decimal Compactado Tipo enumerado Selecione o sinal positivo utilizado para números decimais compactados da lista drop-down. O padrão é C, que indica que 0x0C é utilizado como o sinal positivo, que é o valor normal. Você também pode selecionar F, que indica que 0x0F é utilizado como o sinal positivo: alguns sistemas exigem essa configuração.

Definições de DateTime

Propriedade Type Significado
Derivar formato padrão dateTime de tipo lógico Botão Selecione esta opção se desejar que o formato dateTime padrão seja determinado pelo tipo lógico do elemento ou atributo. Os padrões são:
dateTime
yyyy-MM-dd'T'HH:mm:ssZZZ
date
yyyy-MM-dd
time
HH:mm:ssZZZ
gYear
yyyy
gYearMonth
aaaa-MM
gMonth
--MM--
gMonthDay
--MM-dd
gDay
---dd

É possível substituir essa propriedade para um elemento ou atributo em um tipo complexo.

Utilize o Formato dateTime Padrão Botão e dateTime Selecione esta opção se desejar especificar um formato dateTime padrão, fixo para todos os elementos ou atributos do tipo lógico dateTime, date, time, gYear, gYearMonth, gMonth, gMonthDay e gDay.

O valor inicial dessa propriedade é aaaa-MM-dd'T'HH:mm:ssZZZ , que pode ser alterado por sobreposição.

É possível substituir essa propriedade para um elemento ou atributo em um tipo complexo.

Para obter informações adicionais sobre formatos dateTime, consulte Formatos DateTime.

Iniciar o século para anos de 2 dígitos Inteiro Essa propriedade determina como os anos de dois dígitos são interpretados. Especifique os dois dígitos que começam com uma janela de 100 anos que contenha o ano atual. Por exemplo, se você especificar 89, e o ano corrente for 2002, todas as datas de dois dígitos serão interpretadas como sendo no intervalo de 1989 a 2088.

O valor inicial é 53, que pode ser alterado por sobreposição.

Dias na Primeira Semana do Ano Tipo enumerado Especifique o número de dias do ano novo que devem estar na primeira semana.

O início de um ano geralmente está na metade de uma semana. Se o número de dias nessa semana for menor que o valor especificado aqui, a semana será considerada como a última semana do ano anterior; portanto, a semana 1 começará em alguns dias no ano novo. De outra maneira, ela será considerada a primeira semana do ano novo; portanto, a semana 1 começará alguns dias antes do ano novo.

Selecione Utilizar Locale do Intermediário, que faz com que o intermediário obtenha as informações da plataforma subjacente, ou selecione um número da lista drop down.O valor inicial é 4.

Primeiro Dia da Semana Tipo enumerado Especifique o dia no qual cada nova semana é iniciada.

Selecione Utilizar Locale do Intermediário, que faz com que o intermediário obtenha as informações da plataforma subjacente, ou selecione um valor da lista drop down.O valor inicial é segunda-feira.

Verificação Precisa de Data/Hora Caixa de Opções Selecione essa opção se desejar restringir os dateTimes a um formato válido de dateTime. Isso permitirá que 35 de março seja processado como 4 de abril e 10:79 seja processado como 11:19. Se Verificação Precisa de Data/Hora estiver definido, o recebimento de um dateTime incorreto causará um erro. O padrão é restringir dateTimes.
Verificação Estrita de dateTime
Os exemplos de verificação estrita de dateTime são:
  • DateTimes serão restringidos apenas a dateTimes válidos. Isto não permitirá que datas como 35 de março sejam processadas como 4 de abril e 10:79 seja processada como 11:19. O recebimento de um dateTime out-of-band como estes exemplos causarão um erro.
  • O número de caracteres para um componente dateTime numérico deve estar dentro dos limites dos símbolos de formatação correspondentes. Repita o símbolo para especificar o número mínimo de dígitos requeridos. O número máximo de dígitos permitido será o limite superior de um símbolo específico. Por exemplo, o dia do mês tem um limite superior igual a 31, portanto, uma cadeia de formatações igual a d permitirá que os valores 2 ou 21 sejam analisados, mas não permitirá o valor 32 ou 210. Na saída, os números são preenchidos com zeros para o comprimento especificado. Um ano é um caso especial, consulte a propriedade de conjunto de mensagens Início de século para anos de 2 dígitos. Para segundos fracionários, o comprimento deve corresponder implicitamente ao número de símbolos de formato na entrada. A saída é arredondada para o comprimento especificado.
  • Os espaços em branco não serão ignorados. Os espaços em branco na cadeia de entrada devem corresponder ao mesmo número e posição de espaços em branco na cadeia de formatações.
  • Se ainda houver dados a serem analisados na cadeia de entrada, quando todos os símbolos na cadeia de formatações tiverem sido correspondidos, ocorrerá um erro.
Verificação de dateTime Tolerante
Os exemplos de verificação de dateTime tolerante são:
  • O analisador converterá valores dateTime out-of-band no valor in-band apropriado. Por exemplo, uma data 2005-05-32 será convertida em 2005-06-01.
  • A saída de dateTimes sempre estará de acordo com a contagem de símbolos. Por exemplo, uma cadeia de formatações de yyyy-MM-dd (em que '-' é o separador de campo) permite que um ou mais caracteres sejam analisados em relação a MM e dd. Isso permitiria que datas inválidas como 2005-1-123 e 2005-011-12 fossem inseridas. O primeiro valor de 2005-1-123 seria exibido como a data 2005-05-03 e o segundo valor de 2005-011-12 seria exibido como a data 2005-11-12.
  • O número do símbolo Z de formatação de fuso horário será aplicável apenas ao formato dateTime de saída.
  • Os espaços em branco serão ignorados.
Fuso Horário Tipo enumerado O valor definido para essa propriedade será utilizado se o valor especificado para a propriedade Formato Padrão de DateTime não incluir informações sobre Fuso Horário.

O valor inicial é Utilizar Locale do Intermediário que faz com que o intermediário obtenha as informações da plataforma subjacente.

Você pode alterar isso utilizando a caixa drop down.

Horário de Verão Caixa de Opções Selecione esta opção se a área na propriedade Fuso Horário observar o horário de verão.Se ela não observar o horário de verão, esta opção não deve ser selecionada.

Por exemplo, se uma área for selecionada em Fuso Horário e esta opção não for selecionada, o valor transmitido representará o fuso horário sem o horário de verão.

O padrão é não observar o horário de verão.

Utilizar o Formato UTC de Entrada na Saída Caixa de Opções Esta propriedade se aplica a elementos e atributos de tipo lógico xsd:dateTime ou xsd:time que contêm um dateTime como uma cadeia e que possuem um formato dateTime igual a I, IU, T ou TU ou que inclui ZZZ ou ZZZU.

Tais elementos e atributos podem especificar UTC (Consolidated Universal Time) utilizando o caractere Z ou o fuso horário +00:00 no valor. Na entrada, o analisador MRM lembra a forma que o UTC foi especificado.

Se esta propriedade for verificada e o elemento ou atributo for copiado para uma mensagem de saída, o formato UTC será preservado para a mensagem de saída e substituirá o implícito pela propriedade de formato dateTime.

Se esta propriedade não for verificada ou o elemento ou atributo não tiver sido copiado de uma mensagem de entrada, o formato UTC na mensagem de saída será controlado apenas pela propriedade de formato dateTime.

O padrão para esta propriedade é não verificado.

A codificação numérica e de caracteres para mensagens que não são WebSphere MQ

Estas definição são utilizadas apenas para mensagens sem MQMD.

Propriedade Type Significado
CCSID* Padrão INTEGER Insira um valor numérico para o Identificador do Conjunto de Caracteres Codificados padrão. O padrão é 500.

Se a mensagem de entrada for uma mensagem do WebSphere MQ, o atributo equivalente definido para o gerenciador de filas será utilizado e esta propriedade será ignorada.

Ordem de Bytes* Tipo enumerado Selecione Big Endian (o padrão) ou Little Endian da lista drop-down para especificar a ordem de bytes de números que são representados como inteiros binários.

Em C, isto é equivalente ao tipo de dados curto ou longo. Em COBOL, isto é equivalente a um tipo de dados PIC 9 COMP, COMP-4, COMP-5 ou BINARY.

Sua opção deve corresponder à codificação com a qual as mensagens são criadas. Big Endian normalmente é a opção correta para as mensagens criadas em UNIX ou z/OS, Little Endian para Windows.

Esta propriedade não é utilizada se a mensagem for recebida pelo protocolo de transporte WebSphere MQ: neste caso a propriedade, é deduzida de MQMD da mensagem ou da codificação do gerenciador de filas do intermediário.

Ordem de Bytes Decimais Compactados* Tipo enumerado Selecione Big Endian (o padrão) ou Little Endian da lista drop-down para especificar a ordem de bytes de números que são representados como decimais compactados.Em COBOL, isto é equivalente ao tipo de dados PIC 9 COMP-3. (Não existe um tipo de dados equivalente em C).

Sua opção deve corresponder à codificação com a qual as mensagens são criadas. Big Endian normalmente é a opção correta para as mensagens criadas em UNIX ou z/OS, Little Endian para Windows NT.

Formato Flutuante* Tipo enumerado Selecione S390 (o padrão), IEEE ou IEEE Reverso na lista drop-down para especificar a ordem dos bytes dos números na mensagem que são representados como ponto flutuante.
Conceitos relacionados
Formatos Físicos no Domínio MRM
Formato de Ligação Personalizada
Custom Wire Format: Relacionamento com o Modelo Lógico
Tarefas relacionadas
Trabalhando com Propriedades Físicas
Referências relacionadas
Informações de Referência do Modelo de Mensagens
Propriedades do Conjunto de Mensagens
Propriedades do Conjunto de Mensagens de Formato de Ligação XML
Propriedades do Conjunto de Mensagens de Formato TDS
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ad09255_