Utilize o nó ResetContentDescriptor para solicitar que a mensagem seja reanalisada por um analisador diferente.
Este tópico contém as seguintes seções:
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:
O nó ResetContentDescriptor está contido no repositório Construção da paleta e é representado no WebSphere Message Broker Toolkit 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ó subsequente no fluxo de mensagens.
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.
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.
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.
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.
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 |
---|---|
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. |
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. |