Nó Validate

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

Finalidade

Utilize o nó Validate para comparar a estrutura de uma mensagem recebida em seu terminal de entrada com uma definição de estrutura de mensagem fornecida ao configurar o nó Validate. A definição de estrutura de mensagem abrange o domínio da mensagem, se o domínio da mensagem for MRM, você também poderá especificar qualquer combinação de conjunto de mensagens e tipo da mensagem. O nó Validate verifica apenas a definição da estrutura da mensagem; ele não verifica o corpo da mensagem.

O domínio, conjunto e tipo de mensagem são coletivamente chamados de gabarito da mensagem. O domínio define o analisador que é utilizado para a mensagem. O conjunto é o conjunto de mensagens ao qual a mensagem pertence. O tipo é a estrutura da própria mensagem. Você pode verificar a mensagem de entrada em uma ou mais dessas propriedades. A propriedade da mensagem será verificada apenas se você selecionar sua propriedade de Verificação correspondente, o que significa que uma propriedade de mensagem contendo uma cadeia nula poderá ser comparada.

Se as propriedades da mensagem corresponderem à especificação, a mensagem será propagada através do terminal match do nó. Se as propriedades da mensagem não corresponderem à especificação, a mensagem será propagada por meio do terminal de saída failure. Se o terminal failure não estiver conectado a algum processamento de tratamento de defeitos, será emitida uma exceção.

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 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 utilização desse nó é o recebimento de 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ó Validar 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 digite um dos seguintes valores (em maiúscula) no campo Domínio:
    • MRM
    • XML
    • XMLNS
    • XMLNSC
    • JMSMap
    • JMSStream
    • MIME
    • BLOB
    • IDOC

    Utilize essa opção para verificar se uma mensagem pertence a um determinado domínio.

  2. Se estiver utilizando o analisador MRM ou IDOC, verifique se a mensagem que chega pertence a um conjunto de mensagens específico selecionando a caixa Verificar Conjunto e digitando o identificador do conjunto de mensagens em Conjunto. Esse identificador pode ser localizado nas propriedades do conjunto de mensagens durante sua exibição no editor. O WebSphere Message Broker gera o identificador quando você cria o conjunto de mensagens; é algo semelhante a DHHJEQC06U001. Você deve inserir o identificador exatamente conforme mostrado nas propriedades do conjunto de mensagens.

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

    Utilize essa opção para verificar se uma mensagem pertence a um determinado conjunto.

  3. Se você estiver utilizando o analisador MRM, verifique se a mensagem de entrada é um tipo específico de mensagem, selecionando a caixa Verificar Tipo e digitando o identificador de mensagens em Tipo.

    Esse identificador pode ser localizado nas propriedades da mensagem durante sua visualização no editor. Especifique o identificador de mensagens ao criar a mensagem. Você deve inserir o identificador exatamente conforme mostrado nas propriedades da mensagem.

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

    Utilize essa opção para verificar se uma mensagem corresponde a uma definição específica.

  4. Selecione Validação no navegador do diálogo de propriedades se desejar que o analisador MRM valide o corpo de mensagens no dicionário gerado a partir do conjunto de mensagens. (Se uma mensagem for propagada para o terminal failure do nó, ela não será validada).

    Para obter detalhes adicionais, 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 A O 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 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 A O 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 A O 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.
Referências relacionadas
Nó ResetContentDescriptor
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2005 Última Atualização: 04/11/2005
ac20803_