Avançar para a área de conteúdo

ir para o conteúdo principal

developerWorks Brasil  >  WebSphere  >

Projetando, desenvolvendo e implementando artefatos WebSphere Transformation Extender para WebSphere Message Broker

developerWorks
Opções de documento

Opções de documento que necessitam de JavaScript não são exibidas


Classificar esta página

Ajude-nos a melhorar este conteúdo


Nível: Intermediário

Ashwin Gupta, WebSphere Message Broker Post-GA Test, IBM
Avinash Jhawar, WebSphere Message Broker Post-GA Test, IBM
Rashmi Katagall, WebSphere Message Broker Post-GA Test, IBM

15/Jul/2009

O WebSphere Transformation Extender é um mecanismo universal de transformação e validação de dados que atende aos desafios da integração de sistemas e informações corporativas com uma abordagem gráfica sem códigos para o desenvolvimento. O WebSphere Transformation Extender para WebSphere Message Broker estende a capacidade do WebSphere Message Broker de transformar mensagens com nós de processamento, com um nó adicional que contém o mecanismo WebSphere Transformation Extender. Este artigo mostra como usar o WebSphere Transformation Extender com WebSphere Message Broker para converter integrações entre aplicativos (A2A), entre empresas (B2B) e entre consumidor e empresa (C2B) que sejam acionadas por eventos em fluxos de mensagem de fácil desenvolvimento e manutenção.

Apresentação

Este artigo mostra também diferentes formas de projetar e desenvolver fluxos de mensagens usando o nó de mapas IBM® WebSphere® Transformation Extender (daqui em diante chamado WebSphere TX) fornecido no WebSphere Message Broker V6.1 (daqui em diante chamado Message Broker). O desenvolvimento é abordado passo a passo, a fim de auxiliar os novos usuários, embora os leitores já devam ter algum conhecimento do WebSphere Message Broker e do WebSphere Transformation Extender, incluindo o design e desenvolvimento de mapas do WebSphere TX.

Pré-requisitos

Para usar o recurso WebSphere TX com o poder do Message Broker, é necessário ter os seguintes softwares instalados:

  • WebSphere Message Broker V6.1.0.2
  • WebSphere TX Design Studio V8.2.0.3
  • WebSphere TX para Integration Servers V8.2.0.3
  • WebSphere TX Library V8.2.0.3 (opcional)

São necessários alguns tipos de mapas de exemplo para serem usados com as etapas descritas neste artigo.

Visão geral do nó WTX Map

O nó WTX Map é um componente do WebSphere TX para Message Broker, fornecido com o WebSphere TX para Integration Servers e disponibilizado para uso nos fluxos de mensagem do Message Broker. Esse nó executa um mapa WebSphere TX em um fluxo de mensagens. O nó WTX Map usa uma ou mais árvores de mensagens do Message Broker como sua entrada, executa o mapa do WebSphere TX especificado e cria uma ou mais árvores de mensagens do Message Broker como sua saída.

O mapa executado pelo nó WTX Map pode ser um mapa compilado pré-implementado para o intermediário, ou um mapa de origem compilado quando o fluxo de mensagens é adicionado a um broker archive (BAR) e implementado como parte da implementação do broker archive. O mapa pode ter várias placas de entrada, mas o nó WTX Map tem apenas um único terminal de entrada. A mensagem chega ao terminal de entrada e, em seguida, a placa de entrada pré-atribuída adequada seleciona a mensagem internamente e a mapeia.

Se a árvore de mensagens que chegar ao terminal de entrada for composta por uma única mensagem, é necessário selecionar a placa de entrada que recebe a mensagem. Se a árvore de mensagens for uma coleção que contém várias mensagens, cada mensagem nessa coleção é entregue à placa de entrada adequada. Em seguida, o nó WTX Map executa o mapa.

