Nó Mapeamento

Utilize o nó Mapeamento para construir uma ou mais novas mensagens e preenchê-las com vários tipos de informações.

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

Propósito

Você pode preencher as novas mensagens com os seguintes tipos de informações:
  • Novas informações
  • Informações modificadas da mensagem de entrada
  • Informações extraídas de um banco de dados
Você pode modificar elementos dos dados do corpo da mensagem, seu ambiente associado e sua lista de exceção.

Ao abrir pela primeira vez ou criar um mapa de mensagens para o nó, se você selecionar Este mapa é chamado de um nó de fluxo de mensagens e mapeia propriedades e o corpo da mensagem (This map is called from a message flow node and maps properties and message body), os cabeçalhos na mensagem de entrada serão sempre copiados na mensagem de saída sem modificação. Para modificar os cabeçalhos da mensagem em um nó Mapeamento, selecione Este mapa é chamado a partir de um nó do fluxo de mensagens e mapeia propriedades, cabeçalhos e corpo da mensagem. Quando você seleciona essa propriedade, o mapa que é criado permite que elementos adicionais, incluindo os cabeçalhos do WebSphere® MQ, HTTP e JMS, sejam mapeados.

Esses componentes da mensagem de saída podem ser definidos utilizando mapeamentos que são baseados em elementos da mensagem de entrada e de dados de um banco de dados externo. Crie os mapeamentos associados a esse nó, no arquivo de mapeamento associado a esse nó, mapeando entradas (mensagem ou banco de dados) para saídas. Você pode modificar as designações feitas por esses mapeamentos utilizando funções e procedimentos fornecidos ou definidos pelo usuário; por exemplo, é possível converter uma valor de cadeia em maiúsculo ao designá-lo para o campo de saída de mensagem.

Utilize o nó Mapeamento para:

  • Construir uma nova mensagem
  • Copiar mensagens entre analisadores
  • Transformar uma mensagem de um formato para outro

O nó Mapeamento está contido no repositório Transformação da paleta e é representado no WebSphere Message Broker Toolkit pelo seguinte ícone:

 Ícone do Nó Mapping

Utilizando Este Nó em um Fluxo de Mensagens

Examine a amostra a seguir para ver como utilizar esse nó:
  • Mapeamento de Dados Gráficos

Você só pode visualizar informações sobre amostras quando usa o centro de informações que está integrado ao WebSphere Message Broker Toolkit ou o centro de informações on-line. Você só poderá executar amostras quando usar o centro de informações que está integrado ao WebSphere Message Broker Toolkit.

Terminais e Propriedades

Quando tiver colocado uma instância do nó Mapeamento em um fluxo de mensagens, você poderá configurá-lo; 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.

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

Terminal Descrição
In O terminal de entrada que aceita a mensagem para processamento pelo nó.
Defeito O terminal de saía para qual a mensagem de entrada será propagada caso seja detectada uma falha durante o cálculo. Se tiver selecionado Tratar Avisos como Erros, o nó propagará a mensagem para esse terminal se as mensagens de aviso do banco de dados forem retornadas, apesar do processamento ter sido concluído com êxito.
Saída O terminal de saída que propaga a mensagem seguindo a conclusão dos mapeamentos.

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

Propriedade M C O padrão Descrição
Nome do Nó Não Não O tipo de nó O nome do nó.
Descrição Curta 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ó Mapeamento são descritas na tabela a seguir.

Propriedade M C O padrão Descrição Propriedade do Comando mqsiapplybaroverride
Transação SIM Não Automático O modo de transação para o nó. Os valores são:
  • Automático (o padrão). O fluxo de mensagens, do qual o nó Mapeamento faz parte, será confirmado se for bem-sucedido, ou seja, as ações definidas nos mapeamentos são desempenhadas e a mensagem continua por meio do fluxo de mensagens. Se o fluxo de mensagens falhar, ele será revertido. Se você escolher Automático, a capacidade para confirmar ou recuperar a ação do nó Mapeamento no banco de dados dependerá do êxito ou falha de todo o fluxo de mensagens.
  • Consolidar. Para confirmar qualquer ação não confirmada executada nesse fluxo de mensagens no banco de dados conectado a esse nó, independentemente do êxito ou da falha do fluxo de mensagens como um todo, selecione Confirmar (Commit). As alterações feitas no banco de dados são consolidadas mesmo se o fluxo de mensagens falhar.
 
Rotina de Mapeamento SIM Não Mapeamento O nome da rotina de mapeamento que contém as instruções a serem executadas na árvore de mensagens ou no banco de dados. Por padrão, o nome designado à rotina de mapeamento é idêntico ao nome do arquivo de mapeamento no qual a rotina é definida. O nome padrão do arquivo é o nome do fluxo de mensagens concatenado com o nome do nó quando ele é incluído no fluxo de mensagens (por exemplo, MFlow1_Mapping.map para o primeiro nó Mapeamento no fluxo de mensagens MFlow1). Você não pode especificar um valor que inclui espaços.

Se você clicar em Procurar próximo a este campo de entrada, uma caixa de diálogo será exibida, listando todas as rotinas de mapeamento disponíveis que este nó pode acessar. Selecione a rotina desejada e clique em OK; o nome da rotina é definido em Módulo de Mapeamento (Mapping Module).

Para trabalhar com a rotina de mapeamento associada a esse nó, dê um clique duplo no nó ou clique com o botão direito do mouse no nó e clique em Abrir Mapeamentos (Open Mappings). Se a rotina de mapeamento não existir, ela será criada com o nome padrão no arquivo padrão. Se o arquivo já existir, também será possível abrir o arquivo <flow_name>_<node_name>.map na visualização Desenvolvimento do Broker.

Se você criar uma rotina de mapeamento, não será possível chamá-la a partir de outra rotina de mapeamento, embora seja possível chamá-la a partir de uma rotina ESQL.

Para obter informações adicionais sobre o trabalho com os arquivos de mapeamento, e a definição de seu conteúdo, consulte Usando Mapas de Dados Gráficos.

 

As propriedades Validação do nó Mapeamento são descritas na tabela a seguir.

Se uma mensagem for propagada para o terminal Failure do nó, ela não será validada. Essas propriedades não fazem com que a mensagem de entrada seja validada. É esperado que, se tal validação for requerida, ela já tenha sido executada pelo nó input ou por um nó de validação anterior. Para obter detalhes adicionais sobre como validar mensagens e propriedades de validação, consulte Validando Mensagens e Propriedades de Validação.

Propriedade M C O padrão Descrição
Validar Não SIM Nenhum Essa propriedade controla se a validação ocorre. Os valores válidos são Nenhum, Conteúdo e Valor, Conteúdo e Herdar.
Ação de Defeito Não Não Exceção Essa propriedade controla o que acontecerá se uma falha de validação ocorrer. Você pode configurar esta propriedade apenas de Validar estiver configurado como Conteúdo ou Conteúdo e Valor. Os valores válidos são Rastreio do Usuário, Registro de Erros Local, Exceção e Lista de Exceções.
Avisos | Marcas | Este link é aberto em uma nova janela Downloads | Este link é aberto em uma nova janela Biblioteca | Este link é aberto em uma nova janela Suporte | Feedback

Copyright IBM Corporation 1999, 2011Copyright IBM Corporation 1999, 2011.

        
        Última atualização
        
        Última atualização : 2011-11-09 14:41:18


Tópico de ReferênciaTópico de Referência | Versão 8.0.0.0 | bc28600_