ResetContentDescriptor

Utilize o nó ResetContentDescriptor para solicitar que a mensagem seja reanalisada por um analisador diferente.

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

Propósito

Se você especificar MRM como o novo analisador, também poderá especificar um modelo de mensagem diferente (conjunto de mensagens, tipo de mensagem e formato de mensagem). Esse nó não reanalisa a mensagem, mas as propriedades definidas para esse nó determinam como a mensagem será analisada na próxima vez em que for reanalisada pelo fluxo de mensagens.

O nó associa as novas informações do analisador ao fluxo de bits da mensagem de entrada. Se a mensagem já foi analisada para criar uma árvore de mensagens, o conteúdo da árvore foi modificado (por exemplo, por um nó Compute), o nó ResetContentDescriptor deve recriar o fluxo de bits a partir da árvore de mensagens, chamando o analisador atual.

Se seu fluxo de mensagens tiver atualizado a mensagem antes de ela ter sido recebida pelo nó ResetContentDescriptor, certifique-se de que o conteúdo da mensagem alterado ainda seja válido para o analisador atual. Se o conteúdo não for válido, o analisador gerará um erro quando tentar recriar o fluxo de bits a partir da árvore de mensagens e o nó ResetContentDescriptor gerará uma exceção. Por exemplo, se você tiver incluído um novo campo em uma mensagem no domínio MRM e o campo não estiver presente no modelo, a recriação do fluxo de bits falhará.

O nó ResetContentDescriptor não:

  • Altere o conteúdo da mensagem; isso altera as propriedades da mensagem para especificar a forma na qual o fluxo de bits é analisado, na próxima vez em que o analisador for iniciado.
  • Converta a mensagem de um formato para outro; por exemplo, se a mensagem de entrada tiver um formato de mensagem XML e o formato da mensagem de saída for CWF, o nó ResetContentDescriptor não fará nenhuma reformatação. Ele inicia o analisador para recriar o fluxo de bits da mensagem XML de entrada, que mantém as marcas de XML na mensagem. Quando a mensagem for reanalizada por um nó subsequente, as tags XML não serão válidas e a reanálise falhará.

O nó ResetContentDescriptor está contido no repositório Transformação da paleta e é representado no ambiente de trabalho pelo seguinte ícone:

 Ícone do nó ResetContentDescriptor

Utilizando este nó em um fluxo de mensagens

Para obter um exemplo de como utilizar esse nó, imagine que você deseja fazer uma troca entre os domínios BLOB e MRM. O formato de uma mensagem de entrada pode ser desconhecido quando ele inserir um fluxo de mensagens. Portanto, o analisador BLOB é iniciado. Posteriormente no fluxo de mensagens, você pode decidir se a mensagem é predefinida como uma mensagem no domínio MRM e pode utilizar o nó ResetContentDescriptor para configurar os valores corretos a serem utilizados quando a mensagem for analisada por um nó subseqüente no fluxo de mensagens.

A tabela a seguir mostra propriedades do nó ResetContentDescriptor típicas.
Propriedade Valor
Domínio de mensagem MRM
Reconfigurar domínio de mensagem Selecionada
Conjunto de Mensagens DH53CU406U001
Reconfigurar conjunto de mensagens Selecionada
Tipo de mensagem m_MESSAGE1
Reconfigurar tipo de mensagem Selecionada
Formato de Mensagem CWF
Reconfigurar formato da mensagem Selecionada

O Domínio de Mensagem é definido como MRM, e o analisador MRM é iniciado quando a mensagem é analisada em seguida. O Conjunto de Mensagens, o Tipo de Mensagem e o Formato de Mensagem são valores do modelo de mensagens que define o modelo de mensagem, e todas as caixas de opções redefinidas são selecionadas porque todas as propriedades precisam de alterações.

O nó ResetContentDescriptor faz o analisador BLOB associado à mensagem de entrada construir o fluxo de bits físico da mensagem (não a representação da árvore lógica dele), que será transmitida ao analisador MRM posteriormente. O analisador MRM analisa o fluxo de bits utilizando o modelo de mensagem (Conjunto de Mensagens, Tipo de Mensagem e Formato de Mensagens) especificado nesse nó ResetContentDescriptor.

Configurando o Nó ResetContentDescriptor

