Utilize o nó ResetContentDescriptor para solicitar que a mensagem seja reanalisada por um analisador diferente.
Este tópico contém as seguintes seções:
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:
O nó ResetContentDescriptor está contido no repositório Transformação da paleta e é representado no ambiente de trabalho pelo seguinte ícone:
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.
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.
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.
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.
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.
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.
Para obter detalhes adicionais, consulte Validando Mensagens e Propriedades de Validação.
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. |