Configurando Receive Port com HTTP Adapter
Fiquei muito feliz com o convite do Blog, e tentarei escrever com bastante freqüência. Hoje vou falar um pouco sobre como receber mensagens através do HTTP Adapter.
Na minha experiência com o Biztalk sempre foi muito comum, receber e enviar mensagens através de Web Service, trabalhando com o SOAP Adapter.
Porém recentemente precisei fazer a comunicação usando protocolo HTTP, pois o cliente não tinha outro serviço disponível.
Para receber mensagens com o HTTP Adapter precisaremos configurar o IIS. Nesse artigo usaremos o IIS 6.0.
Para Configurar o IIS 6.0
Configurar Web Service Extensions
- Abra o IIS em Control Panel -> Administrative Tools.
- No Painel Esquerdo clique com o botão direito do mouse em “Web Service Extensions” -> “Add a new Web Service Extension”.
- Set a propriedade “Extension Name” para SampleHTTPReceive.
- Em “Required Files” clique no botão “Add” e aponte para a dll BTSHTTPReceive.dll localizada em \Program Files\Microsoft BizTalk Server 2006\HttpReceive.
- Cheque a opção “Set extension status to Alowed”. Clique em OK.
Criar um novo Application Pool
- Clique com o botão direito em “Application Pools” -> “New” -> “Application Pool”.
- Set o “Application pool ID” para CustomHTTPReceive.
- Deixe a opção “Use default settings for new application pool” marcada e clique em OK.
- Clique com o botão direito no Application Pool que foi criado e clique em “Propriedades”.
- Na Tab “Identity”, cheque a opção “Configurable”.
- Em “User Name” coloque o usuário que tem acesso para ler e gravar no Banco de Dados do Biztalk.
- Em “Password”, coloque a senha correspondente. Clique em OK.
Criar um novo Virtual Directory
- No Painel esquerdo expanda a pasta “Web Sites” e clique com o botão direito em “Default Web Site” clique em “New” -> “Virtual Directory”.
- Na tela do Wizard clique no botão “Next” e em “Alias” coloque SampleHTTPReceive.
- Clique em “Next” e na propriedade “Path” aponte para a pasta onde está a DLL BTSHTTPReceive.dll, \Program Files\Microsoft BizTalk Server 2006\HttpReceive
- Na tela de Permissões de Acesso, cheque as opções “Read” e “Execute (Such as ISAPI application or CGI)”.
- Clique em Next e Finish para Finalizar.
- Clique com o botão direito no Virtual Directory que foi criado no passo anterior e em “Propriedades”.
- Na aba “Virtual Directory”, tenha certeza que na propriedade “Execute Permissions” a opção “Scripts and Executables” esteja selecionada.
- Na opção “Application Pool” selecione o Application Pool que foi criado anteriormente, no nosso caso CustomHTTPReceive. Clique em OK.
Para configurar a Receive Location
- No Biztalk Administration Console crie um novo Application.
- Clique com o botão direito em Receive Port, “New” -> “One-way Receive Port”. Altere o nome para RP_HTTP.
- Clique na aba “Receive Locations” e em “New”. Altere o nome para RL_HTTP.
- Em “Type”, escolha a opção “HTTP”.
- Clique no botão “Configure”.
- Em “Virtual Directory plus ISAPI extensions” digite “/SampleHTTPReceive/BTSHTTPReceive.dll”.
- Clique em OK.
- Deixe o Receive Pipeline como PassThruReceive.
- Clique em Ok mais 2 vezes para Finalizar.
Configurando a Send Port
Para testar a aplicação, vamos precisar de uma send port, que enviará para um diretório as mensagens que chegarão através do HTTP.
- Clique na Send Port do seu Application.
- Clique com o botão direito em “New” -> “Static On-Way Send Port”.
- Renomeie a Send Port para snd_SampleHTTP.
- Em “Transport” selecione “FILE” na opção “Type” e clique no botão “Configure”.
- Em “Destination Folder” escolha um diretório para criar os arquivos. Clique em OK.
- Na Aba “Filters”, no painel direito em “Property” selecione “BTS.ReceivePortName”, em Operator deixe o sinal de “==”, e em value coloque “RP_HTTP”. Clique em Ok.
Agora ficou faltando iniciar as portas e testar a aplicação.
Para testar digite no Internet Explorer: http://localhost/SampleHTTPReceive/BTSHTTPReceive.dll?LocationID=1
No diretório de instalação do Biztalk, em \Program Files\Microsoft BizTalk Server 2006\SDK\Samples\AdaptersUsage\HTTPRequestResponse, existe um exemplo, de como receber mensagens através do HTTP Adapter com Request e Response trabalhando com orchestration. Dentro da pasta você irá encontrar um setup.bat que ao clicar irá instalar a aplicação e inclusive um pequeno site para enviar as mensagens: http://localhost/RequestResponse/default.aspx
Espero que tenham gostado.
Até a próxima.