O WebSphere TX vem de um histórico diferente e tem pontos fortes distintos se comparados ao Message Broker. Tem um legado no processamento de grandes estruturas de arquivos, e pode oferecer recursos de transformação de dados complexos para todos os formatos de dados estruturados e semiestruturados, incluindo tipos mistos. Além disso, o WebSphere TX é mais adequado ao tratamento de formatos personalizados de mensagens marcadas ou de uma combinação entre os tipos marcado e binário. Por fim, o WebSphere TX se adapta bem a grandes estruturas de arquivos. Juntos, o WebSphere TX e o Message Broker oferecem uma combinação exclusiva no mercado, graças à sua abrangência e profundidade.

Usando o nó WTX Map em um fluxo de mensagens

Ao desenvolver um fluxo de mensagens, é possível configurar um nó WTX Map que executa um mapa com apenas uma placa de entrada ou com várias placas de entrada. As atividades do uso do nó WTX Map em um fluxo de mensagens incluem:

  • Criação de um Mapa
  • Desenvolvimento de um fluxo de mensagens que utiliza o nó WTX Map
  • Implementação do fluxo de mensagens
    • Criação e compilação de um arquivo BAR
    • Implementação do arquivo BAR
    • Implementação do mapa, caso você esteja usando um mapa pré-compilado
  • Execução do seu fluxo de mensagens

Após a implementação do fluxo de mensagens, o Message Broker inicia automaticamente o fluxo de mensagens, o que resulta na seguinte ação:

  • O fluxo de mensagens é executado quando um nó de entrada recebe um fluxo de bits da mensagem de entrada.
  • Um analisador analisa o fluxo de bits de entrada em uma árvore de mensagens de entrada.
  • Um nó WTX Map recebe uma árvore de mensagens de entrada e executa o mapa.
  • O mapa transforma os dados na árvore de mensagens de entrada e cria uma ou mais árvores de mensagens de saída.
  • As árvores de mensagem de saída podem ser processadas por outros nós no fluxo de mensagens.

Criando um mapa

Introdução ao Map Designer

Utilize o Map Designer por meio da perspectiva de desenvolvimento do WebSphere TX (mostrada abaixo) para desenvolver mapas que definem especificações de entrada e saída e regras de mapeamento para a transformação de dados:


Figura 1. Seleção da perspectiva de desenvolvimento do WebSphere TX
Figure 1

O Map Designer utiliza as definições de dados armazenados nas árvores de tipo (criadas com o uso do Type Designer) para especificar a lógica de transformação na forma de regras de mapeamento. As regras de mapeamento operam em objetos de dados de entrada e criam objetos de dados de saída. O mapa pode ser construído para plataformas específicas e, em seguida, ser executado nessa plataforma para executar a transformação dos dados.

Usando o Map Designer

Para usar o Map Designer, é necessário que você já tenha a árvore de tipos que definem seus dados. O Map Designer utiliza as definições de objeto de dados armazenadas nessas árvores de tipos. O Map Designer é usado para:

  • Criar mapas a fim de especificar a lógica para transformar dados de entrada nos dados de saída desejados.
  • Identificar a origem e os objetos de dados dos dados de entrada.
  • Validar e resolver as propriedades dos tipos de dados de origem definidas no Type Designer.
  • Identificar o destino e os objetos de dados dos dados de saída.
  • Especificar e construir os dados de saída de acordo com as regras de mapeamento.
  • Fornecer informações sobre a validação de dados por meio da geração de arquivos de rastreio.
  • Visualizar os resultados de execução da execução do mapa.

Figura 2. O Map Designer no Message Broker Toolkit. Clique para ver a imagem ampliada

Map Designer in Message Broker Toolkit. Click to see larger image


Figura 3. Exemplo de design de mapa de placa de entrada
Figure 3



Figura 4. Exemplo de design de mapa de placa de saída
Figure 4


Após a definição dos objetos de dados e de suas propriedades no Type Designer, você irá definir um mapa no Map Designer, onde as placas de mapa especificam a origem de entrada e o destino de saída.

Desenvolvendo um fluxo de mensagens usando o nó WTX Map

Em um fluxo de mensagens, há diferentes formas de usar o nó WTX Map:

