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:
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ê selecionar esta propriedade, o mapa que é criado permitirá que elementos adicionais, incluindo o 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:
O nó Mapeamento está contido no repositório Transformação da paleta e é representado no ambiente de trabalho pelo seguinte ícone:
Você pode visualizar amostras apenas quando utilizar o centro de informações integrado ao Message Brokers Toolkit.
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. Para exibir as propriedades do nó do diálogo Propriedades, clique com o botão direito do mouse no nó e clique em Propriedades. (Se você der um clique duplo no nó Mapeamento, abrirá a caixa de diálogo Novo Mapa de Mensagem.) 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ó. |
Failure | O terminal de saída 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. |
Out | 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 (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 do 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 |
---|---|---|---|---|
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 intermediário conecta-se às informações de ID de usuário e senha especificadas no comandomqsicreatebroker, mqsichangebroker oumqsisetdbparms.
|
|
Transação | Sim | Não | Automático | O modo de transação para o nó. Os valores são:
|
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 Intermediário. 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 Desenvolvendo Mapeamentos de Mensagens. |
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:
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 | Não Selecionada | 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 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 intermediário 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 intermediário 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 intermediário. Por exemplo, você pode conectar o terminal 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 |
---|---|---|---|---|
Sincronização de Análise | Não | Não | On Demand | Esta propriedade controla quando uma mensagem de entrada é analisada.
Os valores
válidos são On
Demand,
Imediato e
Completo. Para obter uma descrição completa desta propriedade, consulte Analisando On Demand. Tempo de Análise é, por padrão, configurado como On Demand, o que faz com que a validação seja atrasada até que ela seja analisada pela análise parcial. Se você alterar esse valor para Imediato (Immediate), a análise parcial será substituída e tudo o que estiver na mensagem será analisado e validado, exceto aqueles tipos complexos com uma composição de Opção (Choice) ou Mensagem (Message) que não possam ser resolvidos no momento. Se você alterar esse valor para Completo (Complete), a análise parcial será substituída e tudo que estiver na mensagem será analisado e validado; tipos complexos com uma composição de Opção (Choice) ou Mensagem (Message) que não podem ser resolvidos no momento causam falha de validação. |
Utilizar Analisador Compacto XMLNSC para o Domínio XMLNS | Não | Não | Não Selecionada | 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. |
Reter Conteúdo Misto (Retain Mixed Content) | Não | Não | Não Selecionada | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar texto misto em uma mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para texto misto. Se você desmarcar a caixa de opções, texto misto será ignorado e nenhum elemento será criado. |
Reter Comentários (Retain Comments) | Não | Não | Não Selecionada | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar comentários em uma mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para comentários. Se você desmarcar a caixa de opções, comentários serão ignorados e nenhum elemento será criado. |
Reter Instruções de Processamento (Retain Processing Instructions) | Não | Não | Não Selecionada | Esta propriedade controla se o analisador XMLNSC cria elementos na árvore de mensagens ao encontrar instruções de processamento na mensagem de entrada. Se você selecionar a caixa de opções, serão criados elementos para instruções de processamento. Se você desmarcar a caixa de opções, instruções de processamento serão ignoradas e nenhum elemento será criado. |
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 | 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 | Exception | 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. |
Incluir Todas as Limitações do Valor | Não | Não | Selecionada | Não é possível editar essa propriedade. Se a caixa de opções for selecionada (o padrão), todas as limitações de valor serão incluídas na validação. |
Correção | Não | Não | Nenhum | Não é possível editar essa propriedade. É fornecida uma correção mínima. Os valores válidos são Nenhum (None) e Completo (Full). |