Propriedades de Validação

Você pode controlar a validação definindo propriedades nas guias Validação (Validate) e Opções do Analisador (Parser Options) para os nós listados na tabela a seguir.

As opções de validação estão disponíveis nos seguintes nós:
Tipo de Nó Nós com opções de validação
Nó Input MQInput, SCADAInput, HTTPInput, JMSInput, TimeoutNotification, ,
Nó Output MQOutput, MQReply, SCADAOutput, HTTPReply, JMSOutput, JMSReply, ,
Outros nós Compute, Mapeamento, JavaCompute, Validate, ResetContentDescriptor, MQGet, HTTPRequest, , , ,

Para obter uma visão geral da validação de mensagens no intermediário, consulte Validando Mensagens.

Você pode definir as propriedades mostradas na tabela a seguir.
Guia Propriedades que afetam a validação
Validação Validar, Ação de Falha, Incluir Todas as Limitações de Valor, Corrigir
Opções do Analisador (Parser Options) Sincronização de Análise

Propriedades da Guia Validação

Validar

Define se a validação é requerida. Todos os nós fornecem as seguintes opções:

Nenhum(a)
O valor padrão. A operação não foi executada.
Conteúdo
Indica que você deseja executar verificações de conteúdo, como validação e composição de conteúdo.
Conteúdo e Valor
Indica que você deseja executar verificações de conteúdo, como validação e composição de conteúdo, e verificações de valor, por exemplo, se o valor está de acordo com o tipo de dados, comprimento, intervalo e enumeração.

Alguns nós também fornecem a seguinte opção:

Herdar
Instrui o nó a utilizar todas as opções de validação fornecidas com a árvore de mensagens de entrada em preferência a qualquer uma fornecida no nó. Portanto, Herdar é resolvido para Nenhum, Conteúdo ou Conteúdo e Valor. Se Herdar (Inherit) for selecionado, as demais propriedades de validação na guia não estarão disponíveis.

Ação de Defeito

A ação que deseja que seja executada quando ocorrer uma falha na validação. É possível configurá-la para os seguintes valores:

Exceção
O valor padrão. É emitida uma exceção na primeira falha de validação encontrada. A lista de exceções resultantes é mostrada abaixo. A falha também será registrada no rastreio do usuário, se você tiver solicitado o rastreio do usuário do fluxo de mensagens e a validação for parada. Utilize esta configuração se desejar que o processamento da mensagem seja interrompido logo que uma falha for encontrada.

MRM e IDOCLista de Exceções quando a ação de falha estiver configurada para Exceção

Lista de Exceções
Emite uma exceção se forem encontradas falhas de validação, mas apenas quando a operação atual de análise ou gravação tiver sido concluída. A lista de exceções resultantes é mostrada abaixo. Cada falha também será registrada no rastreio do usuário, se você tiver solicitado o rastreio do usuário do fluxo de mensagens e a validação for parada. Utilize esta configuração se desejar que o processamento da mensagem seja interrompido se ocorrer uma falha de validação, mas se você desejar ver a lista completa de falhas encontradas. Essa propriedade é afetada pela Cronometragem de Análise (Parse Timing); quando a análise parcial é selecionada, a operação de análise atual analisa apenas uma parte de uma mensagem de entrada, de modo que as falhas de validação nessa parte da mensagem são relatadas.

MRM e IDOCLista de Exceções quando a ação de falha estiver configurada para Lista de Exceções

Rastreio do Usuário
Registra todas as falhas de validação no rastreio do usuário, mesmo que você não tenha solicitado o rastreio do usuário do fluxo de mensagens. Utilize esta configuração se desejar que o processamento da mensagem continue, independentemente de falhas de validação.
Registro de Erros Local
Registra todas as falhas de validação no registro de erros (por exemplo, o Registro de Eventos no Windows). Utilize esta configuração se desejar que o processamento da mensagem continue, independentemente de falhas de validação.

