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ê 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 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 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ó. 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 do arquivo é o nome do fluxo de mensagens
concatenado com o nome do nó quando ele é incluído no fluxo de mensagens (por exemplo, MFlow1_Mapping.map 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, também será possível abrir o arquivo <flow_name>_<node_name>.map na visualização Desenvolvimento do Broker. 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. |
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 | 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. |