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:
| Verificação | Domínio |
|---|---|
| Verifique o domínio de mensagem | Todos os domínios |
| Verificar conjunto de mensagens | Somente XMLNSC, MRM e IDOC |
| Verificar tipo de mensagem | MRM |
| Valide o corpo da mensagem | Somente XMLNSC, MRM e IDOC |
É possível verificar a mensagem com relação a um ou mais domínio de mensagem, conjunto de mensagens 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ó Check, que está reprovado no WebSphere Message Broker Versão 6.0 e releases 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:
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 subsequentes 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.
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 | 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:
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. |
| Conjunto | Não | Não | O nome ou identificador do conjunto de
mensagens ao qual a mensagem recebida pertence. Se você estiver usando o analisador
XMLNSC, DataObject, SOAP, MRM ou IDOC e quiser verificar se a mensagem recebida pertence
a um determinado conjunto de mensagens, selecione
Verificar conjunto e selecione um dos valores
na lista da propriedade Conjunto.
Essa lista é preenchida quando você seleciona XMLNSC, DataObject, SOAP, MRM ou IDOC como
domínio de mensagem. Deixe Conjunto desmarcado para outros analisadores. Se você configurar esta propriedade, então, subsequentemente atualizar as dependências do projeto para remover esta referência do conjunto de mensagens, um aviso será emitido. Atualize a propriedade Conjunto ou restaure a referência a este projeto de conjunto de mensagens. |
|
| Verificar conjunto | Sim | Não | Não selecionada | Se você marcar a caixa de seleção, a mensagem recebida será verificada com relação à propriedade Conjunto. Se você estiver usando o analisador XMLNSC,DataObject, SOAP, MRM ou IDOC e quiser verificar se a mensagem recebida pertence a um determinado modelo de mensagem, selecione Verificar conjunto e selecione um dos valores na lista da propriedade Conjunto. |
| Tipo | Não | Não | O nome da mensagem. Se você estiver usando o analisador
MRM e quiser verificar se a mensagem recebida é um
tipo de mensagem específico, selecione
Verificar
tipo
e insira o nome da mensagem na propriedade
Tipo. Deixe Tipo desmarcado para os outros analisadores. |
|
| Verificar tipo | Sim | Não | Não selecionada | Se você marcar a caixa de seleção, a mensagem recebida será verificada com relação à propriedade Tipo. Se você estiver usando o analisador MRM e quiser verificar se a mensagem recebida é 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 você estiver usando o analisador XMLNSC, DataObject, SOAP, MRM ou IDOC e quiser validar o corpo de mensagens com 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 | O 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. |
| 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. |