The AS2 Sender utility shipped with BizTalk Server enables you to send an AS2 message to a Web site on a single computer. This utility simulates the sending of an AS2 message from a separate computer.
The AS2 Sender utility files are located in \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\AS2 Tutorial\Sender.
Prerequisites
You must be logged on as a member of the BizTalk Server Administrators group.
What This Utility Does
The AS2 Sender utility builds an AS2 message with an EDI payload, and sends that message to a Web site that uses the BTSHTTPReceive ISAPI filter. By default the tutorial does the following:
Sends an AS2 message named X12_00401_864.edi with an 864 X12-encoded payload. This message is located in the \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\AS2 Tutorial folder.
Prompts an asynchronous MDN in response to the AS2 message. This is determined by the message sent, and can be changed.
Sends the AS2 message to a receive location through the Contoso virtual directory.
Configure a Web page and a receive location to receive the AS2 message. In the default AS2 Sender utility, the Web page is the Contoso Web page.
Deploy the schema for the EDI interchange that you will send as a payload of the AS2 message.
Set the appropriate AS2 and EDI party properties.
How to Customize the AS2 Sender Utility
The default AS2 Sender utility sends a test 864 EDI interchange over AS2 to a Contoso Web page using the BTSHTTPReceive ISAPI filter. The AS2 message, named X12_00401_864.edi, prompts an asynchronous MDN. The AS2 Sender utility code is located in HttpSender.cs in the \Program Files (x86)\Microsoft BizTalk Server <VERSION>AS2 Tutorial\Sender folder. The following line of code in HttpSender.cs sends the default 864 test file:
Stream sr = new FileStream(getBizTalkInstallPath() + @"SDK\AS2 Tutorial\X12_00401_864.edi", FileMode.Open, FileAccess.Read);
Note
You can modify this line with a different file name and different path.
The following line in HttpSender.cs sends an AS2 message named X12_00401_864-Sync.edi. This message prompts a synchronous MDN. By default, this line of code in HttpSender.cs is commented out in favor of the line that sends X12_00401_864.edi. To send X12_00401_864-Sync.edi, uncomment the X12_00401_864-Sync.edi line and comment out the X12_00401_864.edi line.
Stream sr = new FileStream(getBizTalkInstallPath() + @"SDK\AS2 Tutorial\X12_00401_864-Sync.edi", FileMode.Open, FileAccess.Read);
The following line of code in HttpSender.cs sends the message to the Contoso Web page:
HttpSender TestSender = new HttpSender("http://localhost/Contoso/BTSHttpReceive.dll");
Note
You can modify this line with a different virtual directory and ISAPI filter.
To build the AS2 Sender sample
In Visual Studio, open the Sender.csproj project in the \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\AS2 Tutorial\Sender folder.
Open HttpSender.cs in the Sender project, and customize the Sender code with the appropriate receiving Web page and the appropriate EDI filename and path.
Right-click the Sender project, and then click Properties.
Click Signing in the left-hand console. Ensure that Sign the assembly is selected, and the strong name key file is set to Sender.snk. Make sure that Delay sign only is cleared.
Build the project.
To run the AS2 Sender sample
Open a command prompt. Move to \Program Files (x86)\Microsoft BizTalk Server <VERSION>SDK\AS2 Tutorial\Sender\bin\debug.
Enter Sender.exe, and then press Enter.
Verify that you see a message indicating that an AS2 message was successfully sent, and then close the command prompt.
Do you want to know how to send and receive electronic documents in Business Central? This module explains the setup that is required to send electronic documents, and then it demonstrates how to send and receive electronic PEPPOL documents with and without a provider.