Nó Mapeamento

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

Restrição: As funções fornecidas por esse nó foram substituídas por um Nó Mapeamento revisado. Se você importar um fluxo de mensagens que contenha esta versão do nó Mapeamento, poderá continuar visualizando e implementando o nó, mas não poderá modificá-lo.

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

Finalidade

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 sequência em maiúsculas 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

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
Entrada 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 Padrão Descrição
Nome de nó Não Não O tipo de nó O nome do nó.
Descrição Breve 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 Padrão Descrição Propriedade do Comando mqsiapplybaroverride
Fonte de Dados Não Sim   O nome da origem de dados ODBC do banco de dados que contém as tabelas às quais você se refere nos mapeamentos que estão associados a este nó (identificado pela propriedade Módulo de Mapeamento). Este nome identifica o banco de dados apropriado no sistema no qual este fluxo de mensagens deve ser executado. O broker conecta-se às informações de ID de usuário e senha especificadas no comandomqsicreatebroker, mqsichangebroker oumqsisetdbparms. Se o nome for diferente do nome da origem de dados usado no Editor de Mapeamento, selecione a opção Usar Origem de Dados da Propriedade de Fluxo no diálogo Substituir Origem de Dados e Esquema.

z/OS platform Nos sistemas z/OS, o broker usa o ID de tarefa iniciada do broker ou o ID do usuário e senha especificados na JCL de comando mqsisetdbparms, BIPSDBP no conjunto de dados de customização hlq>.SBIPPROC.

dataSource
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 para o arquivo é o nome do fluxo de mensagens concatenado com o nome do nó quando você o inclui no fluxo de mensagens (por exemplo, MFlow1_Mapping.msgmap 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, você também pode abrir o arquivo <flow_name>_<node_name>.msgmap na visualização Desenvolvimento do Broker.

Uma rotina de mapeamento é específica do tipo de nó ao qual ela está associada; não é possível utilizar uma rotina de mapeamento que tenha sido desenvolvida para um nó Mapeamento com qualquer outro nó que utiliza mapeamentos (por exemplo, um nó DataInsert). 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.

 
Modo de Mapeamento Sim Não Mensagem O modo que é utilizado para processar informações que são transmitidas através do nó Mapeamento. Os valores válidos são:
  • Mensagem (o padrão): a mensagem é gerada ou transmitida pelo nó Mapeamento, conforme modificado no nó.
  • LocalEnvironment: a estrutura em árvore de LocalEnvironment é gerada or transmitida pelo nó Mapeamento, conforme modificado dentro do nó.
  • LocalEnvironment e Mensagem: a estrutura em árvore de LocalEnvironment e a mensagem são geradas ou transmitidas pelo nó Mapeamento, conforme modificado pelo nó.
  • Exceção: a ExceptionList é gerada ou transmitida pelo nó Mapeamento, conforme modificado pelo nó.
  • Exceção e Mensagem: a ExceptionList e a mensagem são geradas ou transmitidas pelo nó Mapeamento, conforme modificado pelo nó.
  • Exceção e LocalEnvironment: as estruturas em árvore de ExceptionList e LocalEnvironment são geradas ou transmitidas pelo nó Mapeamento, conforme modificado pelo nó.
  • Todos: a mensagem, ExceptionList e LocalEnvironment são gerados ou transmitidos pelo nó Mapeamento, conforme modificado pelo nó.

Você deve definir essa propriedade para refletir com precisão o formato da mensagem de saída necessário. Se selecionar uma opção (ou aceitar o valor padrão) que não inclua um determinado componente da mensagem, esse componente não será incluído em qualquer mensagem de saída que for construída.

Você pode escolher qualquer combinação de componentes Mensagem, LocalEnvironment e Exceção a serem gerados e modificados pelo nó Mapeamento. Para construir um mapa que propague várias mensagens de destino, defina essa propriedade como LocalEnvironment e Mensagem (LocalEnvironment And Message) para assegurar a execução correta do nó.

LocalEnvironment era conhecido como DestinationList em algumas versões anteriores; ele é mantido para compatibilidade.

O componente Ambiente da árvore de mensagens não é afetado pela configuração do modo. Seu conteúdo, se houver, é transmitido desse nó.

 
Tratar Avisos como Erros Sim Não Limpo Para que mensagens de aviso do banco de dados sejam tratadas como erros e o nó propague a mensagem de saída para o terminal de falha (Failure), selecione Tratar Avisos como Erros (Treat Warnings as Errors). A caixa de opções fica desmarcada inicialmente.

Quando você selecionar a caixa de opções, o nó tratará todos os códigos de retorno positivos do banco de dados como erros e gerará exceções da mesma forma que faria para os erros negativos ou mais graves. Se você não selecionar a caixa de opções, o nó tratará avisos como códigos de retorno normais e não gerará nenhuma exceção. O aviso mais significativo gerado é não localizado (not found), que pode ser tratado seguramente como código de retorno normal na maioria dos casos.

 
Emitir Exceção em Erro do Banco de Dados Sim Não Selecionada Para fazer com que o broker gere uma exceção quando um erro do banco de dados for detectado, selecione Emitir Exceção em Erro do Banco de Dados (Throw Exception on Database Error). A caixa de opções é selecionada inicialmente. Se você desmarcar a caixa de opções, deverá tratar o erro no fluxo de mensagens para assegurar a integridade do broker e do banco de dados. O erro será ignorado se você não tratá-lo pelo seu próprio processamento, porque você optou por não chamar o tratamento de erro padrão pelo broker. Por exemplo, você pode conectar o terminal de falha (Failure) a uma sub-rotina de processamento de erro.  

As opções do analisador para o nó Mapeamento são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Utilizar Analisador Compacto XMLNSC para o Domínio XMLNS Não Não Limpo Se você selecionar esta caixa de opção, o MQRFH2 de saída especificará XMLNS em vez do analisador XMLNSC, permitindo que um aplicativo externo permaneça inalterado. Se as mensagens de saída não contiverem cabeçalhos MQRFH2, essa propriedade não terá efeito.

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 Padrão Descrição
Validar Não Sim Nenhum(a) 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:01:13


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