Com um mapa de origem e uma entrada única
Desenvolva um fluxo de mensagens com um nó WTX Map especificado com um mapa de origem que, durante o tempo de execução, é acionado para ser executado por uma única entrada.
Com um mapa pré-compilado e uma entrada única
Desenvolva um fluxo de mensagens com um nó WTX Map especificado com um mapa pré-compilado que, durante o tempo de execução, é acionado para ser executado por uma única entrada.
Com um mapa de origem e várias entradas
Desenvolva um fluxo de mensagens com um nó WTX Map especificado com um mapa de origem que, durante o tempo de execução, é acionado para ser executado por várias entradas.
Com um mapa pré-compilado e várias entradas
Desenvolva um fluxo de mensagens com um nó WTX Map especificado com um mapa pré-compilado que, durante o tempo de execução, é acionado para ser executado por várias entradas.

Desenvolvimento do fluxo de mensagens

Usando o nó WTX Map com um mapa de origem e uma entrada única

O mapa pode ter muitas placas de entrada, mas apenas uma placa indicada recebe dados do fluxo de mensagens, enquanto cada uma das outras placas puxa os dados diretamente do seu adaptador. O mapa também pode ter várias placas de saída. As placas conectadas ao fluxo de mensagens propagam dados para o fluxo, ao passo que as placas não conectadas enviam dados diretamente ao seu adaptador. Para desenvolver um fluxo de mensagens simples que demonstre esse cenário, utilize as seguintes etapas. Pressupõe-se que o Map Designer seja utilizado para criar um arquivo de mapa de origem (.mms) contendo um mapa executável com um ou mais placas de entrada e um ou mais placas de saída.

  1. Crie um novo projeto de fluxo de mensagens na perspectiva de Desenvolvimento de Aplicativos do Message Broker.
  2. Crie um novo fluxo de mensagens no projeto: selecione Usar esquema intermediário padrão ou forneça o nome do seu próprio esquema para qualificar o nome do fluxo de mensagens.
  3. Arraste o nó WTX Map da paleta para a tela do seu fluxo de mensagens. Inicialmente, o nó não tem terminais de saída e tem um terminal de falha. O WebSphere TX Drawer e a paleta do nó WTX Map são mostrados na Figura 5:

    Figure 5. Nó WTX Map no Message Broker Toolkit
    Figure 5

  4. Navegue até a visualização Propriedades, mostrada na Figura 1 acima.
  5. Na guia Básico do nó WTX Map, selecione o mapa de origem.
  6. Na guia Entrada do nó WTX Map, selecione a placa do mapa que receberá a entrada. As propriedades importantes do nó WTX Map são mostradas na Figura 6:

    Figura 6. Propriedades do nó WTX Map
    Figure 6

  7. Arraste um nó de entrada, como um nó FileInput ou um nó MQInput à esquerda do nó WTX Map, e conecte o terminal de saída do nó de entrada ao terminal de entrada do nó WTX Map. A mensagem do nó de entrada substitui o adaptador da placa de entrada selecionada do mapa.
  8. Configure o nó de entrada com as propriedades relacionadas a transporte necessárias.
  9. Na guia Análise da Mensagem de Entrada do nó de entrada, configure as propriedades do modelo de mensagem para descrever o formato da mensagem de entrada. Selecione o domínio na lista de domínios de mensagem suportados.
  10. Arraste um nó de saída, como um nó FileOutput ou um nó MQOutput à direita do nó WTX Map, e conecte um dos terminais de saída do nó WTX Map ao terminal de entrada do nó de saída. A conexão do terminal de saída substitui o adaptador da placa de saída correspondente.
  11. Configure o nó de saída com as propriedades relacionadas a transporte necessárias.
  12. Na guia Saídas do nó WTX Map, configure as propriedades para descrever o formato da mensagem de saída propagada pela placa de saída:
    1. Clique em Adicionar para adicionar um conjunto de propriedades. A caixa de diálogo da entrada Adicionar Propriedades é aberta.
    2. Insira valores para Número da Placa, Domínio de Mensagem, Conjunto de Mensagens, Tipo de Mensagem, Codificação, ID do Conjunto de Carac. Codificados e, em seguida, clique em OK. Domínio de Mensagem deve ser um dos tipos de domínio de mensagem suportados.
  13. Repita as etapas de 10 a 12 para cada terminal de saída que deseja conectar.
  14. Pressione Ctrl+S para salvar o fluxo de mensagens.

