Propriedades do Conjunto de Mensagens de Formato de Ligação XML

As tabelas a seguir definem as propriedades para o Formato de Ligação XML do conjunto de mensagens.

Definições de Espaço de Nomes

Propriedade Tipo Significado
URL de Espaço de Nomes Cadeia Insira o nome do espaço de nomes que você está utilizando com o prefixo associado.
Prefixo Cadeia Insira o prefixo para associar os nomes do elemento e do atributo que são utilizados com o nome do espaço de nomes.

Locais do Esquema de Espaço de Nomes

Propriedade Tipo Significado
URL de Espaço de Nomes Cadeia Insira o nome do espaço de nomes que identifica qual espaço de nomes está sendo utilizado.
Local do Esquema Cadeia Insira o local do esquema para o nome do espaço de nomes associado utilizado para validar objetos neste espaço de nomes.

declaração XML

Propriedade Tipo Significado
Suprimir Declaração XML Caixa de Opções Selecione a caixa de opções para suprimir a declaração XML. Se ela estiver selecionada, a declaração (por exemplo, <?xml version='1.0'>) será suprimida.

Por padrão, a caixa de opções está desmarcada.

Versão XML Tipo enumerado Isto controla o valor da versão na declaração XML gerada.

O padrão é 1.0.

Se você definir Suprimir Declaração XML como Sim, esta propriedade será ignorada.

Codificação XML Tipo enumerado Isto controla se um atributo de codificação é gravado na declaração XML gerada.

Se for selecionado Nulo, nenhum atributo de codificação será gravado na declaração XML do documento XML de saída.

SeComo Texto de Documento for selecionado, será gerado um atributo de codificação consistente com o texto no documento XML.

O padrão é Nulo.

Se a caixa de opções Suprimir Declaração XML for selecionada, essa propriedade será ignorada.

Documento Independente Tipo enumerado Selecione Sim, Não, ou Nulo da lista de valores. Se Nulo, for selecionado, nenhuma declaração independente estará presente na declaração XML. Se você selecionar Sim ou Não, a declaração standalone = "yes" ou standalone = "no" é incluída à declaração XML quando a mensagem de saída é gravada. O valor padrão é Nulo.

A configuração dessa propriedade não determina se um subconjunto de DTD externo será carregado; os subconjuntos de DTD externos nunca são carregados neste release.

Se a caixa de opções Suprimir Declaração XML for selecionada, essa propriedade será ignorada.

Declaração de Espaço de Nomes de Saída Tipo enumerado A propriedade Declaração de Espaço de Nomes de Saída controla onde as declarações de espaço de nomes são colocadas no documento XML de saída. As opções são:
  • No início do documento.As declarações para todas as entradas na tabela Localizações de Esquema de Espaço de Nome acima são a saída como atributos da mensagem no documento XML de saída. A desvantagem dessa opção é que, em alguns casos, podem ser exibidas declarações desnecessárias.
  • Conforme requerido. As declarações são saídas apenas quando necessário por um elemento ou atributo que esteja nesse espaço de nome. A desvantagem dessa opção é que a mesma declaração de espaço de nomes talvez precise ser exibida mais de uma vez no documento XML de saída.

A opção padrão é No início do documento.

Essa propriedade estará ativa apenas se os espaços de nomes forem ativados para esse conjunto de mensagens.

Definições de Tipo de Documento XML

Propriedade Tipo Significado
Suprimir DOCTYPE Caixa de Opções Se você selecionar a caixa de opções, a DTD (DOCTYPE Declaration) será suprimida.

Por padrão, a caixa de opções está selecionada.

ID do Sistema DOCTYPE Cadeia Especifique o ID do Sistema para o subconjunto DTD externo DOCTYPE (se DOCTYPE estiver presente). Tipicamente, ele é definido como o nome do DTD gerado (ou importado) para um conjunto de mensagens..

Se Suprimir DOCTYPE for definido, essa propriedade será ignorada e não poderá ser alterada (o campo é desativado). O valor padrão é www.mrmnames.net/, seguido pelo identificador do conjunto de mensagens.

ID Público de DOCTYPE Cadeia Especifique o ID Público para o subconjunto DTD externo DOCTYPE (se DOCTYPE estiver presente e o ID do Sistema estiver especificado).

