Propriedades TDS para Tipos de Flutuações de Elementos Compostos

As propriedades TDS descritas aqui se aplicam a:

Identificação de Campo

Propriedade Tipo Significado
Tag String Especifique o valor utilizado para identificar o objeto em um fluxo de bits de mensagem.

Se o objeto for simples e a propriedade Separação de Elementos de Dados do tipo ou tipos complexos nos quais o objeto seja um filho estiver Delimitada por Tag, Comprimento Fixado por Tag ou Comprimento Codificado por Tag, essa propriedade deve conter um valor não-vazio.

Se o objeto for um elemento complexo e a propriedade Separação de Elementos de Dados de seu pai for Marcado Delimitado, Comprimento Fixo Marcado ou Comprimento Codificado Marcado, a propriedade poderá conter um valor vazio.

O valor dessa propriedade deve ser exclusivo para cada elemento no conjunto de mensagens; ou seja, dois elementos no conjunto de mensagens não podem conter o mesmo valor para essa propriedade.

Padrão de Dados String Especifique a expressão regular a ser utilizada pelo analisador para identificar os dados na mensagem a serem atribuídos ao objeto. Essa propriedade é utilizada quando o método Separação de Elementos de Dados tiver sido configurado como Utilizar Modelo de Dados no tipo complexo. Consulte Sintaxe de Expressão Regular para obter detalhes adicionais.
Delimitador de Elemento de Repetição String Especifique o delimitador a ser utilizado entre elementos de repetição.

Este delimitador será utilizado apenas quando o elemento se repetir e a propriedade Separação de Elementos de Dados do grupo pai ou tipo complexo estiver configurada como Todos os Elementos Delimitados ou Elementos de Comprimento Variável Delimitados.

Será fornecido um valor padrão se as condições acima forem verdadeiras; se o padrão do sistema de mensagens for HL7, o mnemônico <HL7_RS> será utilizado; se o padrão do sistema de mensagens não for HL7 e o número máximo de repetições for fixo, o delimitador do grupo pai ou tipo complexo será utilizado.

Se nenhuma das condições acima for verdadeira, não será aplicado um padrão.

Representação Física

Propriedade Tipo Significado
Tipo Físico Tipo enumerado O Tipo Físico pode ser configurado como Caracteres ou Alternativa de Padrão do Sistema de Mensagens. Essa propriedade informa ao analisador do TDS se o dados na mensagem estão no formato de caractere TDS normal ou estão em outro formato alternativo que possui um padrão de sistema de mensagens específico como o TLOG. Os valores disponíveis e o valor padrão dependem do Padrão de Sistema de Mensagens e do tipo lógico.

Quando o tipo lógico do objeto for dateTime, float ou integer, essa propriedade será desativada.

Se a propriedade Padrão de Sistema de Mensagens (no nível do conjunto de mensagens) estiver configurada diferente de TLOG, a propriedade Tipo Físico será desativada.

Se a propriedade Padrão do Sistema de Mensagens (no nível do conjunto de mensagens) for configurada como TLOG e o tipo lógico do objeto for configurado como um Booleano, tipo decimal ou de cadeia, a propriedade Tipo Físico pode ser configurada como Caracteres ou Padrão do Sistema de Mensagens Alternativo.

Comprimento Número Inteiro Especifique o comprimento esperado do objeto em caracteres.

Essa propriedade se aplica a objetos simples e a elementos complexos em um tipo base.

Se você configurar a propriedade Separação de Elementos de Dados para o tipo como Comprimento Fixo ou Comprimento Fixo AL3, esta propriedade ou a propriedade Referência de Comprimento, deverá conter um valor que não seja 0 ou NULL.

Justificação Tipo enumerado

Especifique o alinhamento do objeto se os dados que estão sendo gravados ou analisados forem menores do que o valor de comprimento fixo. Esta propriedade é utilizada apenas quando um valor é enviado como uma cadeia de comprimento fixo.

Selecione um dos seguintes valores da lista drop down:

  • Não Aplicável
  • Alinhar à Esquerda
  • Alinhar à Direita
Caractere de Enchimento String Especifique o caractere de preenchimento a ser inserido ou interpretado na gravação ou análise de um objeto de comprimento fixo, se os dados forem menores do que o valor de comprimento fixo. Esta propriedade é utilizada apenas quando um valor é enviado como uma cadeia de comprimento fixo.

