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:
É 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:
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:
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.
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.