Se Suprimir DOCTYPE for definido, essa propriedade será ignorada e não poderá ser alterada (o campo é desativado). O valor padrão é o identificador do conjunto de mensagens.

Texto de DOCTYPE Cadeia Utilize esta propriedade para adicionais declarações DTD adicionais. Ela não é analisada pelo analisador XML e, portanto, não pode ser XML válido. É possível incluir definições ENTITY ou declarações DTD internas. É uma cadeia (com até 32 KB) na qual os caracteres de nova linha e de tabulação são substituídos por \n e \t, respectivamente.

O conteúdo não é analisado e aparece na mensagem de saída. Se houver um DTD em linha, o conteúdo desta propriedade terá precedência.

Se, no entanto, você definiu Suprimir DOCTYPE, essa propriedade será ignorada e não poderá ser alterada (o campo é desativado).

Para obter informações adicionais, consulte MRM XML: DTDs em Linha e a Propriedade de Texto DOCTYPE.

O valor padrão é vazio (não definido).

Representação XML de Valores Booleanos

Propriedade Tipo Significado
Boolean True Value Cadeia Especifique a cadeia que será utilizada para codificar e reconhecer valores BOOLEAN true. Quando um documento XML é analisado, a cadeia 1 é sempre aceita como true para um elemento BOOLEAN. Insira uma cadeia com até 254 caracteres.

O padrão é true.1 também é válido.

Boolean False Value Cadeia Especifique a cadeia que será utilizada para codificar e reconhecer valores BOOLEAN false. Quando um documento XML é analisado, a cadeia 0 é sempre aceita como false para um elemento BOOLEAN. Insira uma cadeia com até 254 caracteres.

O padrão é false.0 também é válido.

Representação XML de Valores Nulos

Propriedade Tipo Significado
Codificação Nula Numérica Tipo enumerado Especifique a codificação nula para elementos XML numéricos. Isso fornece um método de designação de um significado nulo lógico para tais elementos. Você deve selecionar um dos seguintes valores da lista mostrada:
  • NULLEmpty. Se o valor do elemento for a cadeia vazia, o elemento será nulo. Esse é o valor padrão.
  • NULLValue. Se o valor do elemento corresponder ao fornecido pela propriedade associada Codificação do Valor Nulo Numérico, o elemento será nulo.
  • NULLXMLSchema. Se o elemento contiver um atributo xsi:nil que avalia como verdadeiro, o elemento será nulo.
  • NULLValueAttribute. Essa opção é válida somente para elementos que têm a propriedade Processamento do Formato de Ligação XML configurada para XMLElementAttrVal ou XMLElementAttrIDVal. Consulte a opções de tratamento de Nulos XML para obter detalhes.
  • NULLAttribute (obsoleto). Se o elemento contiver um atributo com um nome que corresponde ao fornecido pela propriedade associada Codificação do Valor Nulo Numérico, e o atributo avaliar como verdadeiro, o elemento será nulo.
  • NULLElement (obsoleto). Se o elemento contiver um elemento filho com um nome que corresponde ao fornecido pela propriedade associada Codificação do Valor Nulo Numérico, o elemento será nulo.
Consulte opções de tratamento de Nulos XML para obter detalhes completos.
Valor de Codificação Nula Numérica Cadeia Especifique o valor para qualificar a propriedade Codificação Nula Numérica, se ela tiver sido configurada para NULLValue, NULLAttribute ou NULLElement. Consulte opções de tratamento de Nulos XML para obter informações adicionais.
Codificação Nula Não Numérica Tipo enumerado Especifique a codificação nula para elementos XML não numéricos. Isso fornece um método de designação de um significado nulo lógico para tais elementos. As opções são idênticas às disponíveis para a propriedade Codificação Nula Numérica.
Valor de Codificação Nula Não Numérica Cadeia Especifique o valor para qualificar a propriedade Codificação Nula Não Numérica. Consulte opções de tratamento de Nulos XML para obter informações adicionais.

Definições de DateTime

Propriedade Tipo 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.

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

Utilizar o formato data/hora padrão Botão e Cadeia Selecione esta opção se desejar especificar um formato de data/hora padrão que é fixado para todos os elementos ou atributos do tipo lógico dateTime, date, time, gYear, gYearMonth, gMonth, gMonthDay e gDay.

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

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

Iniciar o século para anos de 2 dígitos Número 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.
Dias na Primeira Semana do Ano Enumerado Especifique o número de dias do ano novo que devem estar na primeira semana.

O início de um ano está normalmente na metade de uma semana. Se o número de dias nessa semana for inferior ao valor especificado aqui, a semana será considerada como a última no ano anterior; portanto, a semana 1 começa alguns dias após o ano novo. Caso contrário, ela será considerada como a primeira semana do ano novo; nesse caso, a semana 1 começa alguns dias antes do ano novo.

Selecione Utilizar Código do Idioma do Intermediário, que faz com que o intermediário obtenha informações da plataforma subjacente, ou selecione um número na lista que é exibida.

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

Selecione Utilizar Código do Idioma do Intermediário, que faz com que o intermediário obtenha informações da plataforma subjacente, ou selecione um valor na lista que é exibida.

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. Se Verificação Estrita de DateTime for selecionada, receber um dateTime incorreto provocará um erro.
Verificação Estrita de dateTime
Os exemplos de verificação estrita de dateTime são:
  • DateTimes são restritos apenas para dateTimes válidos. Quando você utiliza esta opção, uma data tal como 35 de Março não é processada como 4 de Abril e 10h79 não é processada como 11h19. Receber um dateTime fora da banda, como esses exemplos, faz com que ocorra 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 que você requer. O número máximo de dígitos que são permitidos se torna o limite superior para um símbolo específico. Por exemplo, dia no mês possui um limite superior de 31; portanto, uma cadeia de formatações de 'd' permite que os valores 2 e 21 sejam analisados, mas não permite os valores 32 e 210. Na saída, os números são preenchidos com zeros para o comprimento especificado. Um ano é um caso especial; consulte a propriedade do conjunto de mensagens Início do 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.
  • O espaço em branco não é ignorado. O espaço em branco na cadeia de entrada deve corresponder ao mesmo número e posição do espaço em branco na cadeia de formatações.
  • Se ainda houver dados a serem analisados na cadeia de entrada depois que 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 converte valores dateTime fora da banda para o valor dentro da banda apropriado. Por exemplo, uma data 2005-05-32 é convertida em 2005-06-01.
  • A saída de dateTimes sempre está 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. Portanto, as datas que não são válidas - por exemplo, 2005-1-123 e 2005-011-12 - podem ser inseridas. O primeiro valor de 2005-1-123 gera a saída como a data 2005-05-03, e o segundo valor de 2005-011-12 gera a saída como a data 2005-11-12.
  • O número do símbolo Z de formatação de fuso horário é aplicável apenas ao formato dateTime de saída.
  • O espaço em branco é ignorado.
Fuso Horário 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 Código do Idioma do Intermediário, que faz com que o intermediário obtenha informações da plataforma subjacente.

Você pode alterar essa propriedade, selecionando da lista de valores.

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 não observar o Horário de Verão, não selecione esta opção.

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.

Utilizar o Formato UTC de Entrada na Saída Caixa de Opções Esta propriedade se aplica a elementos e atributos do tipo lógico xsd:dateTime ou xsd:time que possuem um formato de data/hora igual a I, IU, T ou TU ou que incluem ZZZ ou ZZZU.

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

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

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

Configurações xsi:type

Propriedade Tipo Significado
Política de saída para atributos xsi:type Tipo enumerado

Ao gravar documentos XML, essa propriedade permite especificar as circunstâncias sob as quais o atributo xsi:type dos elementos será colocado na saída.

