Biztalk Development Series (35) TCP/IP Adapter

Biztalk's TCP/IP adapter was initially developed for the health care industry in the UK. This adapter is an adapter in the BizTalk process. It connects messages to the remote client through TCP/IP string.

TCP/IP adapters support the following interactive modes:

• Request only messages are sent to BizTalk and routed to any process (orchestration) or sending port.
• The request-response message is sent to BizTalk and received from the remote server returned by BizTalk.
• Solicit only sends messages from BizTalk to the remote server.
• Solicit-response messages are sent from BizTalk to the remote server and receive the returned information from the remote server.
• Dynamic solicit dynamic transmission.
• Duplex request client's full-duplex request.
• Duplex solicit BizTalk's full-duplex request.

 

Preparations and installation before use

Biztalk does not contain TCP/IP adapters. Therefore, you must first download the installation file from the btstcpip site of codeplex before use. The installation process is relatively simple, however, you must note that the configuration file content in the file dialog box is required after installation or during installation.ManualTo the biztalkruntime configuration file (btsntsvc.exe. config ).

Otherwise, an exception "the type initializer for 'Microsoft. samples. BizTalk. Adapter. tcp. Receive. receiveadapter 'threw an exception." will occur during running.

 

Add an adapter

After the installation is complete, you need to add the adapter in the BizTalk console to create a host for receiving and sending the TCP/IP adapter.

In the properties configuration window of the adapter, enter the appropriate name and select the adapter in the adapter options list. After the application is applied, the receiving and sending hosts of the adapter are displayed in the window on the right.

 

Demo

For details about the adapter, refer to the TCPIP adapter User Guide in the installation directory. In the following demonstration, we will also use the tcpclient.exe, tcpserver.exe tool in the installation directory. As the TCP request client and TCP server respectively. If you are interested in the content transmitted over TCP, you can also use tcptrace (a third-party tool) to monitor data packets during transmission.

The following two scenarios are better understood: one is one-way request and two-way request. The logic is to create a TCP/IP receiving port in BizTalk to listen to requests sent from tcpclient.exe. Create a sending port to subscribe to data transmitted from the corresponding receiver port. And the message is sent to tcpserver.exe. For specific configuration procedures, refer to the user manual.

 

One-way request

1. Receive port configuration

2. TCP receiving adapter property Configuration

3. Send Port Configuration

4. TCP sending adapter property Configuration

5. Results

 

Two-way request

The configuration steps are basically the same as the one-way configuration. You only need to select the two-way port type when creating the port.

1. tcpserver Configuration

2. Requests and results

 

[S] used in TCP adapter configuration, [e] is the starting and ending character recognized by the receiving adapter and cannot be modified. [Start] and [end] can be modified as the start and end of the returned data. In addition, the TCP/IP adapter also supports duplex access.

Biztalk Development Series (35) TCP/IP Adapter