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.
