WebSphere Message Broker, Versão 8.0.0.5 Sistemas operacionais: AIX, HP-Itanium, Linux, Solaris, Windows, z/OS

Consulte as informações sobre a versão mais recente do produto em IBM Integration Bus, Versão 9.0

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:

Finalidade

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 nova criação do fluxo de bits falhará.

Se você especificar MRM como o novo analisador, também poderá especificar um modelo de mensagem diferente (conjunto de mensagens, tipo de mensagem formato da mensagem). Se você especificar DFDL como o novo analisador, também poderá especificar um Local de Esquema e uma Raiz do Documento diferentes. 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ó 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 em outro; por exemplo, se a mensagem recebida tiver um formato de mensagem XML e o formato da mensagem de saída for binário, 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 reanalisada 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 Construção da paleta e é representado no WebSphere Message Broker Toolkit 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ó subsequente no fluxo de mensagens.

A tabela a seguir mostra propriedades do nó ResetContentDescriptor típicas.
Propriedade Valor
Domínio de mensagem DFDL
Reconfigurar domínio de mensagem Selecionada
Modelo de mensagem MyMessageModel
Reconfigurar modelo de mensagem Selecionada
Message m_MESSAGE1
Reconfigurar mensagem Selecionada
Formato físico  
Reconfigurar Formato Físico Selecionada

O domínio de mensagem é definido como DFDL e o analisador DFDL é iniciado quando a mensagem é analisada em seguida. Modelo de Mensagem e Mensagem são os valores de modelo de mensagem que definem o modelo de mensagem, e todas as caixas de seleção reconfiguradas são selecionadas porque todas as propriedades precisam ser alteradas. O valor da propriedade Modelo de Mensagem é fornecido para você.

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.

