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

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

É possível modificar elementos dos dados do corpo da mensagem, a árvore de ambiente local e a pasta de propriedades.

O nó Mapeamento passa através da árvore ExceptionList da mensagem de entrada inalterada.

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

Veja as amostras a seguir para consultar sobre como utilizar este 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ó. O valor suportado para o nó é Automatic.

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.

 
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. Esta propriedade pode ser substituída dinamicamente configurando uma rota de mapeamento no ambiente local. Consulte o Selecionando Dinamicamente um mapa de dados gráficos.

Para trabalhar com a rotina de mapeamento associada a esse nó, clique duas vezes no nó ou clique com o botão direito 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.

 

É possível configurar as propriedades Validação em um nó Mapeamento para as mensagens de saída. Essas propriedades serão decididas quando a mensagem for serializada, ou seja, quando a árvore lógica que representa a mensagem for formatada em seu formato de fluxo de bits físico.

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.

As propriedades Validação do nó Mapeamento estão descritas na tabela a seguir:

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.

Se uma mensagem for propagada para o terminal Failure do nó, ela não será validada.

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:30:56


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