Nó Mapping

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

Finalidade

Utilize o nó Mapping para construir uma ou mais mensagens e ocupá-las com novas informações, com informações modificadas da mensagem de entrada ou com 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 ou criar um mapa de mensagens para o nó pela primeira vez, se você especificar a opção Este mapa é chamado a partir de um nó de fluxo de mensagens e mapeia propriedades e o corpo da mensagem, os cabeçalhos da mensagem de entrada são sempre copiados para a mensagem de saída sem modificação.

Se quiser modificar os cabeçalhos de mensagens em um nó Mapping, você deve selecionar a opção Este mapa é chamado a partir de um nó de fluxo de mensagens e mapeia propriedades, cabeçalhos e o corpo da mensagem. Ao fazer isso, o mapa criado permite que elementos adicionais, incluindo cabeçalhos 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. Você cria os mapeamentos associados a esse nó no arquivo de mapeamento associado a esse nó, mapeando entradas (mensagem ou banco de dados) para saídas. Opcionalmente, você pode modificar as designações feitas por esses mapeamentos, utilizando funções e procedimentos fornecidos ou definidos pelo usuário: por exemplo, você pode converter um valor de cadeia em maiúscula quando designá-lo ao campo de saída da mensagem.

Utilize o nó Mapping para:

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

O nó Mapping é representado no workbench pelo seguinte ícone:

 Ícone do Nó Mapping

Utilizando este nó em um fluxo de mensagens

Examine a seguinte amostra para ver como este nó pode ser utilizado:

Configurando o Nó Mapping

Quando você tiver colocado uma instância do nó Mapping em um fluxo de mensagens, poderá configurá-lo. Clique com o botão direito do mouse na visualização do editor clique em Propriedades. As propriedades básicas do nó são exibidas.

Todas as propriedades obrigatórias, para as quais é necessário inserir um valor (aquelas que não possuem um valor padrão definido) são marcadas com um asterisco no diálogo das propriedades.

