Introduction

Step by step guide

Step 1:     Create a new BizTalk project in visual studio. For example let’s call this “ESB.Samples.Itinerary.Extenders”.

Step 2:     Add references to the ESB assemblies needed which are

All these should be added from the server GAC.

Step 3:     Add a new orchestration to this assembly and call it (for example) ProcessGWMsg.

Step 4:     Add a direct bound receive port to get the message from the message box database

Step 5:     Add a new message with the expected message type you will be processing in this orchestration.

Step 6:     Add a receive shape to this orchestration and choose the message variable you will receive the message in and link that to the direct receive port already created and mark the Activate property of this shape to True.

Step 7:     Open the editor for the filter expression property of this orchestration.

Step 8:     Add a filter expression like the below

The service name should be unique between all your custom orchestrations to make sure there is no multiple-subscription (unless this is needed of course).

Step 9:     Give the assembly a strong name, build it, and deploy the assembly to the GAC using the command
gacutil /I ESB.Samples.Itinerary.Extenders.dll

Step 10:  Using the command
gacutil /l ESB.Samples.Itinerary.Extenders

Step 11:  Mark the strong assembly full name.

Step 12:  Open the ESB.Config file in the path “C:\Program Files (x86)\Microsoft BizTalk ESB Toolkit 2.1”

Step 13:  Search for the section itineraryServices and add a new line at the end of this section as below:

Where the id actually is a new generated GUID and the ProcessMsg is the name of the orchestration you will be creating later.

Step 14:  Close visual studio and start it over.

Step 15:  Create a new itinerary called for example “MsgProcessingIti”. Now add to this itinerary all the on-ramp, off-ramp, and itinerary services you want to process your messages. But what we will be interested in is how to call the custom orchestration.

Step 16:  Add a new itinerary service

Step 17:  Change the extender to be an orchestration extender

Step 18:  Open the service name property and you will find the ProcessGWMsg orchestration. Select that.

Step 19:  Now add all the needed resolvers for this itinerary service as needed.

Step 20:  Validate, save, and publish the itinerary to the itinerary database.

Step 21:  Now revert back to the orchestration and define new variables to handle itinerary operations as below

Step 22:  Define a new correlation type called “ItineraryAdvance” and define it to include the properties

BTS.OutboundTransportLocation,BTS.OutboundTransportType

Microsoft.Practices.ESB.Itinerary.Schemas.IsRequestResponse

Microsoft.Practices.ESB.Itinerary.Schemas.ServiceName

Microsoft.Practices.ESB.Itinerary.Schemas.ServiceState

Microsoft.Practices.ESB.Itinerary.Schemas.ServiceType

Step 23:  Define a new correlation set of the previously created type in the orchestration with the name “ItineraryAdvanceSet”
Now the real purpose of this correlation set is to promote the itinerary properties to allow the message to be routed to the next itinerary service step.

Step 24:  Add a new expression shape to initialize the itinerary variables as below.

Step 25:  You can access the resolvers in the current executing itinerary service by first making sure we have resolvers by adding a decide shape as below.

Where the “ResolverValid” condition is as below.

Step 26:  And to get the resolver dictionary

Step 27:  And to configure a dynamic send port using parameters coming out of the resolver

Step 28:  Finally when you done processing and want to advance the itinerary you create a new message that will pass to the next step and while creating this message add a message assignment shape with the code.

Step 29:  And when you are sending this message you send it using a direct port to the message box and initialize the correlation set already added to the orchestration previously.

Step 30:  Now edit the orchestration to process the messages as you need.