Defina este caractere de uma das seguintes formas:

  • Selecione NUL, '0' ou SPACE a partir da 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 hexadecimal no formato 0xYY, onde YY é um valor hexadecimal.
  • Digite um valor Unicode no formato U+xxxx, onde xxxx é um valor Unicode especificado em hexadecimal. O comprimento máximo da cadeia que pode ser digitada é 10.

A opção de qual dessas formas de caractere de preenchimento é utilizada para um elemento MRM depende do caractere de preenchimento que é requerido e se o caractere de preenchimento deve estar sujeito à conversão de dados.

Na maioria dos casos, a especificação de um caractere de preenchimento é suficiente e quando esse caractere de preenchimento for utilizado, ele é convertido para a página de códigos de destino da mensagem MRM de saída que está sendo gerada.

Se um caractere de preenchimento que não pode ser facilmente digitado for requerido no campo de caractere de preenchimento, o formato mnemônico Unicode pode ser utilizado para especificar o caractere requerido. Quando utilizado, o valor de Unicode também é convertido para a página de códigos de destino da mensagem MRM que está sendo gerada.

Se for requerido um caractere de preenchimento que não esteja sujeito à conversão de dados, será utilizado o formato hexadecimal. Isso permite especificar a opção de um caractere de preenchimento que seja inserido diretamente na mensagem de saída. Se esse formato for utilizado, você deve assegurar que esse valor hexadecimal seja válido para a página de códigos das mensagens de saída criadas com essas definições do MRM.

Se você estiver convertendo uma mensagem de uma página de códigos para outra, você deve assegurar que os valores convertidos do caractere de preenchimento seja válido para essa página de códigos. Por exemplo, ao converter de ASCII para a página de códigos 500, se você tiver especificado o número 8 como caractere de preenchimento, ele será convertido de 0x08 para 0x15, as representações de ASCII e EBCDIC para 'back space'.

Atualmente existe uma restrição que o valor de seu caractere de preenchimento não deve ser maior que U+007F. Observe que se um mnemônico Unicode ou valor numérico for digitado, ele será considerado como o caractere representado por esse número em UTF-8.

Referência de Comprimento Tipo enumerado Esta propriedade é aplicável apenas se o Tipo Físico for Texto, Binário ou Específico de TLOG. Se configurada, essa propriedade tem prioridade em relação a qualquer valor na propriedade Unidades de Comprimento.

Especifique o identificador de um objeto de inteiro irmão, o valor do qual determina o comprimento do objeto em questão. O objeto irmão deve ser definido antes do objeto atual na estrutura da mensagem.

Para obter informações sobre como reordenar elementos, consulte Reordenando Objetos.

Representação Numérica

Propriedade Tipo Significado
Ponto Decimal Virtual Botão e Número Inteiro Especifique um inteiro diferente de zero que representa a posição de um ponto decimal implícito em um número, ou especifique 0 (zero, o padrão) para utilizar a formatação de números Flutuantes ou Decimais conforme especificados pela propriedade Precisão.

Se você especificar um inteiro positivo, a posição do ponto decimal será movida à esquerda do lado direito do número. Por exemplo, se você especificar 3, o valor decimal 1234 representará 1.234

Se especificar um inteiro negativo, a posição do ponto decimal será movida à direita do lado direito do número. Por exemplo, se você especificar -3, o valor decimal 1234 representará 1 234 000

Precisão Botão e Número Inteiro Essa propriedade aplica-se somente se Tipo Físico for Texto. É utilizada se o valor da propriedade Ponto Decimal Virtual for 0, o que indica que o ponto decimal está presente nos dados. Lida com truncamento e especifica quantos dígitos devem seguir o ponto decimal.

Especifique um número de dígitos:

  • Se você definir Precisão como 0, os dados serão truncados e a parte fracionária será perdida.Por exemplo, o valor 123.45 será truncado para 123.
  • Se você definir Precisão como um número menor que o número de dígitos fracionários, os dados serão truncados.Por exemplo, o valor 123.4567 será truncado para 123.45 se você definir Precisão como 2.
  • Se você definir Precisão como um número maior que o número de dígitos fracionários, o valor será preenchido com zeros extras.Por exemplo, o valor 12.345 será preenchido para 12.34500 se você definir Precisão como 5.