Configure o nó Mapping da seguinte forma:

  1. Especifique em Origem de Dados o nome através do qual o banco de dados apropriado será é conhecido no sistema no qual o fluxo de mensagens será executado. O intermediário conecta-se às informações de ID de usuário e senha especificadas no comandomqsicreatebroker, mqsichangebroker oumqsisetdbparms.

    Em sistemas z/OS, o intermediário utiliza o ID da tarefa iniciada ou o ID do usuário e a senha que foram especificados no comando JCL mqsisetdbparms de BIPSDBP, no conjunto de dados de customização <hlq>.SBIPPROC.

  2. Selecione a definição Transação no menu drop down. Os valores são:
    • Automático (o padrão). O fluxo de mensagens, do qual o nó Mapping faz parte, será consolidado se for bem-sucedido. Ou seja, as ações definidas nos mapeamentos são executadas e a mensagem continua no fluxo de mensagens. Se o fluxo de mensagens falhar, ele será revertido. Se você escolher Automático, a capacidade de consolidar ou reverter a ação do nó Mapping no banco de dados dependerá do sucesso ou da falha do fluxo de mensagens inteiro.
    • Consolidar. Se desejar consolidar quaisquer ações não consolidadas executadas nesse fluxo de mensagens no banco de dados conectado a este nó, independentemente do êxito ou defeito do fluxo de mensagens como um todo, selecione Consolidar.As alterações feitas no banco de dados são consolidadas mesmo se o fluxo de mensagens falhar.
  3. Em Rotina de Mapeamento, identifique a rotina de mapeamento que deve ser executada neste nó. Por padrão, o nome designado à rotina de mapeamentos é idêntica ao nome do arquivo de mapeamentos no qual essa rotina é definida. O nome padrão para o arquivo é o nome do fluxo de mensagens concatenado com o nome do nó quando você incluí-lo no fluxo de mensagens (por exemplo, MFlow1_Mapping.mfmap para o primeiro nó Mapping no fluxo de mensagens MFlow1). Você não pode especificar um valor que inclui espaços.

    Se você clicar em Procurar próximo ao campo de entrada, um diálogo é exibido, listando todas as rotinas de mapeamento disponíveis, acessíveis por esse nó. Selecione a rotina desejada e clique em OK. O nome da rotina é definida em Módulo de Mapeamento.

    Para trabalhar com a rotina de mapeamentos associada a esse nó, clique com o botão direito do mouse no nó e selecione Abrir 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ê poderá abrir o arquivo <flow_name>_<node_name>.mfmap na visualização Navegador.

    Uma rotina de mapeamento é específica para o tipo de nó com o qual está associada; não é possível utilizar uma rotina de mapeamento desenvolvida para um nó Mapping com qualquer outro nó que use 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 Desenvolvendo Mapeamentos de Mensagens.

  4. Em Modo de Mapeamento, especifique o modo que deseja utilizar para processar informações que estão sendo passadas pelo nó Mapping. Você pode escolher qualquer combinação dos componentes Message, LocalEnvironment e Exception a ser gerada e modificada pelo nó Mapping.

    Você deve definir essa propriedade para refletir corretamente o formato da mensagem de saída requerido. 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.

    (Em releases anteriores à Versão 2.1, o ambiente associado (Ambiente Local) era conhecido como Lista de Destino. O ambiente Lista de Destino é válido e pode ser utilizado para compatibilidade).

    (O componente Environment da árvore de mensagens não é afetado pela definição do modo. Seu conteúdo, se houver, é transmitido a partir desse nó.)

    As opções são explicadas na tabela a seguir.

    Modo Descrição
    Mensagem (o padrão) A mensagem é gerada ou passada pelo nó Mapping conforme é modificada no nó.
    Ambiente Local A estrutura em árvore Ambiente Local é gerada ou passada pelo nó Mapping conforme é modificada no nó.
    Ambiente Local e Mensagem A estrutura em árvore Ambiente Local e a mensagem são geradas ou passadas pelo nó Mapping conforme são modificadas pelo nó.
    Exceção A Lista de Exceções é gerada ou passada pelo nó Mapping conforme é modificada pelo nó.
    Exceção e Mensagem A Lista de Exceções e a mensagem são geradas ou passadas pelo nó Mapping conforme são modificadas pelo nó.
    Exceção e Ambiente Local A Lista de Exceções e estrutura em árvore Ambiente Local são geradas ou passadas pelo nó Mapping conforme são modificadas pelo nó.
    Todos A mensagem, Lista de Exceções e Ambiente Local são geradas ou passadas pelo nó Mappings conforme são especificadas pelo nó.
  5. Selecione Básico no navegador do diálogo de propriedades e defina ou limpe as caixas de opções:
    • Se quiser que mensagens de aviso do banco de dados sejam tratadas como erros e quiser que o nó propague a mensagem de saída para o terminal de falha, selecione a caixa de opções Tratar Avisos como Erros. A caixa é inicialmente limpa.

      Quando selecionar a caixa, o nó tratará todos os códigos de retorno positivos no banco de dados como erros e gerará exceções da mesma forma que faria para os erros negativos ou mais sérios.

      Se você não selecionar a caixa, 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, que pode ser tratado como um código de retorno normal de forma segura na maioria das circunstâncias.

    • Se desejar que o intermediário gere uma exceção quando for detectado um erro do banco de dados, selecione a caixa de opções Emitir Exceção em Erro do Banco de Dados. A caixa é inicialmente selecionada.

      Se você limpar a caixa, deverá tratar o erro no fluxo de mensagens para assegurar a integridade do intermediário e do banco de dados: o erro será ignorado se você não tratá-lo pelo seu próprio processamento, porque escolheu não chamar o tratamento de erros padrão pelo intermediário. Por exemplo, você pode conectar o terminal failure a uma sub-rotina de processamento de erros.

  6. Selecione Validação no navegador do diálogo de propriedades se desejar que o analisador MRM valide o corpo de mensagens no dicionário gerado a partir do conjunto de mensagens. (Se uma mensagem for propagada para o terminal failure do nó, ela não será validada).

    Para obter mais detalhes, consulte Validando Mensagens e Propriedades de Validação para Mensagens no Domínio MRM.

  7. Selecione Opcionais Gerais de Mensagem no navegador do diálogo de propriedades. Por padrão, Analisar Tempo é configurado como On Demand. Isso causa o retardo da validação até que ela seja analisada pela análise parcial. Se você alterar a opção paraImediata, a análise parcial será substituída e tudo que estiver na mensagem será analisado e validado, exceto os tipos complexos com uma Composição de Opção ou Mensagem que não possam ser resolvidos no momento. Se você alterar a opção paraCompleta, a análise parcial será substituída e tudo que estiver na mensagem será analisado e validado; os tipos complexos com uma Composição de Opção ou Mensagem que não podem ser resolvidos no momento causam a falha da validação.

    Selecione a caixa de opções Utilizar Analisador Compacto QRFH2C para o Domínio MQRFH2 se quiser que o Analisador Compacto MQRFH2C seja utilizado em vez do analisador MQRFH2 para cabeçalhos MQRFH2.

  8. Selecione as opções do XMLNSCparser no navegador do diálogo de propriedades e selecione a caixa de opções Utilizar Analisador Compacto XMLNSC para o Domínio XMLNS se quiser utilizar o analisador XMLNSC para mensagens no Domínio XMLNS.

    Outras propriedades controlam se o analisador XMLNSC é utilizado para texto misto, comentários e instruções de processamento na mensagem de entrada.

  9. Selecione Descrição no navegador de diálogo de propriedades para inserir uma descrição breve, uma descrição longa, ou ambas.
  10. Clique em Aplicar para fazer as alterações no nó Mapping sem fechar o diálogo de propriedades. Clique em OK para aplicar as alterações e fechar o diálogo de propriedades.

    Clique em Cancelar para fechar o diálogo e descartar todas as alterações feitas nas propriedades.

