Nó Check

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 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 na visualização do editor clique em Propriedades. As propriedades básicas do nó são exibidas.

Todas as propriedades mandató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
    • BLOB

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

  2. Se você estiver utilizando o analisador MRM, verifique se a mensagem de entrada pertence a um determinado conjunto de mensagens, 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 visualização no editor. gera o identificador quando você cria o conjunto de mensagens; é algo como DHHJEQC06U001. Você deve inserir o identificador exatamente conforme mostrado nas propriedades do conjunto de mensagens.

    Deixe Conjunto em branco para os analisadores XML, JMS 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 em branco para os analisadores XML, JMS 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 é mandató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 propriedades é 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 Limpo 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 Limpo 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.
Type Não Não   O identificador de mensagens.
Verificar Tipo Sim Não Limpo 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.

Conceitos relacionados
Fluxos de Mensagem
Modelagem de Mensagens

Tarefas relacionadas
Decidindo Quais Nós Utilizar
Tratando Erros em Fluxos de Mensagens
Validando Mensagens

Referências relacionadas
Nó ResetContentDescriptor