Usando o nó WTX Map com um mapa pré-compilado e uma entrada única

O mapa pode ter várias placas de entrada. Apenas uma placa indicada recebe dados do fluxo de mensagens, enquanto cada uma das outras placas puxa os dados diretamente do seu adaptador. O mapa também pode ter várias placas de saída. As placas conectadas ao fluxo de mensagens propagam dados para o fluxo, ao passo que as placas não conectadas enviam dados diretamente ao seu adaptador. Para desenvolver um fluxo de mensagens simples que demonstre esse cenário, utilize as seguintes etapas. Pressupõe-se que o Map Designer seja usado para criar um arquivo de mapa de origem (.mms) contendo um mapa executável com uma ou mais placas de entrada e uma ou mais placas de saída, e que tenha compilado o mapa para uma plataforma de destino, criando um arquivo de mapa compilado (.mmc).

  1. Crie um novo projeto de fluxo de mensagens na perspectiva de Desenvolvimento de Aplicativos do Message Broker.
  2. Crie um novo fluxo de mensagens no projeto. Selecione Usar esquema intermediário padrão ou forneça o nome do seu próprio esquema para qualificar o nome do fluxo de mensagens.
  3. Arraste o nó WTX Map da paleta para a tela do seu fluxo de mensagens. Inicialmente, o nó não tem terminais de saída e tem um terminal de falha.
  4. Navegue até a visualização Propriedades.
  5. Na guia Básico do nó WTX Map, selecione o mapa pré-compilado.
  6. Na guia Entrada do nó WTX Map, selecione a placa do mapa que receberá a entrada.
  7. Arraste um nó de entrada, como um nó FileInput ou um nó MQInput, à esquerda do nó WTX Map, e conecte o terminal de saída do nó de entrada ao terminal de entrada do nó WTX Map. A mensagem do nó de entrada substitui o adaptador da placa de entrada selecionada do mapa.
  8. Configure o nó de entrada com as propriedades relacionadas a transporte necessárias.
  9. Na guia Análise da Mensagem de Entrada do nó de entrada, configure as propriedades do modelo de mensagem para descrever o formato da mensagem de entrada. Selecione o domínio na lista de domínios de mensagem suportados.
  10. Arraste um nó de saída, como um nó FileOutput ou um nó MQOutput à direita do nó WTX Map, e conecte um dos terminais de saída do nó WTX Map ao terminal de entrada do nó de saída. A conexão do terminal de saída substitui o adaptador da placa de saída correspondente.
  11. Configure o nó de saída com as propriedades relacionadas a transporte necessárias.
  12. Na guia Saídas do nó WTX Map, configure as propriedades para descrever o formato da mensagem de saída propagada pela placa de saída:
    1. Clique em Adicionar para adicionar um conjunto de propriedades. A caixa de diálogo da entrada Adicionar Propriedades é aberta.
    2. Insira valores para Número da Placa, Domínio de Mensagem, Conjunto de Mensagens, Tipo de Mensagem, Codificação, ID do Conjunto de Carac. Codificados e, em seguida, clique em OK. Domínio de Mensagem deve ser um dos tipos de domínio de mensagem suportados.
  13. Repita as etapas de 10 a 12 para cada terminal de saída que deseja conectar.
  14. Pressione Ctrl+S para salvar o fluxo de mensagens. A Figura 7 abaixo mostra um dos possíveis Fluxos de Mensagens que utiliza uma única entrada:

    Figura 7. Fluxo de Mensagens Simples com o nó WTX Map recebendo a Entrada única.
    Figure 7

Usando o nó WTX Map com um mapa de origem e várias entradas

Desenvolva um fluxo de mensagens com um nó WTX Map especificado com um mapa de origem que, durante o tempo de execução, é acionado para ser executado por várias entradas. O nó WTX Map é usado com um nó Collector nativo, que coleta as várias entradas e, quando os critérios de evento especificados são atendidos, propaga as mensagens para o nó WTX Map na forma de uma coleção de mensagens. Para obter informações sobre o nó Collector e a coleta de mensagens, consulte a Biblioteca do WebSphere Message Broker.

O mapa pode ter várias placas de entrada. Qualquer quantidade de placas pode receber dados da coleção de mensagens, enquanto todas as placas que não recebem dados puxam os dados diretamente do seu respectivo adaptador. O mapa pode ter várias placas de saída. As placas conectadas ao fluxo de mensagens propagam dados para o fluxo, ao passo que as placas não conectadas enviam dados diretamente ao seu adaptador. Para desenvolver um fluxo de mensagens simples que demonstre esse cenário, utilize as seguintes etapas. Pressupõe-se que você use o Map Designer para criar um arquivo de mapa de origem (.mms) contendo um mapa executável com duas placas de entrada e uma ou mais placas de saída.

  1. Crie um novo projeto de fluxo de mensagens na perspectiva de Desenvolvimento de Aplicativos do Message Broker.
  2. Crie um novo fluxo de mensagens no projeto. Selecione Usar esquema intermediário padrão ou forneça o nome do seu próprio esquema para qualificar o nome do fluxo de mensagens.
  3. Arraste o nó WTX Map da paleta para a tela do seu fluxo de mensagens. Inicialmente, o nó não tem terminais de saída e tem um terminal de falha.
  4. Navegue até a visualização Propriedades.
  5. Na guia Básico do nó WTX Map, selecione o mapa de origem.
  6. Arraste um nó Collector para a esquerda do nó WTX Map.
  7. Arraste um nó de entrada, como um nó FileInput ou um nó MQInput, para a esquerda do nó Collector.
  8. Configure o nó de entrada com as propriedades relacionadas a transporte necessárias.
  9. Na guia Análise da Mensagem de Entrada do nó de entrada, configure as propriedades do modelo de mensagem para descrever o formato da mensagem de entrada. Selecione o domínio na lista de domínios de mensagem suportados.
  10. Clique com o botão direito do mouse no nó Collector e selecione Adicionar Terminal de Entrada. Insira o nome de um novo terminal de entrada, que deve corresponder ao nome da placa de entrada no mapa que receberá a mensagem de entrada. O novo terminal de entrada é adicionado à tabela Definição da Coleção na guia Básico. O arquivo de rastreio do intermediário lista todos os terminais de entrada do Collector que não correspondem às placas de entrada.
  11. Na guia Básico, configure as propriedades dos critérios de evento necessárias para o novo terminal de entrada, a saber Quantidade, Tempo Limite, Caminho de Correlação e Padrão de Correlação.
  12. Conecte o terminal de saída do nó de entrada ao novo terminal de entrada no nó Collector.
  13. Repita as etapas de 7 a 12 para cada entrada diferente do fluxo de mensagens exigida pelo mapa.
  14. Na guia Básico do nó Collector, configure as propriedades Nome da Coleção e Expiração da Coleção. Particularmente, especifique um valor para Expiração da Coleção.
  15. Conecte o terminal de saída do nó Collector ao terminal de entrada do nó WTX Map. As mensagens provenientes da coleção de mensagens propagadas substituem os adaptadores das placas de entrada do mapa.
  16. Conecte o terminal expiração do nó Collector ao terminal de entrada do nó WTX Map a fim de manipular as coleções de mensagens incompletas.
  17. Arraste um nó de saída, como um nó FileOutput ou um nó MQOutput à direita do nó WTX Map, e conecte um dos terminais de saída do nó WTX Map ao terminal de entrada do nó de saída. A conexão do terminal de saída substitui o adaptador da placa de saída correspondente.
  18. Configure o nó de saída com as propriedades relacionadas a transporte necessárias.
  19. Na guia Saídas do nó WTX Map, configure as propriedades para descrever o formato da mensagem de saída propagada pela placa de saída:
    1. Clique em Adicionar para adicionar um conjunto de propriedades. A caixa de diálogo da entrada Adicionar Propriedades é aberta.
    2. Insira valores para Número da Placa, Domínio de Mensagem, Conjunto de Mensagens, Tipo de Mensagem, Codificação, ID do Conjunto de Carac. Codificados e, em seguida, clique em OK. Domínio de Mensagem deve ser um dos tipos de domínio de mensagem suportados.
  20. Repita as etapas de 17 a 19 para cada terminal de saída que deseja conectar.
  21. Pressione Ctrl+S para salvar o código. Será exibida a mensagem de aviso Terminais de captura não conectados e você pode ignorá-la.

Usando o nó WTX Map com um mapa pré-compilado e várias entradas

Desenvolva um fluxo de mensagens com um nó WTX Map especificado com um mapa pré-compilado que, durante o tempo de execução, é acionado para ser executado por várias entradas. O nó WTX Map é usado com um nó Collector nativo, que coleta as várias entradas e, quando os critérios de evento especificados são atendidos, propaga as mensagens para o nó WTX Map na forma de uma coleção de mensagens. Para obter informações sobre o nó Collector e a coleta de mensagens, consulte a Biblioteca do WebSphere Message Broker.

O mapa pode ter várias placas de entrada. Qualquer quantidade de placas pode receber dados da coleção de mensagens, enquanto todas as placas que não recebem dados puxam os dados diretamente do seu respectivo adaptador. O mapa pode ter várias placas de saída. As placas conectadas ao fluxo de mensagens propagam dados para o fluxo, ao passo que as placas não conectadas enviam dados diretamente ao seu adaptador. Para desenvolver um fluxo de mensagens simples que demonstre esse cenário, utilize as seguintes etapas. Pressupõe-se que o Map Designer seja usado para criar um arquivo de mapa de origem (.mms) contendo um mapa executável com uma ou mais placas de entrada e uma ou mais placas de saída, e que tenha compilado o mapa para uma plataforma de destino, criando um arquivo de mapa compilado (.mmc).

  1. Crie um novo projeto de fluxo de mensagens na perspectiva de Desenvolvimento de Aplicativos do Message Broker.
  2. Crie um novo fluxo de mensagens no projeto. Selecione Usar esquema intermediário padrão ou forneça o nome do seu próprio esquema para qualificar o nome do fluxo de mensagens.
  3. Arraste o nó WTX Map da paleta para a tela do seu fluxo de mensagens. Inicialmente, o nó não tem terminais de saída e tem um terminal de falha.
  4. Navegue até a visualização Propriedades.
  5. Na guia Básico do nó WTX Map, selecione o mapa pré-compilado.
  6. Arraste um nó Collector para a esquerda do nó WTX Map.
  7. Arraste um nó de entrada como, por exemplo, um nó FileInput ou um nó MQInput, para a esquerda do nó Collector.
  8. Configure o nó de entrada com as propriedades relacionadas a transporte necessárias.
  9. Na guia Análise da Mensagem de Entrada do nó de entrada, configure as propriedades do modelo de mensagem para descrever o formato da mensagem de entrada. Selecione o domínio na lista de domínios de mensagem suportados.
  10. Clique com o botão direito do mouse no nó Collector e selecione Adicionar Terminal de Entrada. Insira o nome de um novo terminal de entrada, que deve corresponder ao nome da placa de entrada no mapa que receberá a mensagem de entrada. O novo terminal de entrada é adicionado à tabela Definição da Coleção na guia Básico. O arquivo de rastreio do intermediário lista todos os terminais de entrada do Collector que não correspondem às placas de entrada.
  11. Na guia Básico, configure as propriedades dos critérios de evento necessárias para o novo terminal de entrada, a saber Quantidade, Tempo Limite, Caminho de Correlação e Padrão de Correlação.
  12. Conecte o terminal de saída do nó de entrada ao novo terminal de entrada no nó Collector.
  13. Repita as etapas de 7 a 12 para cada entrada diferente do fluxo de mensagens exigida pelo mapa.
  14. Na guia Básico do nó Collector, configure as propriedades Nome da Coleção e Expiração da Coleção. Particularmente, você deve especificar um valor para Expiração da Coleção.
  15. Conecte o terminal de saída do nó Collector ao terminal de entrada do nó WTX Map. As mensagens provenientes da coleção de mensagens propagadas substituem os adaptadores das placas de entrada do mapa.
  16. Conecte o terminal expiração do nó Collector ao terminal de entrada do nó WTX Map a fim de manipular as coleções de mensagens incompletas.
  17. Arraste um nó de saída, como um nó FileOutput ou um nó MQOutput à direita do nó WTX Map, e conecte um dos terminais de saída do nó WTX Map ao terminal de entrada do nó de saída. A conexão do terminal de saída substitui o adaptador da placa de saída correspondente.
  18. Configure o nó de saída com as propriedades relacionadas a transporte necessárias.
  19. Na guia Saídas do nó WTX Map, configure as propriedades para descrever o formato da mensagem de saída propagada pela placa de saída:
    1. Clique em Adicionar para adicionar um conjunto de propriedades. A caixa de diálogo da entrada Adicionar Propriedades é aberta.
    2. Insira valores para Número da Placa, Domínio de Mensagem, Conjunto de Mensagens, Tipo de Mensagem, Codificação, ID do Conjunto de Carac. Codificados e, em seguida, clique em OK. Domínio de Mensagem deve ser um dos tipos de domínio de mensagem suportados.
  20. Repita as etapas de 17 a 19 para cada terminal de saída que deseja conectar.
  21. Pressione Ctrl+S para salvar o código. Será exibida a mensagem de aviso Terminais de captura não conectados e você pode ignorá-la. A Figura 8 abaixo mostra um dos possíveis fluxos de mensagens que utiliza várias entradas:

    Figura 8. Fluxo de mensagens simples com o nó WTX Map recebendo entradas de várias origens
    Figure 8

