Passo a Passo
WebSphere Integration Developer
Com JNDI
Alexandre José Batista
Índice 1.
OBJETIVOS DO DOCUMENTO ............................................................................................................... 5
2.
INTRODUÇÃO:............................................................................................................................................ 6
3.
CRIANDO O PROJETO.............................................................................................................................. 6 3.2 ABRIR O WEBSPHERE INTEGRATION DEVELOPER .......................................................................................... 6 3.2.1 CRIANDO O MÓDULO .................................................................................................................................. 7 3.2.2 CRIANDO A INTERFACE ............................................................................................................................... 7 3.2.3 CONFIGURANDO A INTERFACE .................................................................................................................... 9 3.2.4 GERANDO O MQ BINDING ............................................................................................................................ 9 3.2.5 INTRODUZINDO O JNDI................................................................................................................................11 3.2.6 CONFIGURANDO O JNDI NO PROCESS SERVER .............................................................................................12 3.2.7 GERANDO O MQ BINDING DE SAIDA ............................................................................................................18
4.
IMPLEMENTAÇÃO DO PROJETO JNDI..............................................................................................19 4.1 INTRODUÇÃO ................................................................................................................................................19 5.1. ALTERAR INTERFACE ...................................................................................................................................21 5.2. CRIANDO O PROCESSO ..................................................................................................................................23 6.0. REALIZANDO MAPEAMENTO.................................................................................................................25 6.1. TESTANDO COMPONENTE .............................................................................................................................27
Criado em: 12/02/08
Página
3
de
30
Alexandre José Batista
Índice de figura Figura 1 - Escolha de Workspace. .......................................................................................................... 6 Figura 2 - Criando um módulo................................................................................................................. 7 Figura 3 – Criando uma Interface............................................................................................................ 8 Figura 4 - Configurando a Interface. ....................................................................................................... 9 Figura 5 – Interface Configurada............................................................................................................. 9 Figura 6 – Gerando MQ Binding ........................................................................................................... 10 Figura 7 – Configuração do Spcify JNDI. .............................................................................................. 11 Figura 8 – Run Administrative Console................................................................................................. 12 Figura 9 - Selecionanado WebSphere MQ. .......................................................................................... 13 Figura 10 – WebSphere MQ Connection Factories. ............................................................................. 13 Figura 11 – Inseriondo Connection Factories ....................................................................................... 14 Figura 12 – Configurando Connection Factories. ................................................................................. 15 Figura 13 – Adcionando Custom Properties. ........................................................................................ 16 Figura 14 – Configurando Custom Properties....................................................................................... 16 Figura 15 – WebSphere MQ Queue Destinations................................................................................. 17 Figura 16 – Configurado MQ Queue Destinations. ............................................................................... 18 Figura 17 – Configuar Componente Import (Saida). ............................................................................. 19 Figura 18 - Criando o Data Type. .......................................................................................................... 20 Figura 19 - Criando o Data Type. .......................................................................................................... 21 Figura 20 - Criando o Data type. ........................................................................................................... 21 Figura 21 - Alterando Interface.............................................................................................................. 22 Figura 22 - Alterando Interface.............................................................................................................. 23 Figura 23 - Interligando Componentes. ................................................................................................. 23 Figura 24 - Interligando Componentes. ................................................................................................. 24 Figura 25 - Gerando Implementação. ................................................................................................... 25 Figura 26 - Show BPEL. ........................................................................................................................ 25 Figura 27 - Adicionando Assign. ........................................................................................................... 26 Figura 28 - Adicionando Assign. ........................................................................................................... 26 Figura 29 - Fazendo Mapeamento de Empresa p/ Nome..................................................................... 27 Figura 30 - Mapeamento de Endereço p/ Endereço. ............................................................................ 27 Figura 31 - Abrindo tela do Deploy........................................................................................................ 28 Figura 32 - Deploy. ................................................................................................................................ 29
Criado em: 12/02/08
Página
4
de
30
Alexandre José Batista
1. OBJETIVOS DO DOCUMENTO Esse documento tem como objetivo ajudar o manuseio da ferramenta IBM WebSphere Integration Develop. Por isso que são criados exemplos passo a passo de fácil entendimento para o melhor entendimento ferramenta. Uma das finalidades desse documento e fazer que os novos integranntes da equipe de integração tenha uma noção sobre os recursos do software e uma “rápida” apredizagem sobre a ferramenta.
Criado em: 12/02/08
Página
5
de
30
Alexandre José Batista
2. INTRODUÇÃO: Uns dos objetivos desse exemplo, e ensinar a construir uma aplicação no Websphere Integration Developer (WID), utilizando MQ Bindings com JNDI definitions.
3. CRIANDO O PROJETO
3.2 ABRIR O WEBSPHERE INTEGRATION DEVELOPER
Click em Iniciar Programas IBM Websphere Integration Developer v6.0.2 ou clique diretamente no ícone que se encontra no desktop. Quando abrir Workspace conforme a tela abaixo, coloque o nome sugerido JNDI-EXEMPLO.
Figura 1 - Escolha de Workspace.
Criado em: 12/02/08
Página
6
de
30
Alexandre José Batista
3.2.1 CRIANDO O MÓDULO
Na perspectiva Business Integration do WID no lado esquerdo da tela, click com o lado direito do mouse New Module. Digite o nome do Module Name: JNDI e Finish. Igual a figura logo abaixo:
Figura 2 - Criando um módulo.
3.2.2 CRIANDO A INTERFACE Dentro do JNDI, click com o lado direito do mouse em Interfaces New Interface.
Criado em: 12/02/08
Página
7
de
30
Alexandre José Batista
Figura 3 – Criando uma Interface
Preencha os campos Folder e Name, conforme a figura abaixo e Finish. Criado em: 12/02/08
Página
8
de
30
Alexandre José Batista
Figura 4 - Configurando a Interface. 3.2.3 CONFIGURANDO A INTERFACE Adicione um Request Response Operation e configure igual à Figura 5, o procedimento é totalmente intuitivo.
Figura 5 – Interface Configurada
3.2.4 GERANDO O MQ BINDING Criado em: 12/02/08
Página
9
de
30
Alexandre José Batista
Dentro do JNDI, de um doublé click no Assembly Diagram, na sua tela do lado direito do WID selecione/escolha o componente Export. Renomear o nome do Export1 para entrada. E importante adicionar uma interface para o componete, pois vamos adicionar a interface JNDI. Cick com o lado direito do mouse no componente entrada Add Interface selecione JNDI. Agora vamos gerar o MQ Binding igual a figura de mostra logo abaixo:
Figura 6 – Gerando MQ Binding
Criado em: 12/02/08
Página
10
de
30
Alexandre José Batista
3.2.5 INTRODUZINDO O JNDI Primeiramente, selecione a opção Specify JNDI name for pre-configured WebSphere MQ resources. Os seguintes valores então devem ser incorporados: • JNDI Name for MQ Connection Factory: mq/QM_JNDI • JNDI Name for Send Destination: mq/ENTRADA • JNDI Name for Receive Destination: mq/ENTRADA_REPLY - Data Format • Request Serialization type: Serialized as XML • Reponse Serialization type: Serialized as XML
Figura 7 – Configuração do Spcify JNDI.
Criado em: 12/02/08
Página
11
de
30
Alexandre José Batista
3.2.6 CONFIGURANDO O JNDI NO PROCESS SERVER
As definições reais do recurso devem ser feitas dentro do Process Server antes que a solução possa executar.
Agora vamos abrir o console administrativa do process server conforme a figura logo abaixo:
Figura 8 – Run Administrative Console.
Criado em: 12/02/08
Página
12
de
30
Alexandre José Batista
Assim que entrar no console administrativo do Process Server, click no seguinte Link Resources JMS Providers WebSphere MQ
Figura 9 - Selecionanado WebSphere MQ. Após ter clickado no link WebSphere MQ, ao lado direito da tela você enchegara o seguinte quandro (Additional Properties), igual a figura abaixo:
Figura 10 – WebSphere MQ Connection Factories.
Criado em: 12/02/08
Página
13
de
30
Alexandre José Batista
Agora vamos criar um novo WebSphere MQ connection factory, conforme a figura abaixo:
Figura 11 – Inseriondo Connection Factories Dentro da configuração do MQ connection factory complete os campos com os valores logo abaixo: • Name: mq_jndi • JNDI name: mq/QM_JNDI • Queue Manager: QM_JNDI • host: localhost • Port: 1419 • Channel: CANALJNDI • Transport type: CLIENT
Criado em: 12/02/08
Página
14
de
30
Alexandre José Batista
Figura 12 – Configurando Connection Factories.
Agora vamos selecionar o Custom properties que se encontra no mq/MQ_JNDI, conforme a imagem abaixo. Criado em: 12/02/08
Página
15
de
30
Alexandre José Batista
Figura 13 – Adcionando Custom Properties.
Nesse próximo passo vamos criar dois Custom Properties, conforme a figura e os valores abaixo:
Figura 14 – Configurando Custom Properties
Name SENDEXIT RECEXIT
Value com.ibm.ws.sca.internal.mq.exit.MQInternalSendExitImpl com.ibm.ws.sca.internal.mq.exit.MQInternalReceiveExitImpl
Agora vamos entrar MQ queue destinations, click no link conforme a figura abaixo.
Criado em: 12/02/08
Página
16
de
30
Alexandre José Batista
Figura 15 – WebSphere MQ Queue Destinations Nesse próximo passo você vai criar 4 ( quatro ) novos destinations, igual os dados passado logo abaixo.
queue
Primeiro • Name: mq_ENTRADA • JNDI name: mq/ENTRADA • Base queue name: ENTRADA • Base queue manager name: QM_JNDI • Target Client: MQ • Queue manager host: localhost • Port: 1419 • Channel: CANALJNDI Segundo • Name: mq_ENTRADA_REPLY • JNDI name: mq/ENTRADA_REPLY • Base queue name: ENTRADA_REPLY • Base queue manager name: QM_JNDI • Target Client: MQ • host: localhost • Port: 1419 • Channel: CANALJNDI
Terceiro • Name: mq_SAIDA • JNDI name: mq/SAIDA • Base queue name: SAIDA • Base queue manager name: QM_JNDI • Target Client: MQ • host: localhost • Port: 1419 Criado em: 12/02/08
Página
17
de
30
Alexandre José Batista • Channel: CANALJNDI Quarto • Name: mq_SAIDA_REPLY • JNDI name: mq/SAIDA_REPLY • Base queue name: SAIDA_REPLY • Base queue manager name: QM_JNDI • Target Client: MQ • host: localhost • Port: 1419 • Channel: CANALJNDI
Figura 16 – Configurado MQ Queue Destinations.
3.2.7 GERANDO O MQ BINDING DE SAIDA Nesse momento você pode voltar para perspectiva do Assembly Diagram e simplesmente realizar o passo anterior da Geração do MQ Binding, realizando no tópico 3.2.4, sendo que na hora de adicionar um novo componente o mesmo vai ser um componente de Import e não Export. E para finalizar altere suas propriedades conforme a figura logo abaixo:
Criado em: 12/02/08
Página
18
de
30
Alexandre José Batista
Figura 17 – Configuar Componente Import (Saida).
É necessário que você reinicie o Process Server para fazer o Deploy da aplicação.
4. IMPLEMENTAÇÃO DO PROJETO JNDI 4.1 INTRODUÇÃO Nessa implementação nós vamos colocar um componente Assing e dois Data Type para fazer um mapeamento de um XML de 7(sete) campos para 4(quatro).
Criado em: 12/02/08
Página
19
de
30
Alexandre José Batista
5. CRIANDO DATA TYPES
Na perspectiva Business Integration do WID no lado esquerdo da tela, click com o lado direito do mouse Data Type New Business Object. Digite em Folder: types e Name: empresa e Finish, faça o mesmo passo para o outro data type pessoa.
Figura 18 - Criando o Data Type.
Nesse momento temos que adicionar os seguintes atributos para empresa, conforme a figura abaixo:
Emresa Nome : string endereco : string telefone : string
Criado em: 12/02/08
pessoa nome empresa endereco telefone cep
: : : : :
string string string string string
Página
20
de
30
Alexandre José Batista
Figura 19 - Criando o Data Type.
Figura 20 - Criando o Data type.
5.1. ALTERAR INTERFACE Agora vamos alterar os tipo de variáveis criadas, para à variável entrada atribua o tipo pesso, para saída atribua o tipo empesa, igual a figura logo abaixo:
Criado em: 12/02/08
Página
21
de
30
Alexandre José Batista
Figura 21 - Alterando Interface.
Criado em: 12/02/08
Página
22
de
30
Alexandre José Batista
5.2. CRIANDO O PROCESSO Nesse passo você ira criar um process que vai conter toda “lógica” do mapeamento do XML e sua tranformação. Renomear o componente para mapeamento, conforme a ilustração abaixo:
Figura 22 - Alterando Interface. Agora vamos fazer a interligação dos componentes usando wire conforme a ilustração 23.
Figura 23 - Interligando Componentes. Após ter feito as interligações, de um doublé click no componente Process, automaticamente abrira uma caixa de mensagem, click em Yes. Criado em: 12/02/08
Página
23
de
30
Alexandre José Batista
Figura 24 - Interligando Componentes.
Nesse momento vamos dizer click em New Folder, coloque o nome de implemantion, selecione a pasta criada e click em OK. Está pasta crianda vai ser onde ficara o código de sua implementação. Logo abaixo se encontra uma ilustração. Criado em: 12/02/08
Página
24
de
30
Alexandre José Batista
Figura 25 - Gerando Implementação.
Figura 26 - Show BPEL.
6.0. REALIZANDO MAPEAMENTO Agora adicione o componente assing entre os componentes Receive e Reply, conforme a figura 28.
Criado em: 12/02/08
Página
25
de
30
Alexandre José Batista
Figura 27 - Adicionando Assign.
Figura 28 - Adicionando Assign.
Agora vamos fazer o mapeamento do Xml dentro do Assign, confome as figuras, lembrando que à entrada do xml é pessoa e sua saída é empresa.
pessoa --------------------------------- empresa empresa------------------------------------ nome Criado em: 12/02/08
Página
26
de
30
Alexandre José Batista
endereco------------------------------- endereco telefone------------------------------- telefone
Figura 29 - Fazendo Mapeamento de Empresa p/ Nome Agora vamos repetir o mesmo procedimento para o endereco e telefone, conforme a ilustração anterior.
Figura 30 - Mapeamento de Endereço p/ Endereço.
Obs: Não se esqueça de repetir o procedimento para o telefone.
6.1. TESTANDO COMPONENTE Nesse momento, salve todo o projeto (Ctrl + S) e click com o lado direito do mouse em WebSphere Process Server v6.0 --> Add and remove projects..
Criado em: 12/02/08
Página
27
de
30
Alexandre José Batista
Figura 31 - Abrindo tela do Deploy.
Selecione o projeto (modulo) e Adicione para o lado direito da caixa e click em finsh.
Criado em: 12/02/08
Página
28
de
30
Alexandre José Batista
Figura 32 - Deploy.
Para realizar o final do teste é necessário você utilizar o programa rfhutil e enviar o XML que se encontra logo abaixo, para fila de ENTRADA da Queue Manager QM_JNDI.
Criado em: 12/02/08
Página
29
de
30
Alexandre José Batista
<module:pessoa xmlns:module="http://JNDI/types "> <nome>samuel <empresa>Telefonica TPD <endereco>Rua Brigadeiro Galvao 61663516 03819458
Criado em: 12/02/08
Página
30
de
30