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