Implementação no tempo de execução do Message Broker

Quando você implementar fluxos de mensagens que contenham nós WTX Map, também será necessário implementar os mapas associados ao WebSphere TX, bem como quaisquer arquivos exigidos pelos mapas. Se o mapa for disponibilizado para o intermediário em um map archive (MAR), é necessário assegurar que todos os arquivos necessários estejam localizados no mesmo projeto do mapa, de forma que sejam automaticamente incluídos no arquivo MAR. Se o mapa for manualmente implementado para o intermediário, também será necessário implementar manualmente para o intermediário todos os arquivos necessários. Particularmente, se seus dados forem XML e você tiver importado um Esquema XML (arquivo .xsd) ao criar uma árvore de tipos validada com Xerces, ou tiver usado um Esquema XML diretamente ao criar uma placa de mapa, o arquivo .xsd será exigido pelo mapa e deverá ser disponibilizado ao Message Broker para utilização durante o tempo de execução em um dos seguintes casos:

  • Se os dados estiverem sendo recebidos do fluxo de mensagens no domínio BLOB
  • Se os dados estiverem sendo recebidos de um adaptador WebSphere TX

Na fase de design, é possível especificar as seguintes informações de mapa no nó WTX Map. Os dois mecanismos alternativos de implementação do mapa são descritos abaixo:

  • Usando um mapa de origem com um nó WTX Map
    • Quando o Message Broker adiciona o fluxo de mensagens contendo o nó WTX Map a um arquivo BAR, o mapa executável especificado é compilado automaticamente para criar um arquivo de mapa compilado (.mmc).
    • O mapa compilado, bem como outros arquivos no projeto, é compactado em um arquivo MAR, que é adicionado ao arquivo BAR. Portanto, o mapa é automaticamente implementado para o intermediário no momento da implementação do fluxo de mensagens.
  • Usando um mapa pré-compilado com um nó WTX Map
    • Quando o Message Broker adiciona o fluxo de mensagens contendo o nó WTX Map a um arquivo BAR, o mapa não é automaticamente compilado nem é adicionado ao arquivo BAR.
    • É necessário implementar manualmente o mapa no local que você especificou.

