É possível usar mapa de dados gráficoss para transformar mensagens de entrada em uma mensagem de saída necessária, usando as funções especificadas no mapa.
É possível usar o Editor de Mapeamento de Dados Gráficos para transformar um conjunto da mensagem, o corpo da mensagem e propriedades, de acordo com as funções de conversão no mapa. Os dados de entrada e de saída devem ser definidos por um modelo de mensagem que define a estrutura dos dados e fornece informações sobre o tipo de dado.
O nó Mapeamento chama uma conversão baseada no mapa. A entrada para o nó Mapeamento é o conjunto da mensagem de entrada que é propagado do nó de envio de dados e a saída é o novo conjunto da mensagem que é criado pela operação de mapeamento e propagado do terminal de saída do nó Mapeamento. O conjunto da mensagem consiste na árvore de propriedades e cabeçalhos e árvores ambiente relevantes, além do corpo da mensagem.
O broker define a estrutura das propriedades e dos cabeçalhos de transporte, e o corpo da mensagem é definido associando-se um modelo de mensagem de entrada, como um esquema DFDL ou XML, ou um Conjunto de Mensagens MRM e um modelo de mensagem de saída. O nó Mapeamento cria uma árvore de saída usando o domínio do analisador de saída especificado como uma propriedade do conjunto de mensagens no mapa. O mapa usa os tipos de esquema dos elementos de saída ao criar e configurar os elementos da árvore de mensagens de saída.
Também é possível configurar a transformação de mapeamento para enriquecer, ou configurar condicionalmente a mensagem de saída com dados de uma tabela de banco de dados. A estrutura de dados da tabela deve ser definida para o mapa e uma cláusula where SQL pode ser usada para selecionar linhas específicas. Os dados de linha resultantes são apresentados como uma entrada adicional no mapa, de acordo com o esquema do banco de dados.
O editor de Mapeamento de Dados Gráficos fornece um conjunto de operações de mapeamento estrutural e funcional, que permitem construir graficamente as transformações de mensagens necessárias para construir a mensagem de saída. Além de transformações de mapeamento principais fornecidas, a aplicável XPath 1,0 e as funções XPath 2,0 estão disponíveis como transformações de mapeamento. Também é fornecido suporte para transformações customizadas, em que é possível construir suas próprias funções XPath 2.0, Java™ ou ESQL, que podem ser chamadas para executar transformações especializadas no mapa. Transformações que suportam controle condicional podem usar expressões XPath 2.0 ou chamar as funções Java ou ESQL. Funções XPath 1.0 são válidas expressões Path 2.0. Você pode usar o XPath Expression Builder para gerar expressões XPath 1,0 simples.
Ao construir seu mapa de transformação, é possível chamar um submapa para executar uma parte da transformação. Isso pode ser usado para permitir a reutilização de transformações comuns para seções do corpo da mensagem ou para o corpo da mensagem inteiro.
O Editor de Mapeamento de Dados Gráficos salva mapas como arquivos .map. Esses arquivos de mapeamento são implementados no tempo de execução do broker para permitir que sejam executados em um fluxo de mensagens. Ao construir e implementar um arquivo BAR de um Aplicativo ou de uma Biblioteca, os arquivos de mapeamento são incluídos automaticamente. Ao implementar recursos independentes, o editor do arquivo BAR fornece uma categoria de recurso para permitir que os mapas sejam selecionados para implementação
Uso de soluções de mapeamento de versões anteriores do WebSphere Message Broker:
É possível importar fluxos de mensagens do WebSphere Message Broker Versão 7.0 e ainda compilar e implementar fluxos de mensagens que usam arquivos de mapa de mensagem (arquivos .msgmap). Entretanto, a partir da Versão WebSphere Message Broker Versão 8.0 em diante, os arquivos de mapa de mensagem são acessíveis no modo somente leitura e não podem ser modificados usando o kit de ferramentas. Se você desejar modificar operações de mapeamento definidas em um mapa de mensagem, deverá primeiro converter o mapa de mensagem em um mapa de dados gráficos (arquivo .map); consulte Convertendo um Mapa de Mensagem de um Arquivo .msgmap para um Arquivo .map.
Preparando mapas de dados gráficos na implementação
No WebSphere Message Broker Versão 8.0.0.4, configurar a variável de ambiente MQSI_PREPARE_MAPS_ON_DEPLOY como TRUE altera o comportamento dos mapas de dados gráficos que são utilizados no fluxo Nó de mapeamento. Quando essa variável é configurada como TRUE, os mapas de dados gráficos são preparados para execução na implementação em vez de quando a primeira mensagem é transmitida através do nó.
Para obter uma lista completa das mudanças que afetam mapas de dados gráficos, consulte Preparando mapas de dados gráficos na implementação.
Os tópicos a seguir fornecem informações sobre mapeamento:
Tópicos de conceitos:
Tópicos de referência: