WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

Validação XMLNSC

O analisador XMLNSC oferece validação de Esquema XML compatível com padrões e de alto desempenho em qualquer ponto em um fluxo de mensagens.

A validação da mensagem XML de entrada ou da árvore de mensagens é executada em relação a Esquemas XML que são implementados.

Validação não é o mesmo que análise. Ao analisar, o analisador XMLNSC sempre verifica se o documento de entrada é um XML bem formado, de acordo com a especificação XML. Se a validação estiver ativada, o analisador XMLNSC também verifica se o documento XML obedece as regras no Esquema XML.

Ativando a Validação de Esquema XML em um Fluxo de Mensagens

Você deve executar as seguintes tarefas para construir um fluxo de mensagens que valida um documento XML de acordo com um Esquema XML:

Implementando Esquemas XML

Esquemas XML podem ser implementados em um aplicativo, em uma biblioteca referenciada por um aplicativo ou em um conjunto de mensagens.

Se os esquemas forem implementados como parte do aplicativo, deverão ser incluídos em um dos projetos referenciados pelo aplicativo.

Dica: No WebSphere Message Broker Versão 8.0 e mais recente, os arquivos de esquema de modelo de mensagem contidos em aplicativos e bibliotecas são a maneira preferida de modelar mensagens para a maioria de formatos de dados. Os conjuntos de mensagens são necessários se você usar os domínios MRM ou IDOC. Para obter mais informações sobre modelagem de mensagem, consulte Conceitos de Modelagem de Mensagens.

Se os esquemas forem implementados na biblioteca, o aplicativo deverá fazer referência à biblioteca, mesmo se implementado como parte de um aplicativo diferente.

Se os esquemas forem implementados em um conjunto de mensagens, você deverá concluir as seguintes etapas.

Todos os Esquemas XML que forem usados pelo WebSphere Message Broker deverão ser criados como arquivos de definição de mensagens em um conjunto de mensagens.

Para criar e implementar um conjunto de mensagens para validação do Esquema XML:

  1. Crie um novo conjunto de mensagens ou localize um conjunto de mensagens existente.
  2. Certifique-se de que o conjunto de mensagens tenha seu Domínio de Mensagens Padrão configurado como XMLNSC, ou que a caixa de opção XMLNSC sob Domínios de Mensagem Suportados esteja selecionada, para indicar que o conjunto de mensagens suporta o domínio XMLNSC.
  3. Crie um arquivo de definição de mensagem no conjunto de mensagens para representar sua mensagem. Se você tiver um Esquema XML ou DTD existente que descreva sua mensagem, é possível importá-lo. Esta etapa pode ser repetida para cada mensagem que deseja validar.
  4. Inclua o conjunto de mensagens em um arquivo bar (broker archive), que gera o Esquema XML necessário em um arquivo com extensão .xsdzip, e implemente o arquivo BAR no intermediário.

Validação Compatível com Padrões

A validação de XMLNSC está em conformidade integral com o Esquema XML v1.0, conforme definido nas especificações disponíveis em http://www.w3.org/TR/xmlschema-1/ e http://www.w3.org/TR/xmlschema-2/, com as seguintes exceções secundárias:

Validando Documentos XML v1.1

Você pode validar os documentos que estão em conformidade com a especificação XML v1.1, mas o suporte está limitado pelo fato de que os documentos do Esquema XML v1.0 devem estar em conformidade com XML v1.0.

Como exemplo, você não pode sempre declarar um nome de marcação XML v1.1 no Esquema XML v1.0. Essa limitação não é imposta pela implementação do analisador XMLNSC; é uma limitação do Esquema XML v1.0.

Interpretando Erros de Validação

Um erro de validação é um erro resultante quando o documento XML quebrar as regras que estão definidas no esquema XML. O padrão do Esquema XML especifica exatamente quais são essas regras e como elas devem ser aplicadas. Os erros de validação que o analisador XMLNSC emite contém as informações que vinculam o erro à regra de Esquema XML que foram violadas.

Todos os erros de validação são relatados nas mensagens BIP5025 ou BIP5026. Ambas as mensagens começam com o texto no seguinte formato:
XML schema validation error '[cvc-error key: error description]'
Exemplos:
'cvc-minInclusive-valid: O valor "2" não é válido com respeito à faceta
minInclusive com o valor "3" para o tipo "po:itemCountType".' 
'cvc-complex-type.2.4.a: Esperando elemento com nome local "numItems", mas encontrou "totalValue".' 
Para localizar a regra do Esquema XML que foi violada, abra a especificação do Esquema XML e procure a chave de erro.

Exemplo 1: Abra http://www.w3.org/TR/xmlschema-1/ e procure ‘cvc-minInclusive-valid'. Siga o link para as regras do Esquema XML para a faceta minInclusive.

Exemplo 2: Abra http://www.w3.org/TR/xmlschema-1/ e procure ‘cvc-complex-type'. Siga o link para as regras do Esquema XML para validar o conteúdo de um tipo complexo. Nesse caso, a chave de erro contém informações extras. O ‘2.4.a' refere-se à sub-regra exata que foi violada. Ele não deve ser incluído ao procurar pela regra.

Se a especificação do Esquema XML não fornecer informações suficientes, é possível localizar informações adicionais utilizando um mecanismo de procura. O padrão do Esquema XML é muito amplamente utilizado e muitos tutorias on-line e outros recursos estão disponíveis.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:29:32


Tópico de ConceitoTópico de Conceito | Versão 8.0.0.5 | ad67020_