Nó Validate

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

Finalidade

Utilize o nó Validate para verificar se a mensagem que surge em seu terminal de entrada for conforme o esperado.

Você pode verificar se a mensagem possui as propriedades de gabarito de mensagem esperadas (ou seja, o domínio de mensagem, conjunto de mensagens e tipo de mensagens).

Você também pode verificar se o conteúdo da mensagem está correto, selecionando a validação da mensagem.

As verificações que podem ser executadas dependem do domínio da mensagem. Consulte a seguinte tabela:
Verificação Domínio
Verifique o domínio de mensagem Todos os domínios
Verifique o conjunto de mensagens MRM e IDOC apenas
Verifique o tipo de mensagem MRM apenas
Valide o corpo da mensagem MRM e IDOC apenas

Você pode verificar a mensagem em um ou mais do domínio da mensagem, conjunto de mensagens ou tipo de mensagens. A propriedade é verificada somente se você selecionar sua caixa de opções correspondente, o que significa que uma propriedade que contém uma cadeia vazia pode ser comparada.

Você pode 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 para o nó Validate a partir do analisador, a propriedade Ação de Falha deve estar configurada como Exceção ou Lista de Exceções. Caso contrário, as falhas de validação serão registradas simplesmente.

Se todas as verificações especificadas passarem, a mensagem será propagada através do terminal Correspondência do nó.

Se alguma verificação falhar, a mensagem será propagada através do terminal Falha. Se o terminal Falha não estiver conectado a algum processamento de tratamento de falha, será emitida uma exceção.

Nota: O nó Validate substitui o nó Verificar que está obsoleto no WebSphere Message Broker Versão 6.0 e em releases subseqüentes. O nó Validate funciona da mesma maneira que o nó Check, mas possui propriedades adicionais de Validação para permitir a validação do conteúdo da mensagem por analisadores que suportam esse recurso.

O nó Validate é representado no workbench pelo seguinte ícone:

Ícone do nó Validate

Utilizando Este Nó em um Fluxo de Mensagens

Você pode utilizar o nó Validate para confirmar se uma mensagem possui as propriedades de gabarito de mensagem corretas e possui o conteúdo válido, antes de permitir a mensagem no restante do fluxo. Isso significa que os nós subseqüentes podem depender da mensagem estar correta sem fazer sua própria verificação de erro.

Você também pode utilizar o nó Validate para assegurar que a mensagem seja roteada apropriadamente através do fluxo de mensagens. Por exemplo, você pode configurá-lo para direcionar uma mensagem que solicita compras de estoque por meio de uma rota diferente da requerida para uma mensagem que solicita a venda de estoque.

Outro exemplo de rota é o recebimento das mensagens eletrônicas de sua equipe no escritório da matriz. Essas mensagens são utilizadas para várias finalidades, por exemplo, para solicitar suporte técnico ou material de papelaria ou para informá-lo sobre novas tendências de seus clientes. Essas mensagens podem ser processadas automaticamente porque sua equipe preencheu um formulário padrão. Se você desejar que estas mensagens sejam processadas separadamente das outras mensagens recebidas, utilize o nó Validate para assegurar-se de que apenas as mensagens da equipe que tenham um tipo de mensagem específico sejam processadas por esse fluxo de mensagens.

Configurando o Nó Validate

Quando tiver colocado uma instância do nó Validate em um fluxo de mensagens, será possível configurá-lo. Clique com o botão direito na visualização do editor clique em Propriedades. As propriedades básicas do nó são exibidas.

Todas as propriedades obrigatórias, para as quais é necessário inserir um valor (aquelas que não possuem um valor padrão definido) são marcadas com um asterisco no diálogo das propriedades.

Configure o nó Validate da seguinte forma:

  1. Para verificar o analisador a ser utilizado para a mensagem de entrada, selecione a caixa Verificar Domínio e escolha um dos seguintes valores a partir da lista drop-down da propriedade Domínio:
    • MRM
    • XML
    • XMLNS
    • XMLNSC
    • JMSMap
    • JMSStream
    • MIME
    • BLOB
    • IDOC
  2. Se estiver utilizando o analisador MRMou IDOC, para verificar se a mensagem de entrada pertence a um determinado conjunto de mensagens, selecione a caixa de opções Verificar Conjunto e escolha um dos valores na lista drop-down da propriedade Conjunto. Essa lista é preenchida quando você escolhe MRM ou IDOC como o domínio de mensagem.

    Deixe Conjunto limpo para os analisadores XML, JMS, MIME e BLOB.

  3. Se você estiver utilizando o analisador MRM para verificar se a mensagem de entrada é um tipo específico de mensagem, selecione a caixa de opções Verificar Tipo e digite o nome da mensagem na propriedade Tipo.

    Deixe o Tipo limpo a menos que esteja utilizando o analisador MRM. Observe que o analisador IDOC obtém automaticamente o tipo de mensagem a partir da mensagem.

  4. Se você estiver utilizando o analisador MRM ou IDOC para validar o corpo das mensagens no dicionário gerado a partir do conjunto de mensagens, selecione as propriedades de validação desejadas a partir do diálogo de propriedades de Validação.

    Para obter mais detalhes, consulte Validando Mensagens e Propriedades de Validação para Mensagens no Domínio MRM.

  5. Selecione Descrição no navegador de diálogo de propriedades para inserir uma descrição breve, uma descrição longa, ou ambas.
  6. Clique em Aplicar para fazer as alterações no nó Validate sem fechar o diálogo de propriedades. Clique em OK para aplicar as alterações e fechar o diálogo de propriedades.

    Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.

Terminais e Propriedades

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ó Validate; a coluna com o título M indica se a propriedade é obrigatória (marcada com um asterisco no diálogo de propriedades se for necessário digitar um valor quando nenhum padrão está definido), a coluna com o título C indica se a propriedade é configurável (é possível alterar o valor ao incluir o fluxo de mensagens no arquivo bar para implementá-lo).

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

Propriedade M C Padrão Descrição
Domínio Não Não   O nome do domínio.
Verificar Domínio Sim Não Não selecionada Determina se é necessário verificar a mensagem de entrada na propriedade de Domínio. Se você selecionar a caixa de opções, esta ação é executada.
Conjunto Não Não   O nome ou identificador do conjunto de mensagens ao qual a mensagem de entrada pertence.
Verificar Conjunto Sim Não Não selecionada Determina se é necessário verificar a mensagem de entrada na propriedade de Conjunto. Se você selecionar a caixa de opções, esta ação é executada.
Tipo Não Não   O identificador de mensagens.
Verificar Tipo Sim Não Não selecionada Determina se é necessário verificar a mensagem de entrada na propriedade de Tipo. Se você selecionar a caixa de opções, esta ação é executada.

As propriedades de Validação do nó Validate são descritas na tabela a seguir. Consulte Propriedades de Validação para Mensagens no Domínio MRM para obter uma descrição completa destas propriedades.

Propriedade M C Padrão Descrição
Validar Sim Sim Nenhum Determina se a validação ocorrerá. Os valores válidos são Nenhum, Conteúdo e Valor e Conteúdo e Herdar.
Ação de Defeito Sim Não Exceção O que acontece 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ção.
Incluir Todas as Limitações do Valor Sim Não Selecionado Essa propriedade não pode ser editada. A ação padrão, indicada pela caixa de opções selecionada, é que as verificações básicas de limitação de valor estão incluídas na validação Conteúdo e Valor.
Corrigir Sim Não Nenhum Essa propriedade não pode ser editada. Os valores válidos são Nenhum e Total.

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

Propriedade M C Padrão Descrição
Descrição Breve 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.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ac20803_