Nunca
Não coloque na saída atributos xsi:type para elementos, mesmo se os atributos xsi:type aparecerem na árvore de mensagens.
Quando Presente
Coloque na saída atributos xsi:type para elementos somente quando os atributos xsi:type aparecerem na árvore de mensagens.Esse é o valor padrão.
Sempre (Somente elementos simples)
Assegure que todos os elementos simples sejam colocados na saída com um atributo xsi:type. Se um elemento simples já tiver um atributo xsi:type na árvore de mensagens, ele será utilizado, caso contrário, um atributo xsi:type será gerado utilizando as regras da tabela abaixo.
Sempre (Todos os elementos)
Assegure que todos os elementos sejam colocados na saída com um atributo xsi:type, se possível. Se um elemento já tiver um atributo xsi:type na árvore de mensagens, ele será utilizado, caso contrário, um atributo xsi:type será gerado utilizando as regras da tabela abaixo.
Seguir as Regras de Codificação SOAP
Siga o mesmo comportamento que para Sempre (Somente elementos simples). Além disso, coloque na saída um atributo de estilo de codificação SOAP na tag raiz de todas as mensagens.

Se um atributo xsi:type precisar ser colocado na saída, mas não aparecer na árvore de mensagens, seu valor será gerado da seguinte forma:

Tipo de elemento Valor gerado quando o elemento é definido no modelo Valor gerado quando o elemento é autodefinido
Tipos Simples

Se o tipo for global ou for um tipo interno, utilize-o.

Se o tipo for local, utilize o tipo global ou interno a partir do qual ele é derivado.

Utilize o tipo interno que melhor corresponde ao tipo de dados do elemento na árvore de mensagens.
Tipo complexo com conteúdo simples

Se o tipo for global, utilize-o.

Se o tipo for local, utilize o tipo global ou interno a partir do qual ele é derivado.

Utilize o tipo interno que melhor corresponde ao tipo de dados do elemento na árvore de mensagens.
Tipo complexo com conteúdo complexo

Se o tipo for global, utilize-o.

Se o tipo for local, nenhum atributo xsi:type é colocado na saída.

Nenhum atributo xsi:type é colocado na saída.

Reprovado

Nota: As propriedades a seguir são utilizadas para controlar o comportamento do analisador MRM e não devem ser alteradas de suas configurações padrão. Essas propriedades serão retiradas em um release futuro.
Propriedade Tipo Significado
Nome da Tag Raiz Cadeia Especifique o nome da tag raiz do conjunto de mensagens. Você pode deixar esta propriedade vazia e, neste caso, nenhuma das marcações de reinício cíclico será utilizada para mensagens (ou seja, a tag da mensagem é a raiz do documento). O nome pode ser seguido por um espaço e texto adicional para que os pares atributo/valor apareçam com a tag raiz.

O valor padrão é blank.

Suprimir Comentário de Data e Hora Caixa de Opções Se selecionado, a cadeia de comentário de data e hora na saída XML será suprimida.

Se nenhuma seleção for feita, o comentário não será suprimido, e um comentário no formato <!--MRM Generated XML Output on: Tue Apr 23 09:34:42 2002--> será incluído na mensagem de saída.

O padrão é que a caixa de opções seja selecionada.

Ativar Suporte à Criação de Versões Caixa de Opções Se selecionado, o suporte à criação de versões será ativado. Esta propriedade especifica se as definições de espaço de nomes XML são codificadas para a tag raiz na mensagem, junto com os qualificadores de espaço de nome para quaisquer elementos que não pertencem ao espaço de nomes padrão. Estas definições de espaço de nomes são utilizadas para representar as informações de dependência do conjunto de mensagens, que são utilizadas para suportar a troca de mensagens entre aplicativos que são baseados em diferentes personalizações do mesmo conjunto de mensagens.

O padrão é que a caixa de opções seja selecionada, para compatibilidade com mensagens XML MRM em releases anteriores. Se não tiver utilizado mensagens MRM XML em releases anteriores, você deve assegurar que essa caixa de opção não esteja selecionada.

Conceitos relacionados
Formatos Físicos no Domínio MRM
Formato Físico XML MRM
Formato Físico XML MRM: Manipulando Atributos xsi:type
Formato Físico XML MRM: Relacionamento com o Modelo Lógico
Tarefas relacionadas
Trabalhando com Formatos Físicos
Referências relacionadas
Propriedades do Conjunto de Mensagens
Propriedades do Conjunto de Mensagens CWF
MRM XML: DTDs em Linha e a Propriedade de Texto DOCTYPE
Propriedades do Conjunto de Mensagens de Formato TDS
Propriedades da Documentação para Todos os Objetos do Conjunto de Mensagens
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

ad09260_