Quando tiver colocado uma instância do nó ResetContentDescriptor em um fluxo de mensagens, será possível configurar o nó. Para obter informações adicionais, consulte Configurando um Nó do Fluxo de Mensagens. As propriedades do nó são exibidas na visualização Propriedades. Para exibir as propriedades do nó no diálogo Propriedades, dê um clique duplo no nó ou clique com o botão direito no nó e clique em 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.

  1. Opcional: Na guia Descrição , digite uma Descrição breve, uma Descrição longa, ou ambas. Você também pode renomear o nó nessa guia.
  2. Na guia Básico:
    1. Para utilizar um analisador diferente associado à mensagem, especifique o novo domínio na propriedade Domínio de Mensagem:
      • MRM
      • XML
      • XMLNS
      • XMLNSC
      • JMS
      • JMSStream
      • IDOC
      • MIME
      • BLOB

      Você também pode especificar um analisador definido pelo usuário, se apropriado.

      Também é necessário selecionar a caixa de opção Reconfigurar domínio de mensagem.

    2. Se o analisador MRM ou IDOC precisar reanalisar a mensagem, especifique as outras propriedades do modelo que devem ser associadas à mensagem de entrada e selecione a caixa de opção de reconfiguração relevante abaixo de cada campo. Se o analisador já estiver associado à mensagem de entrada, especifique somente as propriedades que deverão ser alteradas.
      1. Defina o Conjuntos de Mensagens. Escolha um valor da lista de conjuntos de mensagens disponíveis (o nome e identificador do conjunto de mensagens são mostrados) e selecione a caixa de opção Reconfigurar conjunto de mensagens.
      2. Para MRM apenas, defina o identificador da mensagem em Tipo de Mensagem. Você pode localizar esse identificador nas propriedades da mensagem na visualização do editor. Você especificou o identificador quando criou a mensagem. Digite o identificador exatamente conforme mostrado nas propriedades de mensagem e selecione a caixa de opção Reconfigurar tipo de mensagem.
      3. Para MRM e IDOC, defina o Formato de Mensagem. Essa propriedade especifica o formato físico para o analisador. É possível selecionar um dos formatos da lista (que lista os identificadores desses formatos definidos no Conjunto de Mensagens especificado anteriormente) e selecionar Reconfigurar o Formato da Mensagem.

      Essas propriedades definem os valores de domínio de mensagem, conjunto de mensagens, tipo de mensagens e formato de mensagem no cabeçalho de mensagem que deseja transmitir para o nó ResetContentDescriptor. Entretanto, essas ações só serão tomadas se os cabeçalhos adequados já existirem. Se a mensagem não tiver um cabeçalho MQRFH2, o nó não criará um.

      Deixe em branco Conjunto de Mensagens, Tipo de Mensagem e Formato de Mensagem se você especificou o analisador XML, JMS, MIME ou BLOB.

  3. Na guia Opções de Analisador:
    1. Analisar Tempo é, por padrão, configurado como On Demand, o que faz com que a análise da mensagem seja atrasadas.

      Se você alterar esse valor para Imediato (Immediate), a análise parcial será substituída e tudo o que estiver na mensagem será analisado e validado, exceto aqueles tipos complexos com uma composição de Opção (Choice) ou Mensagem (Message) que não possam ser resolvidos no momento. Se você alterar esse valor para Completo (Complete), a análise parcial será substituída e tudo que estiver na mensagem será analisado e validado; tipos complexos com uma composição de Opção (Choice) ou Mensagem (Message) que não podem ser resolvidos no momento causam falha de validação.

      Para obter mais detalhes, consulte Analisando On Demand.

    2. Selecione Utilizar o analisador compacto MQRFH2C para o cabeçalho MQRFH2 se você desejar que o analisador MQRFH2C seja utilizado. Por padrão, essa caixa de opções fica desmarcada, o que significa que o analisador compacto não é utilizado.
    3. Se você está utilizando o analisador XMLNSC, configure os valores para as propriedades que determinam como o analisador XMLNSC opera. Para obter informações adicionais, consulte Manipulando Mensagens no Domínio XMLNSC.
  4. Na guia Validação, defina as propriedades de validação se você quiser que o analisador valide o corpo das mensagens em relação ao Conjunto de Mensagens. (Se uma mensagem for propagada para o terminal Failure do nó, ela não será validada).

    Para obter detalhes adicionais, consulte Validando Mensagens e Propriedades de Validação.

Terminais e Propriedades

Os terminais do nó ResetContentDescriptor são descritos na tabela a seguir.

Terminal Descrição
In O terminal de entrada que aceita a mensagem para processamento pelo nó.
Failure O terminal de saída para o qual a mensagem é roteada, se for detectado um erro pelo nó.
Out O terminal de saída para o qual a mensagem será roteada se um novo analisador for identificado pelas propriedades.

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ó ResetContentDescriptor são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Nome do Nó Não Não O tipo de nó O nome do nó.
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.

