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

Validate

Utilize o nó Validate para verificar se a mensagem que chega em seu terminal de entrada está conforme o esperado. É possível usar esse nó para verificar se a mensagem tem as propriedades esperadas de modelo de mensagem e verificar se o conteúdo da mensagem está correto selecionando a validação de mensagem.

Este tópico contém as seguintes seções:

Finalidade

As verificações que podem ser desempenhadas dependem do domínio da mensagem.
Verificação Domínio
Verifique o domínio de mensagem Todos os domínios
Verificar modelo de mensagem Somente XMLNSC, DFDL, MRM e IDOC
Verificar mensagem Somente DFDL e MRM
Valide o corpo da mensagem Somente XMLNSC, DFDL, MRM e IDOC

É possível verificar a mensagem com relação a um ou mais domínios de mensagem, modelos de mensagem ou mensagens. A propriedade será verificada apenas se você selecionar sua caixa de opção correspondente, que significa que uma propriedade que contém uma cadeia vazia pode ser comparada.

É possível verificar o conteúdo da mensagem fornecendo um valor para a propriedade Validar. A validação ocorrerá se a propriedade Validar estiver configurada para um valor diferente de Nenhum, que é o valor padrão.

Para que as falhas de validação sejam retornadas ao nó Validate a partir do analisador,defina a propriedade Ação de Falha como Exceção ou Lista de Exceção . Caso contrário, as falhas de validação são apenas registradas em log.

Se todas as verificações especificadas forem transmitidas, a mensagem será propagada para o terminal Match do nó.

Se alguma das verificações falhar, a mensagem será propagada para o terminal Failure. Se o terminal Failure não estiver conectado a algum processamento de manipulação de falhas, será gerada uma exceção.

O nó Validate node replaces the Check, que foi descontinuado no WebSphere Message Broker Versão 6.0 e em liberações subsequentes. O nó Validate funciona da mesma maneira que o nó Check, mas possui propriedades de Validação adicionais para permitir a validação do conteúdo da mensagem por analisadores que suportam esse recurso.

O nó Validate está contido na caixa Validação da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

Ícone do nó Validar

Utilizando Este Nó em um Fluxo de Mensagens

Utilize o nó Validate para confirmar se uma mensagem tem as propriedades de modelo de mensagem corretas e um conteúdo válido, antes de propagar a mensagem para o restante do fluxo. Os nós subseqüentes podem depender de a mensagem estar correta, sem fazer sua própria verificação de erro.

Você também pode utilizar o nó Validate para garantir que a mensagem seja roteada apropriadamente por meio do fluxo de mensagens. Por exemplo, configure o nó para direcionar uma mensagem que solicita compras de ações por uma rota diferente da requerida para uma mensagem que solicita vendas de ações.

Outro exemplo de rota é o recebimento das mensagens eletrônicas de sua equipe no escritório da matriz. Essas mensagens são utilizadas para diversas finalidades (por exemplo, para solicitar suporte técnico ou material de papelaria, ou para informar sobre novas tendências de seus clientes). Essas mensagens podem ser processadas automaticamente porque sua equipe preencheu um formulário padrão. Se você quiser que essas mensagens sejam processadas separadamente a partir de outras mensagens que são recebidas, utilize o nó Validate para garantir que somente as mensagens da equipe que tenham um tipo de mensagem específico sejam processadas por esse fluxo de mensagens.

Terminais e Propriedades

Quando tiver colocado uma instância do nó Validate em um fluxo de mensagens, você poderá configurá-lo. Para obter informações adicionais, consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades. Todas as propriedades obrigatórias para as quais é necessário digitar um valor (aquelas que não têm um valor padrão definido) são marcadas com um asterisco.

Os terminais do nó Validate são descritos na tabela a seguir.

Terminal Descrição
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Defeito O terminal de saída para o qual a mensagem será roteada se a mensagem de entrada não corresponder às propriedades especificadas.
Correspondência O terminal de saída para o qual a mensagem será roteada se a mensagem de entrada corresponder às propriedades especificadas.

