Este tópico contém as seguintes seções:
Utilize o nó Validate 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ó Validate. 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ó Validate 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ó Validate é representado no workbench pelo seguinte ícone:
Você pode utilizar o nó Validate 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ê desejar que estas mensagens sejam processadas separadamente das outras mensagens recebidas, utilize o nó Validar 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.
Quando tiver colocado uma instância do nó Validate 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 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ó Validate da seguinte forma:
Utilize essa opção para verificar se uma mensagem pertence a um determinado domínio.
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.
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.
Para obter detalhes adicionais, consulte Validando Mensagens e Propriedades de Validação para Mensagens no Domínio MRM.
Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.
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ó Validate; a coluna com o título M indica se a propriedade é obrigatória (marcada com um asterisco no diálogo de propriedades se for necessário digitar um valor quando nenhum padrão está definido), a coluna com o título C indica se a propriedade é configurável (é possível alterar o valor ao incluir o fluxo de mensagens no arquivo bar para implementá-lo).
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. | |
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 Validação do nó Validate são descritas na tabela a seguir. Consulte Propriedades de Validação para Mensagens no Domínio MRM para obter uma descrição completa destas propriedades.
Propriedade | M | A | O padrão | Descrição |
---|---|---|---|---|
Validar | Sim | Sim | Nenhum | Determina se a validação ocorrerá. Os valores válidos são Nenhum, Conteúdo e Valor e Conteúdo e Herdar. |
Ação de Defeito | Sim | Não | Exceção | O que acontece 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ção. |
Incluir Todas as Limitações do Valor | Sim | Não | Selecionado | Essa propriedade não pode ser editada. A ação padrão, indicada pela caixa de opções selecionada, é que as verificações básicas de limitação de valor estão incluídas na validação Conteúdo e Valor. |
Corrigir | Sim | Não | Nenhum | Essa propriedade não pode ser editada. Os valores válidos são Nenhum e Total. |
As propriedades de Descrição do nó Validate são descritas na tabela a seguir.
Propriedade | M | A | O 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. |