No Versão 6.1, não é necessário incluir um nó ResetContentDescriptor após um nó XSLTransform em seu fluxo de mensagens para configurar Domínio de Mensagem, Conjunto de Mensagens, Tipo de Mensagem e Formato de Mensagem da mensagem gerada pelo nó XSLTransform. O nó XSLTransform executa essa função.

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.

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 curta, 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:
      • DFDL
      • XMLNSC
      • DataObject
      • JSON
      • BLOB
      • MIME
      • MRM
      • JMSMap
      • JMSStream
      • XMLNS

      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.

      Se você deixar a propriedade Domínio de mensagem em branco e não selecionar a caixa de opção Reconfigurar domínio de mensagem, o domínio não será reconfigurado. Se você deixar a propriedade Domínio de mensagem em branco e selecionar a caixa de opção Reconfigurar domínio de mensagem, o valor padrão será BLOB.

    2. Se o analisador MRM, XMLNSC ou IDOC tiver que 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 você selecionar uma caixa de opção de reconfiguração para uma propriedade e não tiver especificado um valor para essa propriedade, o valor dessa propriedade será reconfigurado como em branco. Como alternativa, se você tiver especificado um valor para essa propriedade, a propriedade não está em branco. Se você não selecionar a caixa de opção reconfigurar para uma propriedade, o valor dessa propriedade é herdado da mensagem de entrada. Se o analisador já estiver associado à mensagem de entrada, especifique somente as propriedades que deverão ser alteradas.
      1. Defina o Modelo de Mensagem. Escolha um valor da lista de modelos de mensagem disponíveis (o nome e o identificador do modelo de mensagem são mostrados) e selecione a caixa de opção Reconfigurar Modelo de Mensagem.
      2. Para domínios MRM e DFDL, defina o nome da mensagem em Mensagem. Insira o nome e selecione a caixa de opção Reconfigurar Mensagem.
      3. Para MRM e IDOC, defina o Formato Físico. Essa propriedade especifica o formato físico para o analisador. É possível selecionar um dos formatos da lista (que lista os nomes dos formatos definidos no Modelo de Mensagem especificado anteriormente) e selecionar Reconfigurar Formato Físico.

      Essas ações serão tomadas apenas se cabeçalhos adequados existirem. Se a mensagem não tiver um cabeçalho MQRFH2, o nó não criará um.

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

      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 de falha (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
Entrada O terminal de entrada que aceita a mensagem para processamento pelo nó.
Defeito O terminal de saída para o qual a mensagem é roteada, se for detectado um erro pelo nó.
Saída 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ó.
Short description 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.

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 BLOB 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.
Modelo de mensagem Não Não   O nome ou o local do arquivo de esquema de modelo de mensagem no qual a mensagem que você deseja analisar novamente é definida. Essa lista é preenchida com todos os arquivos de esquema de modelo de mensagem disponíveis.
Reconfigurar modelo de mensagem Sim Não Não selecionada Se você marcar a caixa de seleção Reconfigurar, a propriedade Local de Esquema será reconfigurada. Nesse caso, se você não selecionar um valor para a propriedade Local de Esquema, o valor da propriedade Local de Esquema ficará em branco.
Message Não Não   O nome ou o local de um elemento global que modela um documento de dados inteiro e está contido no arquivo de esquema do modelo de mensagem. Essa lista é preenchida com todas as mensagens disponíveis definidas no modelo de mensagem que você selecionou.
Reconfigurar mensagem Sim Não Não selecionada Se você marcar a caixa de seleção Reconfigurar, a propriedade Raiz do Documento será reconfigurada. Nesse caso, se você não selecionar um valor para a propriedade Raiz do Documento, o valor da propriedade Raiz do Documento ficará em branco.
Formato Físico Não Não   Não será necessário selecionar o formato físico da mensagem que você deseja analisar novamente, se estiver usando o domínio DFDL. O formato físico da mensagem é definido no arquivo de esquema DFDL selecionado.
Reconfigurar formato físico Sim Não Não selecionada Se você marcar a caixa de seleção Reconfigurar, a propriedade Formato Físico será reconfigurada. Nesse caso, se você não selecionar um valor para a propriedade Formato Físico, o valor da propriedade Formato Físico ficará 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 cabeçalho MQRFH2 Não Não Não selecionada Esta propriedade controla se o analisador compacto MQRFH2C, em vez do analisador MQRFH2, será utilizado para cabeçalhos MQRFH2.
Construir árvore utilizando tipos de dados de esquema XML Não Não Não selecionada Esta propriedade controla se o analisador XMLNSC cria elementos de sintaxe na árvore de mensagens com tipos de dados retirados do Esquema XML. Você pode selecionar esta propriedades apenas se configurar a propriedade Validar na guia Validação ou Conteúdo ou Conteúdo e Valor.
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 da 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.
Elementos opacos Não Não Em branco Esta propriedade é utilizada para especificar uma lista de elementos na mensagem reanalisada que devem ser analisados de maneira ignorada pelo analisador XMLNSC. A análise ignorada será desempenhada apenas se a validação não estiver ativada (ou seja, se o valor da propriedade Validar estiver configurado como Nenhum); as entradas especificadas em Elementos Ignorados serão ignoradas se a validação estiver ativada.

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 Propriedade do Comando mqsiapplybaroverride
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. validateMaster
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.  
As propriedades Monitoramento do nó são descritas na tabela a seguir.
Propriedade M P Default Descrição
Eventos Não Não Nenhum Eventos definidos para o nó são exibidos nesta guia. Por padrão, nenhum evento de monitoramento é definido em um nó do fluxo de mensagens. Utilize Incluir, Editar, e Excluir para criar, alterar ou excluir eventos de monitoração no nó; consulte Configurando fontes de eventos de monitoramento utilizando propriedades de monitoramento para detalhes.

É possível ativar e desativar eventos mostrados aqui selecionando ou desmarcando a caixa de opções Ativado.

Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2014Copyright IBM Corporation 1999, 2014.

        
        Última atualização:
        
        Última atualização: 2015-02-28 18:28:19


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.5 | ac04810_