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). 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 | MRM |
| Reconfigurar domínio de mensagem | Selecionada |
| Conjunto de Mensagens | MyMessageSet |
| Reconfigurar conjunto de mensagens | Selecionada |
| Tipo de mensagem | m_MESSAGE1 |
| Reconfigurar tipo de mensagem | Selecionada |
| Formato de Mensagem | Text1 |
| 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.
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 informações adicionais, consulte . 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. |
| Conjunto de Mensagens | Não | Não | O conjunto de mensagens que está associado à mensagem que você deseja reanalisar. Se você configurar esta propriedade e, posteriormente, atualizar as dependências do projeto para remover esta referência do conjunto de mensagens, será emitido um aviso. Atualize a propriedade Conjunto de Mensagens ou restaure a referência para este projeto de conjunto de mensagens. |
|
| 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. Se você configurar a propriedade Domínio de Mensagem como DataObject, poderá configurar esta propriedade como XML ou SAP ALE IDoc. Configure esta propriedade como SAP ALE IDoc quando precisar analisar um fluxo de bits a partir de uma origem externa e gere uma árvore de mensagens. | |
| 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 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. |