Recently I decided to try out the BizTalk Server Pipeline Component
Wizard when creating
a new pipeline component for BizTalk 2009.
There are different versions of the
wizard available, so be sure to download the appropriate version for the BizTalk environment that you are working with.
Following the download and expansion of the zip file, you should be left with
a Visual Studio solution. Open this solution and build the project.
Following this installation is straight foward - locate and run the built setup.exe file in the PipelineComponentWizard Setup project and click through the small number of installation screens.
Once you have completed installation you will be ready to use the
wizard in Visual Studio to create your BizTalk Pipeline Component.
Start by creating
a new project, selecting BizTalk Projects then BizTalk Server Pipeline Component. You will then be presented with the splash screen.
The next step is General Setup, where you will detail the classname, namespace, pipeline and component types, and the implementation language for your Pipeline Component.
The options for pipeline type are Receive, Send or Any.
Depending on the pipeline type chosen there are different options presented for the component type, matching those available within the BizTalk Pipelines themselves:
Receive - Decoder, Disassembling Parser, Validate, Party Resolver, Any.
Send - Encoder, Assembling Serializer, Any.
Any - Any.
The options for implementation language are C# or VB.Net
Next you must set up the UI settings - these are the settings that affect the appearance of the pipeline component within Visual Studio.
You must detail the component name, version, description and icon.
Next is the definition of the variables that the pipeline component will use. The values for these variables will be defined in Visual Studio when creating
a pipeline.
The options for each variable you require are:
Designer Property - The name of the variable.
Data Type - String, Boolean, Integer, Long, Short, Schema List, Schema With None
Clicking finish now will complete the
wizard stage of the creation of your pipeline component.
Once the
wizard has completed you will be left with
a BizTalk Server Pipeline Component project containing
a skeleton code file for you to complete.
Within this code file you will mainly be interested in the execute method, which is left mostly empty ready for you to implement your custom pipeline code:
#region IComponent members
/// <summary>
/// Implements IComponent.Execute method.
/// </summary>
/// <param name="pc">Pipeline context</param>
/// <param name="inmsg">Input message</param>
/// <returns>Original input message</returns>
/// <remarks>
/// IComponent.Execute method is used to initiate
/// the processing of the message in this pipeline component.
/// </remarks>
public Microsoft.BizTalk.Message.Interop.IBaseMessage Execute(Microsoft.BizTalk.Component.Interop.IPipelineContext pc, Microsoft.BizTalk.Message.Interop.IBaseMessage inmsg)
{
//
// TODO: implement component logic
//
// this way,
it's
a passthrough pipeline component
return inmsg;
}
#endregion
Once you have implemented your custom code, build and compile your Custom Pipeline Component then add the compiled .dll to C:\Program Files\Microsoft BizTalk Server 2009\Pipeline Components .
When creating
a new pipeline, in Visual Studio reset the toolbox and the custom pipeline component should appear ready for you to use in your Biztalk Pipeline.
Drop the pipeline component into the relevant pipeline stage and configure the component properties (the variables defined in the wizard).
You can now deploy and use the pipeline as you would any other custom pipeline.