As tabelas a seguir descrevem as propriedades do nó. A coluna com cabeçalho M indica se a propriedade é obrigatória (marcada com um asterisco caso seja necessário digitar um valor quando nenhum padrão for definido); a coluna com cabeçalho C indica se a propriedade é configurável (você poderá alterar o valor quando incluir o fluxo de mensagens ao arquivo BAR para implementá-lo).

As propriedades Descrição do nó Validate são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Nome do Nó Não Não Validate O nome do nó.
Short description Não Não   Uma breve descrição do nó.
Descrição Longa Não Não   Texto que descreve a finalidade do nó no fluxo de mensagens.

As propriedades Básicas do nó Validate são descritas na tabela a seguir.

Propriedade M A O padrão Descrição
Domínio Não Não   O nome do domínio. Selecione um dos seguintes valores na lista da propriedade Domínio:
  • XMLNSC
  • DFDL
  • SOAP
  • DataObject
  • XMLNS
  • JMSMap
  • JMSStream
  • MIME
  • MRM
  • BLOB

Também é possível especificar um analisador definido pelo usuário, se apropriado.

Verificar domínio Sim Não Não selecionada Se você selecionar esta caixa de opção, a mensagem que chega será verificada em relação à propriedade Domínio.
Modelo de mensagem Não Não   O nome ou identificador do arquivo de esquema de modelo de mensagem ao qual a mensagem recebida pertence. Se você estiver usando o analisador XMLNSC, DFDL, DataObject, SOAP, MRM ou IDOC e quiser verificar se a mensagem recebida pertence a um determinado modelo de mensagem, selecione Verificar modelo de mensagem e selecione um dos valores na lista da propriedade Modelo de mensagem. Essa lista é preenchida quando você seleciona XMLNSC, DFDL, DataObject, SOAP, MRM ou IDOC como domínio de mensagem.

Deixe Modelo de mensagem desmarcado para os outros analisadores.

Se você configurar essa propriedade e atualizar subsequentemente as dependências do projeto para remover essa referência de modelo de mensagem, um aviso será emitido. Atualize a propriedade Modelo de mensagem ou restaure a referência a esse arquivo de esquema de modelo de mensagem.

Verificar modelo de mensagem Sim Não Não selecionada Se você selecionar a caixa de opção, a mensagem recebida será verificada com relação à propriedade Modelo de Mensagem. Se você estiver usando o analisador XMLNSC, DFDL, DataObject, SOAP, MRM ou IDOC e desejar verificar se a mensagem recebida pertence a um determinado modelo de mensagem, selecione Verificar Modelo de Mensagem e selecione um dos valores na lista da propriedade Modelo de Mensagem.
Mensagem Não Não   O nome da mensagem. Se você estiver usando o analisador DFDL ou MRM e desejar verificar se a mensagem recebida é um tipo de mensagem específico, selecione Verificar Mensagem e insira o nome da mensagem na propriedade Mensagem.

Deixe Mensagem desmarcado para outros analisadores.

Verificar mensagem Sim Não Não selecionada Se você selecionar a caixa de opção, a mensagem recebida será verificada com relação à propriedade Mensagem. Se você estiver usando o analisador MRM e desejar verificar se a mensagem recebida é um tipo de mensagem específico, selecione Verificar Mensagem e insira o nome da mensagem na propriedade Mensagem.

As propriedades Validação do nó Validate são descritas na tabela a seguir.

Se você estiver usando o analisador XMLNSC, DFDL, DataObject, SOAP, MRM ou IDOC e desejar validar o corpo de mensagens com relação ao modelo de mensagem, selecione as propriedades de validação necessárias na guia Validação. Para obter detalhes adicionais, consulte Validando Mensagens e Propriedades de Validação.

Propriedade M C Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Validar Não Sim Nenhum(a) Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum, Conteúdo e Valor, Conteúdo e Herdar. validateMaster
Ação de Defeito Não Não Exceção Essa propriedade controla o que acontecerá se a validação falhar. Você pode configurar essa propriedade somente se configurar Validar como Conteúdo ou Conteúdo e Valor. Os valores válidos são Rastreio do Usuário, Registro de Erros Local, Exceção e Lista de Exceções.  
As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

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:28:28


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac20803_