Incluir Todas as Restrições de Valores

A caixa de opções está selecionada. Não é possível alterar esta opção.

Incluir Todas as Restrições de Valor especifica quais verificações básicas de restrição de valor devem ser realizadas nos valores dos campos na mensagem quando Validar resolve para Conteúdo e Valor. As verificações desempenhadas são:

  • Comprimento Mínimo
  • Comprimento Máximo
  • Dígitos de Fração
  • Dígitos Totais
  • Mínimo Inclusivo
  • Máximo Inclusivo
  • Mín. Exclusivo (onde suportado)
  • Máx. Exclusivo (onde suportado)
  • Enumeração
  • Padrão

Para obter detalhes adicionais sobre limitações de valores, consulte Restrições de Valores Lógicos de Tipo Simples.

Corrigir

O valor padrão é nenhum. Não é possível alterá-lo.

Nenhum (None) especifica que nenhuma ação corretiva adicional será tomada quando Validar (Validate) for resolvido para Conteúdo (Content) ou Conteúdo e Valor (Content And Value) e ocorrer falhas de validação. A ação corretiva tomada depende da definição de Ação de Falha (Failure Action).

Se Ação com Falha estiver configurado como Rastreio do Usuário ou Registro de Erros Local, a ação corretiva será limitada à ação corretiva padrão que ocorre quando nenhuma validação está sendo desempenhada, conforme descrito em Validando Mensagens:

  • Os campos externos são descartados na saída para formatos fixos (somente modelos de comprimento fixo CWF e TDS).
  • Se o conteúdo obrigatório estiver ausente, serão fornecidos padrões, se disponíveis, na saída para formatos fixos (somente modelos de comprimento fixo CWF e TDS).
  • Se o tipo de dados de um elemento na árvore não corresponder ao especificado no dicionário, o tipo de dados será convertido em saída para corresponder à definição do dicionário, se possível, para todos os formatos.

Se Ação com Falha for set to Exceção ou Lista de Exceções, a ação corretiva será limitada ao terceiro item na lista acima, e será emitida uma exceção para os dois primeiros itens.

Propriedades da Guia Opções do Analisador

Sincronização de Análise

A propriedade Cronometragem de Análise determina se a análise on demand será utilizada durante a análise de uma mensagem. Ela também possibilita o controle sobre o tempo da validação das mensagens de entrada:

  • Se você selecionar um valor de Hora de Análise igual a On Demand, a validação de um campo na mensagem será adiada até ser analisada pela análise on demand.
  • Se você selecionar um valor Imediato para Hora de Análise, a análise on demand é substituída, e tudo na mensagem é analisado e validado, exceto, se o domínio de mensagem for MRM, aqueles tipos complexos com uma Composição de Escolha ou Mensagem que não podem ser resolvidos no momento
  • Se tiver selecionado um valor de Hora de Análise igual a Completo, a análise on demand é substituída e tudo é analisado e validado. Se o domínio de mensagem for MRM, os tipos complexos com uma Composição de Escolha ou Mensagem que não podem ser resolvidos no momento fazem com que a validação falhe.

Se você permitir a validação da mensagem e selecionar On Demand ou Imediato para Hora de Análise, os erros de validação talvez não sejam detectados até o fim do processamento de uma mensagem pelo fluxo de mensagens ou podem nunca ser detectados se uma parte da mensagem nunca tiver sido analisada. Para ter certeza de que todos os campos em uma mensagem sejam validados, selecione Concluído ou, se o domínio de mensagem for MRM, selecione Imediato e certifique-se de que você resolva todos os tipos não resolvidos com uma Composição de Escolha ou Mensagem no início do fluxo de mensagens.

A propriedade Cronometragem de Análise não tem efeito sobre a validação de mensagens de saída.

Referências relacionadas
Nós Internos
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2009Copyright IBM Corporation 1999, 2009.
Última atualização : 2009-02-13 16:11:50

ac18870_