Nó Check

Atenção: O nó Check está obsoleto no WebSphere Message Broker Versão 6.0. Apesar dos fluxos de mensagens que contêm um nó Check permanecerem válidos no WebSphere Message Broker Versão 6.0, quando possível, projete novamente seus fluxos de mensagens de forma que qualquer nó CXheck seja substituído por um nó Validate.

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

Finalidade

Utilize o nó Check 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ó Check. 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ó Check 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ó Check é representado no workbench pelo seguinte ícone:

 Ícone do nó Check

Utilizando este nó em um fluxo de mensagens

Você pode utilizar o nó Check 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ê deseja que elas sejam processadas separadamente das outras mensagens recebidas, utilize o nó Check 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ó Check

Quando tiver colocado uma instância do nó Check em um fluxo de mensagens, será possível configurá-lo. Clique com o botão direito do mouse 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ó Check 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
    • JMSMap
    • JMSStream
    • IDOC
    • MIME
    • BLOB

    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 Descrição no navegador de diálogo de propriedades para inserir uma descrição breve, uma descrição longa, ou ambas.
  5. Clique em Aplicar para fazer as alterações no nó Check 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ó Check 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 (marcado com um asterisco no diálogo de propriedades 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 no arquivo bar para implementá-lo).

As propriedades Básicas do nó Check 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 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 Descrição do nó Check 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.
Referências relacionadas
Nó Validate
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ac04770_