Terminais e Propriedades

Os terminais do nó Mapping 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 exibe a mensagem após a execução dos mapeamentos.

As tabelas a seguir descrevem as propriedades do nó; a coluna com cabeçalho M indica se a propriedade é obrigatória (marcado com um asterisco no diálogo de propriedades 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 no arquivo bar para implementá-lo).

As propriedades Básicas do nó Mapping são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
Fonte de Dados Não Sim   O nome da origem de dados ODBC do banco de dados no qual residem as tabelas as quais foram referidas nos mapeamentos associados a este nó (identificado pela propriedade Módulo de Mapeamento).
Transação Sim Não Automático O modo de transação para o nó. Os valores válidos são Automático ou Consolidar.
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. A rotina é exclusiva para esse tipo de nó.
Modo de Mapeamento Sim Não Mensagem Selecione uma das seguintes opções:
  • Mensagem
  • LocalEnvironment
  • LocalEnvironment e Mensagem
  • Exceção
  • Exceção e Mensagem
  • Exceção e Ambiente Local
  • Todos
Se quiser construir um mapa que propaga várias mensagens de destino, configure essa propriedade para Ambiente Local e Mensagem para assegurar que o nó execute corretamente.
Tratar Avisos como Erros Sim Não Não selecionada Trata aviso SQL do banco de dados como erros. Se você selecionar a caixa de opções, esta ação é executada.
Emitir Exceção em Erro do Banco de Dados Sim Não Selecionada Erros de banco de dados fazem com que o intermediário lance uma exceção. Se você selecionar a caixa de opções, esta ação é executada.

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

Propriedade M C Padrão Descrição
Validar Sim Sim Nenhum Determina se a validação ocorrerá. Os valores válidos são Nenhum, Conteúdo e Valor, Conteúdo e Herdar.
Ação de Defeito Sim Não Exceção O que acontece se ocorrer um defeito de validação. Você poderá configurar esta propriedade apenas se 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.
Incluir Todas as Limitações do Valor Sim Não Selecionada Essa propriedade não pode ser editada. A ação padrão, indicada pela caixa de opções que está sendo selecionada, é que todas as restrições de valores estão incluídas na validação.
Corrigir Sim Não Nenhum Essa propriedade não pode ser editada. É fornecida uma correção mínima. Os valores válidos são Nenhum e Total.

As propriedades das Opções de Mensagens Gerais para o nó Mapping são descritas na tabela a seguir:

Propriedade M C Padrão Descrição
Sincronização de Análise Sim Não On Demand Esta propriedade controla quando uma mensagem de entrada é analisada. Os valores válidos são On Demand, Imediato e Completo.

Consulte Analisando On Demand para obter uma descrição completa dessa propriedade.

Utilizar o Analisador Compacto MQRFH2C para o Domínio MQRFH2 Não Não Falso Esta propriedade controla se o MQRFH2C Compact Parser, no lugar do analisador MQRFH2, é utilizado para cabeçalhos MQRFH2.

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

Propriedade M C Padrão Descrição
Utilizar Analisador Compacto XMLNSC para o Domínio XMLNS Sim Não selecionada Não Início da mudançaA configuração dessa propriedade faz com que a MQRFH2 de saída especifique XMLNS em vez de o 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 tem nenhum efeito.Fim da mudança
Modo de Retenção de Conteúdo Misto Sim Não Nenhum Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar texto misto em uma mensagem de entrada. Os valores válidos são Nenhum e Todos. A seleção de Todos significa que os elementos são criados para o texto misto. A seleção de Nenhum significa que o texto misto é ignorado e nenhum elemento é criado.
Modo de Retenção de Comentários Sim Não Nenhum Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar comentários em uma mensagem de entrada. Os valores válidos são Nenhum e Todos. Selecionar Tudo significa que são criados elementos para comentários. A seleção de Nenhum significa que os comentários são ignorados e nenhum elemento é criado.
Modo de Retenção de Instruções de Processamento Sim Não Nenhum Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar instruções de processamento na mensagem de entrada. Os valores válidos são Nenhum e Todos. Selecionar Tudo significa que são criados elementos para instruções de processamento. A seleção de Nenhum significa que as instruções de processamento são ignoradas e nenhum elemento é criado.

As propriedades de Descrição do nó Mapping são descritas na tabela a seguir.

Propriedade M C Padrão Descrição
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.
Avisos | Marcas Registradas | Downloads | Biblioteca | Suporte | Feedback
Direitos Autorais IBM Corporation 1999, 2006 Última Atualização: 1 Sep 2006
ac04720_