Ou selecione uma das seguintes opções da lista drop down:

  • Todos os Dígitos Significativos (o padrão): todos os dígitos significativos são gravados para o fluxo de bits de saída e não haverá separado decimal, se não houver dígitos fracionários.
  • Separador Decimal Explícito: todos os dígitos significativos são gravados para o fluxo de bits de saída e o separador decimal é sempre incluído, mesmo se não houver dígitos fracionários. O separador decimal deve estar presente no fluxo de bits de entrada, mesmo que nenhum dígito fracionável esteja presente.
  • Notação Exponencial: os dados são gravados para o fluxo de bits como um valor sinalizado que possui o formato [sign1]a.bbbe[sign2]ccc em que:
    • [sign1] terá o valor de Sinal Negativo se o valor for negativo
    • a é um dígito decimal único
    • bbb é um ou mais dígitos decimais
    • [sign2] terá o valor de Sinal Negativo se o expoente for negativo
    • ccc será exatamente os três dígitos decimais (o expoente)
    [sign1] e [sign2] estarão ausentes, se o valor e o expoente, respectivamente, forem positivos.

    Por exemplo, o valor -123.456 é representado como -1.23456e002 e o valor 0.00012 é representado como 1.2e-004 no fluxo de bits de saída (supondo que o valor de Sinal Negativo seja "-" e o valor de Orientação de Sinal seja Inicial).

    O valor -0.00012 é representado como 1.2*e*004 se Sinal Negativo for "*" e Orientação de Sinal for Final.

Orientação de Sinal Tipo enumerado
Os valores que podem ser escolhidos para essa propriedade são:
  • Nenhum
  • Inicial
  • Final

Se você definir o valor para essa propriedade como Nenhum, ele será interpretado como não tendo nenhum sinal e será emitida uma exceção se um número negativo for processado (na entrada ou na saída).

Se você configurar o valor desta propriedade como Inicial, isto indica que o sinal será posicionado na frente do número; por exemplo, -1234. De forma semelhante, se você configurar esta propriedade como Final, o sinal seguirá o número, por exemplo, 1234-.

Se nenhum sinal estiver configurado, o número será assumido como positivo.

Sinal Positivo String Especifique o valor que representa o símbolo positivo. Não especifique um valor numérico. Se nenhum valor for definido, será assumido "+". O sinal positivo não é gravado ao criar uma mensagem de saída; ele é utilizado apenas para reconhecer o sinal positivo ao analisar um fluxo de bits da mensagem.
Sinal Negativo String Especifique o valor que representa o símbolo negativo. Não especifique um valor numérico. Se nenhum valor for definido, será assumido "-".

Representação de Valores Nulos

Propriedade Tipo Significado
Codificação Nula Tipo enumerado Selecione uma das seguintes opções da lista drop-down:
  • NULLPadFill. Válido somente para objetos de comprimento fixo. Este é o valor padrão.
  • NULLLogicalValue. A propriedade Valor de Codificação Nulo é convertida primeiro para um valor real e processada da forma especificada para o campo.
  • NULLLiteralValue. Especifica que Valor de Codificação Nulo contém um valor que é diretamente substituído como se fosse uma cadeia. Para elementos dateTime, utilize esta opção se desejar utilizar a propriedade Valor de Codificação Nula para testar ou comparar o conteúdo do campo na mensagem.
  • NULLLiteralFill. Isso especifica que o campo é preenchido com o valor especificado pela propriedade Valor Nulo de Codificação. O Valor Nulo de Codificação deve ser resolvido para um único caractere.

A opção selecionada determina o valor que deve ser configurado para a propriedade Valor de Codificação Nula.

Para obter informações completas sobre como utilizar essas opções, consulte Opções de Tratamento de Nulos TDS.

Valor Nulo de Codificação String A utilização desta propriedade depende da propriedade Codificação Nula descrita acima. O valor padrão é zero.

Se você configurar a propriedade Codificação Nula para um objeto dateTime como NULLLogicalValue, o valor configurado deverá estar em um formato dateTime ISO8601.

Estes formatos estão descritos em DateTime como Dados de Cadeia.

Por exemplo, especifique um valor que esteja em conformidade com o formato aaaa-MM-dd'T'HH:mm:ss; por exemplo, 1970-12-01.

Conceitos relacionados
Modelagem de Mensagens
O Modelo de Mensagem
Formato TDS: Relacionamento com o Modelo Lógico
Tarefas relacionadas
Desenvolvendo Modelos de Mensagens
Trabalhando com Objetos de Modelo de Mensagem
Referências relacionadas
Informações de Referência do Modelo de Mensagens
Propriedades do Objeto de Modelo de Mensagem
Propriedades do Objeto de Modelo de Mensagem Reprovadas
Propriedades de Elementos Compostos
Propriedades de TDS de Elemento Composto
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:12:20

ad16410_