BizTalk 2004 Web Services

BizTalk 2004 has great Web Service support; you can create an orchestration as usual and then expose it for invocation as a Web Service by using the Biztalk Web Services Publishing Wizard which is located on the Tools Menu inside VS.NET, and you can of course consume Web Services from within an orchestration.

To expose an orchestration as a Web Service you run through the Wizard and select the Port(s) in your orchestration that you want to expose via a Web Service, and the magic happens – Note the “Create BizTalk Receive Locations” option, if you check this it will create the Receive Locations (visible with BizTalk Explorer) for you which is handy.

This works really well in almost all circumstances, if you however have multiple receive ports within your Orchestration you’ll see that they are exposed as separate Web Services (within the same IIS virtual directory), this works just fine but it’s a bit neater (in my view) to perhaps have one Web Service that exposes a method per port, instead of the consumer having to use two or more Web Services endpoints.

The Wizard doesn’t allow you to configure the generated web service to enable this, but it’s pretty straight forward to do:

· Create the ASP.NET Web Service that you wish to expose to your consumers; this will become the consumers interface to your BizTalk Orchestration(s).
Create the methods that you require

· Use the Biztalk Web Services Publishing Wizard tool to publish all of the relevant ports from your Orchestration. Do not check the “Create BizTalk Receive Locations”

The Web Services Publishing Wizard will create a new Virtual Directory in Internet Information Server, and this will contain a new Web Service per Receive port.

· A Web Service consists of two files: <Name>.asmx and a <Name>.asmx.cs file. The ASMX file is the Web Service endpoint and the CS file is the C# code relating to it.

· If you inspect the .asmx.cs files you will see that they all belong to the same namespace, and contain one method each which contains the code to pass the parameters to the Orchestration.

· To combine the methods you must manually copy of the methods from the ASMX.CS files into one ASMX.CS file. You can rename this ASMX file to a more suitable name if you wish

· If you now retrieve the WSDL for the Web Service containing all of the methods you will see that two methods are exposed.

e.g:https://<YourServerName>/<YourVirtualDirectory>/<YourWebServiceName>.asmx?wsdl

· The Web Service now exposes all of the ports via individual methods inside one Web Service, you must now configure a BizTalk receive port to accept SOAP messages from this Web Service. Otherwise BizTalk will reject the messages as the sender is unrecognized.

· In the BizTalk Explorer, Create a new Receive Port, Select the Port Type as being a Request-Receive port. Within the Properties for this Receive port select Microsoft.BizTalk.DefaultPipelines.PassThruTransmit as the Receive Pipeline

Expand your newly created Receive port and Add a New Receive Location. Choose SOAP as the transport type, and open the dialog to set the Address (URI) for this Transport.

Enter the Virtual directory and Web Service name in the textbox provided, e.g. /MyWebService/Service1.asmx.
Note – This Web Service name will be the ASMX file that we copied the methods into above

· Within the BizTalk explorer you must now Bind the Receive port we’ve created to the Orchestration, ensure that you bind all of the Receive ports on your Orchestration to the same Receive port. Give it a whirl!