As propriedades Básicas do nó ResetContentDescriptor são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Domínio de mensagem Não Não   O domínio de mensagem que está associado à mensagem que deseja reanalisar.
Reconfigurar domínio de mensagem Sim Não Não Selecionada Se tiver selecionado a caixa de opção reconfigurar, a propriedade Domínio da Mensagem é reconfigurada. Nesse caso, se não selecionar um valor para a propriedade Domínio de Mensagem, o valor da propriedade Domínio de Mensagem é BLOB.
Conjunto de Mensagens Não Não   O conjunto de mensagens que está associado à mensagem que você deseja reanalisar.
Reconfigurar conjunto de mensagens Sim Não Não Selecionada Se você selecionar a caixa de opção reconfigurar, a propriedade Conjunto de Mensagens é reconfigurada. Nesse caso, se você não selecionar um valor para a propriedade Conjunto de Mensagens, o valor da propriedade Conjunto de Mensagens fica em branco.
Tipo de mensagem Não Não   O tipo de mensagem que está associado à mensagem que você deseja reanalisar.
Reconfigurar tipo de mensagem Sim Não Não Selecionada Se tiver selecionado a caixa de opção reconfigurar, a propriedade Tipo de Mensagem é reconfigurada. Nesse caso, se você não selecionar um valor para a propriedade Tipo de Mensagem, o valor da propriedade Tipo de Mensagem fica em branco.
Formato de Mensagem Não Não   O formato da mensagem que está associado à mensagem que deseja reanalisar.
Reconfigurar formato da mensagem Sim Não Não Selecionada Se você selecionar a caixa de opção reconfigurar, a propriedade Formato da Mensagem é reconfigurada. Nesse caso, se você não selecionar um valor para a propriedade Formato da Mensagem, o valor da propriedade Formato da Mensagem fica em branco.

As propriedades Opções de Analisador do nó ResetContentDescriptor são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Cronometragem de análise (Parse timing) Não Não Sob Demanda Esta propriedade controla quando a mensagem reanalisada é analisada. Os valores válidos são On Demand, Imediato e Completo.

Para obter uma descrição completa desta propriedade, consulte Analisando On Demand.

Utilizar analisador compacto MQRFH2C para domínio MQRFH2 Não Não Não Selecionada Esta propriedade controla se o MQRFH2C Compact Parser, no lugar do analisador MQRFH2, é utilizado para cabeçalhos MQRFH2.
Utilizar analisador compacto XMLNSC para domínio XMLNS Não Não Não Selecionada Essa propriedade controla se o Analisador Compacto XMLNSC (XMLNSC Compact Parser) é utilizado para mensagens no Domínio XMLNS (XMLNS Domain). Se você definir essa propriedade, os dados de mensagem serão exibidos em XMLNSC nos nós que estão conectados ao terminal de saída quando o cabeçalho MQRFH2 de entrada ou o Domínio for XMLNS.
Reter conteúdo misto Não Não Não Selecionada Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens quando encontra texto combinado na mensagem reanalisada. Se você selecionar a caixa de opções, serão criados elementos para texto misto. Se você desmarcar a caixa de opções, texto misto será ignorado e nenhum elemento será criado.
Reter comentários Não Não Não Selecionada Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens quando encontra comentários na mensagem reanalisada. Se você selecionar a caixa de opções, serão criados elementos para comentários. Se você desmarcar a caixa de opções, comentários serão ignorados e nenhum elemento será criado.
Reter instruções de processamento Não Não Não Selecionada Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens quando encontra instruções de processamento na mensagem reanalisada. Se você selecionar a caixa de opções, serão criados elementos para instruções de processamento. Se você desmarcar a caixa de opções, instruções de processamento serão ignoradas e nenhum elemento será criado.

As propriedades Validação do nó ResetContentDescriptor são descritas na tabela a seguir. Para obter uma descrição completa destas propriedades, consulte Propriedades de Validação.

Propriedade M C Padrão Descrição
Validate Não Sim Nenhum Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum, Conteúdo, Conteúdo e Valor e Herdar.
Ação de falha Não Não Exception Essa propriedade controla o que acontecerá se a validação falhar. Você pode configurar esta propriedade apenas se configurar Validar como Conteúdo e Valor ou Conteúdo. Os valores válidos são Rastreio do Usuário, Registro de Erros Local, Exceção e Lista de Exceções.
Inclusão de todos Valores de Tipo Não Não Selecionada Não é possível editar essa propriedade. Se essa caixa de opções for selecionada, verificações básicas de limitação de valor serão incluídas na validação Conteúdo e Valor (Content and Value).
Correção Não Não Nenhum Não é possível editar essa propriedade. Os valores válidos são Nenhum e Total.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

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

ac04810_