Validate

Utilize o nó Validate para verificar se a mensagem que chega em seu terminal de entrada está conforme o esperado. Você pode utilizar este nó para verificar se a mensagem possui as propriedades do modelo de mensagem esperadas (o domínio de mensagem, conjunto de mensagens e tipo de mensagem) e para verificar se o conteúdo da mensagem está correto selecionando a validação da mensagem.

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

Propósito

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
Verifique o conjunto de mensagens Apenas MRM e IDOC
Verifique o tipo de mensagem MRM apenas
Valide o corpo da mensagem XMLNSC, MRM e IDOC apenas

Você pode verificar a mensagem em um ou mais domínio, conjunto ou tipo de mensagem. 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 substituiu o nó Verificar, que está reprovado no WebSphere Message Broker Versão 6.0 e releases subseqüentes. O nó Validate funciona da mesma maneira que o nó Verificar, 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 ambiente de trabalho 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. Para exibir as propriedades do nó no diálogo Propriedades, dê um clique duplo no nó ou clique com o botão direito no nó e clique em 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
In O terminal de entrada que aceita a mensagem para processamento pelo nó.
Failure O terminal de saída para o qual a mensagem será roteada se a mensagem de entrada não corresponder às propriedades especificadas.
Match 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ó.
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.

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. Selecione um dos seguintes valores na lista da propriedade Domínio:
  • MRM
  • XMLNSC
  • XMLNS
  • JMSMap
  • JMSStream
  • MIME
  • BLOB
  • XML
  • IDOC
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.
Conjunto Não Não   O nome ou identificador do conjunto de mensagens ao qual a mensagem de entrada pertence. Se você estiver utilizando o analisador MRM ou IDOC e quiser verificar se a mensagem que chega pertence a um conjunto de mensagens específico, selecione Verificar Conjunto e selecione um dos valores na lista da propriedade Conjunto. Essa lista é preenchida quando você seleciona MRM ou IDOC como o domínio de mensagem.

Deixe Conjunto desmarcado para outros analisadores.

Verificar conjunto Sim Não Não Selecionada Se você selecionar a caixa de opção, a mensagem que chega será verificada em relação à propriedade Conjunto. Se você estiver utilizando o analisador MRM ou IDOC e quiser verificar se a mensagem que chega pertence a um conjunto de mensagens específico, selecione Verificar Conjunto e selecione um dos valores na lista da propriedade Conjunto.
Tipo Não Não   O nome da mensagem. Se estiver utilizando o analisador MRM e quiser verificar se a mensagem de entrada é de um tipo de mensagem específico, selecione Verificar Tipo e insira o nome da mensagem na propriedade Tipo.

Deixe Tipo desmarcado para outros analisadores.

Verificar tipo Sim Não Não Selecionada Se você selecionar a caixa de opção, a mensagem que chega será verificada em relação à propriedade Tipo. Se estiver utilizando o analisador MRM e quiser verificar se a mensagem de entrada é de um tipo de mensagem específico, selecione Verificar Tipo e insira o nome da mensagem na propriedade Tipo.

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

Se estiver utilizando o analisador MRM ou IDOC e quiser validar o corpo das mensagens em relação ao conjunto de mensagens, 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
Validar Não Sim Nenhuma Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum, Conteúdo e Valor, Conteúdo e Herdar.
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.
Incluir Todas as Limitações do Valor Sim Não Selecionado Não é possível editar essa propriedade. As verificações de limitação de valor básico estão incluídas na validação de Conteúdo e Valor.
Correção Sim Não Nenhuma Os valores válidos são Nenhum e Total.
Referências relacionadas
Propriedades de Validação
Nó Verificar
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

ac20803_