No momento da implementação, especifique o local de um mapa compilado usando a guia Configurar na visualização Propriedades, localizada na guia Gerenciar no editor Broker Archive. Essa configuração substitui o mapa especificado na fase de design.

Durante o tempo de execução, seu fluxo de mensagens pode especificar dinamicamente o local de um mapa compilado e passá-lo ao nó WTX Map usando a árvore de mensagens Ambiente Local. Esta configuração tem precedência sobre todos os outros métodos.

Executando o fluxo de mensagens

É possível executar o fluxo de mensagens enviando uma ou mais mensagens por ele. O fluxo de mensagens recebe a mensagem em um nó de entrada, que analisa o fluxo de bits da mensagem usando o analisador especificado, criando uma árvore de mensagens do intermediário. A árvore de mensagens resultante é propagada pelo fluxo. Quando um nó WTX Map recebe uma árvore de mensagens propagadas, ele executa o mapa associado e cria mensagens de saída.

Se o seu mapa estiver esperando várias entradas, use o nó Collector para coletar essas entradas. Nesse caso, é necessário enviar quantas mensagens forem necessárias para concluir a coleta de mensagens definida pelo nó Collector. O corpo de uma árvore de mensagens, propagado a partir de um terminal de saída de um nó WTX Map é de propriedade do domínio de mensagem que você especificou no terminal de saída. Quaisquer cabeçalhos presentes na árvore de mensagens de entrada recebida pelo mapa, como MQMD, serão preservados sem alteração na árvore de mensagens propagadas. Se o mapa receber uma coleção de mensagens como sua entrada, os cabeçalhos propagados serão aqueles da primeira mensagem da coleção. Os cabeçalhos de outras mensagens na coleção serão descartados. As árvores Ambiente, Ambiente Local e Lista de Exceção da mensagem de entrada também serão propagadas sem alteração.

Se ocorrer uma falha na execução de um mapa, a falha será adicionada à Lista de Exceção. Além disso, a mensagem de entrada e as árvores Ambiente, Ambiente Local e Lista de Exceção serão propagadas a partir do terminal de falha, se estiver conectado. Caso contrário, surgirá uma exceção. Quando a árvore de mensagens atinge o nó de saída, ela é serializada em um fluxo de bits pelo analisador proprietário.



Recursos



Sobre os autores

Ashwin Gupta é Engenheiro de Software de Sistema na equipe de Teste do WebSphere Message Broker. Ele tem quatro anos de experiência no trabalho em várias versões do WebSphere Message Broker. Ele é formado em Engenharia Elétrica pelo Indian Institute of Technology em Roorkee. É possível entrar em contato com Ashwin pelo endereço de e-mail gupta.ashwin@in.ibm.com.


Avinash Jhawar é Engenheiro de Software de Equipe e Chefe da Equipe de Teste do WebSphere Message Broker. Ele tem seis anos de experiência no trabalho em várias versões do WebSphere Message Broker e do WebSphere MQ. Ele se formou em Engenharia Elétrica pelo Government Engineering College em Ujjain, na Índia. É possível entrar em contato com Avinash pelo endereço avjhawar@in.ibm.com.


Rashmi Katagall é Engenheira de Software de Sistema na equipe de Teste WebSphere Message Broker. Ela tem dois anos de experiência no trabalho em várias versões do WebSphere Message Broker. Ela se formou em Engenharia Eletrônica e de Comunicação pelo Gogte Institute of Technology, na Bélgica. É possível entrar em contato com Rashmi pelo endereço rashmikatagall@in.ibm.com.




Avalie esta página


Reserve um instante para completar este formulário para nos ajudar a servi-lo melhor.



 


 


Não
são úteis
Extremamente
úteis
 






Voltar para parte superior