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.

Quando você cria um mapa de mensagem para o nó, o mapa pode conter tabelas de mensagens e de banco de dados como entradas e saídas. Propriedades e, opcionalmente, cabeçalhos (WebSphere® MQ, HTTP e JMS) e o LocalEnvironment também podem ser 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 suporta uma substituição de LocalEnvironment para o script de mapeamento, que permite selecionar dinamicamente o mapa que será executado. O nome do mapa especificado na mensagem de entrada é usado no lugar daquele configurado no nó Mapeamento. Exemplo:
SET OutputLocalEnvironment.Mapping.MappingRoutine =
   ‘{http://www.ibm.com/mimapper}:mapper_po';

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ó:

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 é:
{default_broker_schema}:default_map_file name with no extension
Em que default_broker_schema é o esquema do broker em que o fluxo de mensagens está localizado e em que default_map_file_name_with_no_extension é o nome do fluxo de mensagens, concatenado com o nome do nó de mapeamento. Por exemplo, {your.broker.schema}:yourFlowName1_yourNodeName1. Observe que não é possível 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 é configurado na propriedade Rotina de Mapeamento.

Para trabalhar com a rotina de mapeamento associada a esse nó, clique duas vezes no nó ou clique com o botão direito do mouse no nó e clique em Abrir Mapa. Se a rotina de mapeamento não existir, o assistente de Novo Mapa de Mensagem será aberto com alguns valores padrão inseridos. Se a rotina de mapeamento já existir, ele será aberto no editor de Mapeamento Gráfico. Também é possível abrir a rotina de mapeamento na visualização Desenvolvimento do Broker e clicar duas vezes nela para abrir a rotina no editor de Mapeamento Gráfico.

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 Registradas | Downloads | Biblioteca | Suporte | Feedback

Copyright IBM Corporation 1999, 2012Copyright IBM Corporation 1999, 2012.

        
        Última atualização
        
        Última atualização : 2012-07-17 10:05:49


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