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

1. Abra o IIS em Control Panel -> Administrative Tools.
2. No Painel Esquerdo clique com o botão direito do mouse em “Web Service Extensions” -> “Add a new Web Service Extension”.
3. Set a propriedade “Extension Name” para SampleHTTPReceive.
4. Em “Required Files” clique no botão “Add” e aponte para a dll BTSHTTPReceive.dll localizada em \Program Files\Microsoft BizTalk Server 2006\HttpReceive.
5. Cheque a opção “Set extension status to Alowed”. Clique em OK.

Criar um novo Application Pool

1. Clique com o botão direito em “Application Pools” -> “New” -> “Application Pool”.
2. Set o “Application pool ID” para CustomHTTPReceive.
3. Deixe a opção “Use default settings for new application pool” marcada e clique em OK.

   

4. Clique com o botão direito no Application Pool que foi criado e clique em “Propriedades”.
5. Na Tab “Identity”, cheque a opção “Configurable”.
6. Em “User Name” coloque o usuário que tem acesso para ler e gravar no Banco de Dados do Biztalk.
7. Em “Password”, coloque a senha correspondente. Clique em OK.

Criar um novo Virtual Directory

1. No Painel esquerdo expanda a pasta “Web Sites” e clique com o botão direito em “Default Web Site” clique em “New” -> “Virtual Directory”.
2. Na tela do Wizard clique no botão “Next” e em “Alias” coloque SampleHTTPReceive.
3. Clique em “Next” e na propriedade “Path” aponte para a pasta onde está a DLL BTSHTTPReceive.dll, \Program Files\Microsoft BizTalk Server 2006\HttpReceive
4. Na tela de Permissões de Acesso, cheque as opções “Read” e “Execute (Such as ISAPI application or CGI)”.
5. Clique em Next e Finish para Finalizar.

   

6. Clique com o botão direito no Virtual Directory que foi criado no passo anterior e em “Propriedades”.
7. Na aba “Virtual Directory”, tenha certeza que na propriedade “Execute Permissions” a opção “Scripts and Executables” esteja selecionada.
8. 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

1. No Biztalk Administration Console crie um novo Application.
2. Clique com o botão direito em Receive Port, “New” -> “One-way Receive Port”. Altere o nome para RP_HTTP.
3. Clique na aba “Receive Locations” e em “New”. Altere o nome para RL_HTTP.
4. Em “Type”, escolha a opção “HTTP”.
5. Clique no botão “Configure”.
6. Em “Virtual Directory plus ISAPI extensions” digite “/SampleHTTPReceive/BTSHTTPReceive.dll”.

   

7. Clique em OK.
8. Deixe o Receive Pipeline como PassThruReceive.

   

9. 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.

1. Clique na Send Port do seu Application.
2. Clique com o botão direito em “New” -> “Static On-Way Send Port”.
3. Renomeie a Send Port para snd_SampleHTTP.
4. Em “Transport” selecione “FILE” na opção “Type” e clique no botão “Configure”.
5. Em “Destination Folder” escolha um diretório para criar os arquivos. Clique em OK.
6. 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.