Passo a Passo Fluxo Web Service MsgBroker / Step by Step of one Flow export with web Service
-
Upload
alexandre-jose-batista -
Category
Documents
-
view
793 -
download
0
description
Transcript of Passo a Passo Fluxo Web Service MsgBroker / Step by Step of one Flow export with web Service
Alexandre José Batista
Criado em: 07/11/08 Página 1 de 38
Passo a Passo
WebSphere Message Broker
Fluxo como WebService
Alexandre José Batista
Alexandre José Batista
Criado em: 07/11/08 Página 2 de 38
Índice
1. OBJETIVOS DO DOCUMENTO............................................................................................................ 4
2. CRIANDO UM FLUXO NO WEBSPHERE MESSAGE BROKER. .................................................. 5
2.1 ABRIR O WEBSPHERE MESSAGE BROKER TOOLKIT ....................................................................................... 5 2.2 CRIANDO UM FLUXO ...................................................................................................................................... 6
2.2.1 – Passo 1 – Definindo um Message Flow Project.................................................................................. 6 2.2.2 – Passo 2 – Definindo um Message Flow .............................................................................................. 7 2.2.3 – Passo 3 – Definindo um Message Set Project ..................................................................................... 8 2.2.4 – Passo 4 – Importando arquivos XML.................................................................................................. 9 2.2.5 – Passo 5 – Gerar os arquivos XSD´s...................................................................................................11 2.2.6 – Passo 6 – Message Definition File.....................................................................................................13 2.2.7 – Passo 7 – Definindo os Nodes para o Message Flow ........................................................................16 2.2.8 – Passo 8 – Selecione os demais Nodes ................................................................................................18 2.2.9 – Passo 9 – Fazendo o mapeamento dos dados com o Node Mapping.................................................19 2.2.10 – Passo 10 – Message Category File ..................................................................................................22 2.2.11 – Passo 11 – Definindo o WSDL para o Fluxo ...................................................................................25
2.3 – DEPLOY DO FLUXO.....................................................................................................................................32 2.3.1 – Criar um Message Broker Archiver ...................................................................................................33 2.3.2 – Deploy do Arquivo BAR (Broker Archiver)........................................................................................35
3. TESTANDO O FLUXO ...........................................................................................................................37
4. REFERÊNCIAS .......................................................................................................................................38
Alexandre José Batista
Criado em: 07/11/08 Página 3 de 38
Índice de figura
Figura 1 – Escolha de Workspce ............................................................................................................ 5 Figura 2 – New Message Flow Project.................................................................................................... 6 Figura 3 – Criando um Message Flow .................................................................................................... 7 Figura 4 – Criando um Message Set Project .......................................................................................... 8 Figura 5 – Criando um Message Set....................................................................................................... 9 Figura 6 – Importando os arquivos XML de exemplo. ............................................................................ 9 Figura 7 – Gerar XML Schema ............................................................................................................. 11 Figura 7.1 – Arquivo ClienteIN.xsd........................................................................................................ 12 Figura 7.2 – Arquivos XML´s e XSD´s .................................................................................................. 13 Figura 8 – Message Definition File........................................................................................................ 13 Figura 8.1 – Arquivo XML schema file .................................................................................................. 14 Figura 8.2 – Global Elements................................................................................................................ 15 Figura 9 – Node http Input..................................................................................................................... 16 Figura 9.1 – Http Input Properties ......................................................................................................... 17 Figura 10 – Nodes SOAPExtract, Mapping e http Reply ...................................................................... 18 Figura 11 – Mapping Node.................................................................................................................... 19 Figura 11.1 – Mensage Source e Target............................................................................................... 20 Figura 11.2 – Tela de Mapeamento dos Campos................................................................................. 21 Figura 12 – Message Category File ...................................................................................................... 22 Figura 12.1 – Categoria tipo WSDL (Request e Response) ................................................................. 22 Figura 12.2 – Nome do arquivo de Categoria ....................................................................................... 23 Figura 12.3 – Definindo a entrada (Input) e saída (Output) .................................................................. 24 Figura 13 – WSDL Definition................................................................................................................. 25 Figura 13.1 – WSDL Definition from Message Set ............................................................................... 26 Figura 13.2 – Formato do WSDL - Simples .......................................................................................... 27 Figura 13.3 – O Estilo do WSDL é “document” ..................................................................................... 28 Figura 13.4 – Selecione o arquivo de Categoria para o WSDL ............................................................ 29 Figura 13.5 – Formato do Binding é SOAP/http.................................................................................... 30 Figura 13.6 – Port Address do Fluxo..................................................................................................... 31 Figura 13.7 – Arquivo WSDL Gerado.................................................................................................... 32 Figura 14 – Broker Administration......................................................................................................... 32 Figura 15 – Message Broker Archiver................................................................................................... 33 Figura 15.1 – Colocando arquivos no Broker Archiver ......................................................................... 34 Figura 16 – Deploy do Arquivo BAR ..................................................................................................... 35 Figura 16.1 – Deploy no Execution Group ............................................................................................ 36
Alexandre José Batista
Criado em: 07/11/08 Página 4 de 38
1. OBJETIVOS DO DOCUMENTO
Esse documento tem como objetivo ajudar o manuseio da ferramenta IBM WebSphere Message Broker .
Uma das finalidades desse documento e fazer que os novos integrantes e estudantes de integração tenha uma noção sobre os recursos do software e uma “rápida” apredizagem sobre a ferramenta.
Alexandre José Batista
Criado em: 07/11/08 Página 5 de 38
2. CRIANDO UM FLUXO NO WEBSPHERE MESSAGE BROKER.
Websphere Message Broker Toolkit é um IDE poderoso para desenvolver fluxos e roteamento de mensagens.
Neste exemplo, nós aprenderemos como construir e testar um fluxo acessado via Web.
22..11 AABBRRIIRR OO WWEEBBSSPPHHEERREE MMEESSSSAAGGEE BBRROOKKEERR TTOOOOLLKKIITT Click em Iniciar � Programas � IBM Websphere � WebSphere Message Broker 6.0.2 ou clique diretamente no ícone que se encontra no desktop. Quando abrir Workspace conforme a tela abaixo, coloque o nome sugerido ”Fluxo_WS”.
Figura 1 – Escolha de Workspce
Alexandre José Batista
Criado em: 07/11/08 Página 6 de 38
22..22 CCRRIIAANNDDOO UUMM FFLLUUXXOO
22..22..11 –– PPAASSSSOO 11 –– DDEEFFIINNIINNDDOO UUMM MMEESSSSAAGGEE FFLLOOWW PPRROOJJEECCTT
Clique na área do Resource Navigator e com o botão do mouse direito crie um Message Flow Project.
Coloque o nome do projeto e clique no botão finish.
Figura 2 – New Message Flow Project
Alexandre José Batista
Criado em: 07/11/08 Página 7 de 38
22..22..22 –– PPAASSSSOO 22 –– DDEEFFIINNIINNDDOO UUMM MMEESSSSAAGGEE FFLLOOWW
Novamente com o botão do mouse direito crie um Message Flow coloque o nome sugerido.
Coloque o nome do Message Flow e clique no botão finish.
Figura 3 – Criando um Message Flow
Alexandre José Batista
Criado em: 07/11/08 Página 8 de 38
22..22..33 –– PPAASSSSOO 33 –– DDEEFFIINNIINNDDOO UUMM MMEESSSSAAGGEE SSEETT PPRROOJJEECCTT
Agora vamos criar um Message Set Project conforme figura abaixo.
Coloque o nome do Message Set Project e clique no botão Next.
Figura 4 – Criando um Message Set Project
Alexandre José Batista
Criado em: 07/11/08 Página 9 de 38
Coloque o nome do Message Set, faça um check no campo “Use namespaces” e clique no botão Next.
Figura 5 – Criando um Message Set
Selecione o formato “XML Wire Format Name” e clique no botão finish.
22..22..44 –– PPAASSSSOO 44 –– IIMMPPOORRTTAANNDDOO AARRQQUUIIVVOOSS XXMMLL
Depois de criar os objetos vamos importar os arquivos XML´s de exemplo.
Figura 6 – Importando os arquivos XML de exemplo.
Alexandre José Batista
Criado em: 07/11/08 Página 10 de 38
O conteúdo dos arquivos são :
ClienteIN.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<fl_in:ClienteIN xmlns:fl_in="http://Fluxo_WS/in">
<Dados>
<CodigoCliente></CodigoCliente>
</Dados>
</fl_in:ClienteIN>
ClienteOUT.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<fl_out:ClienteOUT xmlns:fl_out="http://Fluxo_WS/out">
<Dados>
<CodigoCliente></CodigoCliente>
<NomeCliente></NomeCliente>
<EmailCliente></EmailCliente>
<MsnCliente></MsnCliente>
</Dados>
</fl_out:ClienteOUT>
Estes arquivos servirão de base para o fluxo.
Alexandre José Batista
Criado em: 07/11/08 Página 11 de 38
22..22..55 –– PPAASSSSOO 55 –– GGEERRAARR OOSS AARRQQUUIIVVOOSS XXSSDD´́SS
Agora vamos gerar os arquivos XSD’s que é a estrutura do arquivo XML.
Figura 7 – Gerar XML Schema
Alexandre José Batista
Criado em: 07/11/08 Página 12 de 38
Coloque o nome do arquivo com o valor “ClienteIN.xsd” e clique em finish.
Figura 7.1 – Arquivo ClienteIN.xsd
Alexandre José Batista
Criado em: 07/11/08 Página 13 de 38
Fazer o procedimento para os dois arquivos, após a execução dos procedimentos, vai ficar como a figura abaixo.
Figura 7.2 – Arquivos XML´s e XSD´s
22..22..66 –– PPAASSSSOO 66 –– MMEESSSSAAGGEE DDEEFFIINNIITTIIOONN FFIILLEE..
Para que o fluxo funcione vamos criar um Message Definition File para os XSD’s criados do tipo XML Schema File.
Figura 8 – Message Definition File
Alexandre José Batista
Criado em: 07/11/08 Página 14 de 38
Selecione a opção “XML schema file” e clique em Next.
Figura 8.1 – Arquivo XML schema file
Alexandre José Batista
Criado em: 07/11/08 Página 15 de 38
Selecione todas as tag’s e clique em Next e depois em finish.
Figura 8.2 – Global Elements
Repita o procedimento de criação do Message Definition File para o arquivo ClienteOUT.xsd.
Alexandre José Batista
Criado em: 07/11/08 Página 16 de 38
22..22..77 –– PPAASSSSOO 77 –– DDEEFFIINNIINNDDOO OOSS NNOODDEESS PPAARRAA OO MMEESSSSAAGGEE FFLLOOWW
Agora volte ao Message Flow e selecione o Node HttpInput.
Clique com o botão do mouse direito em propriedade.
Figura 9 – Node http Input
Alexandre José Batista
Criado em: 07/11/08 Página 17 de 38
Coloque o endereço da URL desejada e clique em Apply.
Clique no link “Default” do lado direito e selecione o Message Set de Entrada, digite “Envelope”, no campo Message Type e clique em OK.
Figura 9.1 – Http Input Properties
Alexandre José Batista
Criado em: 07/11/08 Página 18 de 38
22..22..88 –– PPAASSSSOO 88 –– SSEELLEECCIIOONNEE OOSS DDEEMMAAIISS NNOODDEESS
Agora selecione os Nodes (SOAPExtract, Mapping e HttpRequest) para completar o fluxo.
Figura 10 – Nodes SOAPExtract, Mapping e http Reply
Alexandre José Batista
Criado em: 07/11/08 Página 19 de 38
22..22..99 –– PPAASSSSOO 99 –– FFAAZZEENNDDOO OO MMAAPPEEAAMMEENNTTOO DDOOSS DDAADDOOSS CCOOMM OO NNOODDEE MMAAPPPPIINNGG
Com o botão do mouse direito em Mapping clique em “Open Map”.
Clique em Next até aparecer a tela de mapeamento.
Figura 11 – Mapping Node
Clique em Next e depois em Finish.
Alexandre José Batista
Criado em: 07/11/08 Página 20 de 38
A próxima tela fica como a Figura 11.1
Figura 11.1 – Mensage Source e Target
Alexandre José Batista
Criado em: 07/11/08 Página 21 de 38
Vai aparecer a tela como a Figura 11.2, que é a tela de Mapeamento dos campos.
Arraste o campo código do Cliente do lado esquerdo para o campo Código do Cliente do lado Direito, logo em seguida preencha os demais campos com os valores desejados.
Figura 11.2 – Tela de Mapeamento dos Campos
Alexandre José Batista
Criado em: 07/11/08 Página 22 de 38
22..22..1100 –– PPAASSSSOO 1100 –– MMEESSSSAAGGEE CCAATTEEGGOORRYY FFIILLEE
Agora vamos criar um Message Category File utilizado para criar o arquivo WSDL.
Figura 12 – Message Category File
Clique em Next.
Figura 12.1 – Categoria tipo WSDL (Request e Response)
Alexandre José Batista
Criado em: 07/11/08 Página 23 de 38
Coloque o nome “CatFileFluxoWS” e clique em Next.
Figura 12.2 – Nome do arquivo de Categoria
Alexandre José Batista
Criado em: 07/11/08 Página 24 de 38
Selecione os tipos de dado ClienteIN e ClienteOUT, altere o campo Kind do ClienteOUT para “output” e clique em finish.
Figura 12.3 – Definindo a entrada (Input) e saída (Output)
Alexandre José Batista
Criado em: 07/11/08 Página 25 de 38
22..22..1111 –– PPAASSSSOO 1111 –– DDEEFFIINNIINNDDOO OO WWSSDDLL PPAARRAA OO FFLLUUXXOO
Agora vamos criar um arquivo WSDL para o Fluxo.
Figura 13 – WSDL Definition
Alexandre José Batista
Criado em: 07/11/08 Página 26 de 38
Selecione o Fluxo e clique em Next.
Figura 13.1 – WSDL Definition from Message Set
Alexandre José Batista
Criado em: 07/11/08 Página 27 de 38
Deixe o formato como “single” e clique em Next.
Figura 13.2 – Formato do WSDL - Simples
Alexandre José Batista
Criado em: 07/11/08 Página 28 de 38
Na próxima tela deixe tudo como está e clique em Next.
Figura 13.3 – O Estilo do WSDL é “document”
Alexandre José Batista
Criado em: 07/11/08 Página 29 de 38
Selecione o arquivo de Categoria e clique em Next.
Figura 13.4 – Selecione o arquivo de Categoria para o WSDL
Alexandre José Batista
Criado em: 07/11/08 Página 30 de 38
Selecione “SOAP/HTTP” e clique em Next.
Figura 13.5 – Formato do Binding é SOAP/http
Alexandre José Batista
Criado em: 07/11/08 Página 31 de 38
Altere o valor do campo “Port Address” para “HTTP://localhost:7080/Fluxo_WS e clique em finish.
Figura 13.6 – Port Address do Fluxo
Alexandre José Batista
Criado em: 07/11/08 Página 32 de 38
Pronto o arquivo WSDL foi gerado.
Figura 13.7 – Arquivo WSDL Gerado
22..33 –– DDEEPPLLOOYY DDOO FFLLUUXXOO
Agora mude para a perspectiva de administração do Broker, nesta perspectiva você tem todos os elementos necessários para fazer o deploy.
Não vamos discorrer sobre como conectar ao Configuration Manager, estamos partindo do fato de esta configuração já esteja em perfeito funcionamento.
Figura 14 – Broker Administration
Alexandre José Batista
Criado em: 07/11/08 Página 33 de 38
22..33..11 –– CCRRIIAARR UUMM MMEESSSSAAGGEE BBRROOKKEERR AARRCCHHIIVVEERR
Vamos criar um Message Broker Archiver com o nome “Fluxo_WS” e clique em OK .
Figura 15 – Message Broker Archiver
Alexandre José Batista
Criado em: 07/11/08 Página 34 de 38
Clique no botão “+” para adicionar os arquivos ao BAR.
Selecione os arquivos e clique em OK e depois Salve.
Figura 15.1 – Colocando arquivos no Broker Archiver
Alexandre José Batista
Criado em: 07/11/08 Página 35 de 38
22..33..22 –– DDEEPPLLOOYY DDOO AARRQQUUIIVVOO BBAARR ((BBRROOKKEERR AARRCCHHIIVVEERR))
Com o arquivo BAR pronto, agora vamos fazer o deploy.
Figura 16 – Deploy do Arquivo BAR
Alexandre José Batista
Criado em: 07/11/08 Página 36 de 38
Escolha o Execution Group “default” e clique em OK.
Figura 16.1 – Deploy no Execution Group
Pronto o deploy foi realizado com Sucesso.
Alexandre José Batista
Criado em: 07/11/08 Página 37 de 38
3. TESTANDO O FLUXO
Para verificar se nosso fluxo está funcionando vamos utilizar o Software SoapUI que você pode baixar no link (www.soapui.org) .
Pronto você acaba de fazer um fluxo no Message Broker e acessa-lo por Web Service.
Alexandre José Batista
Criado em: 07/11/08 Página 38 de 38
4. REFERÊNCIAS
[IBM 08] – www.ibm.com/software/integration/wbimessagebroker (30/10/2008)
[SOAPUI] – www.soapui.org (07/11/2008)