Click here to Skip to main content
14,084,724 members
Click here to Skip to main content
Add your own
alternative version


24 bookmarked
Posted 15 Apr 2006
Licenced CPOL

Keep The Orchestration Simple (KTOS) - A BizTalk Pattern

, 26 Apr 2006
Rate this:
Please Sign up or sign in to vote.
This article describes a pattern wherein an Orchestration is independent of the transformation map.

Sample Image - Architecture.png

Introduction - KISS vs. KTOS

If KISS stands for "Keep It Simple Stupid", then KTOS stands for "Keep The Orchestration Simple".

Designing a robust and extensible orchestration is the key to any successful BizTalk implementation. This article describes a simple pattern which frees the Orchestration from a Transform Shape.

Scenario and the problem to be solved

Consider a scenario where a Purchase Order (PO) needs to be processed and a Purchase Order Acknowledgement (POAck) needs to be transmitted. Every incoming PO has a particular format which needs to be transformed into, an internal PO format, in order to be able to process it. Similarly, every outgoing POAck has a different format which needs to suit the receiver. The problem is how to add new incoming PO and outgoing POAck formats to the system once the system is operational.

The BizTalk Solution

The BizTalk Orchestration should abstract itself from any other external schemas. The Orchestration has knowledge of only one schema known as "UniversalPO". All incoming external PO schemas need to be mapped into this UniversalPO, and similarly, all the outgoing POs need to be mapped into appropriate POAcks.

The solution has been divided into three main parts; the PurchaseOrder project is the core of the solution. PO_CompanyA references the PurchaseOrder project, and the two maps are added: one transforms the external PO into Universal_PO and another transforms Univeral_PO into POAck as required by the external system. The Orchestration diagram below presents a better picture.

Main Orchestration


This Orchestration processes the PO by calling an external .NET component known as BizRules which is present in the Global Assembly Cache (GAC).

BizRules .NET component

The class diagram for the BizRules.NET component is shown below...


Send Port configuration


The transformation map specified in the "Send" Port converts "UniversalPO" into "POAck".

Receive Port configuration


The transformation map specified in the "Receive" Port converts "PO_A" into "UniversalPO".

Solution Explorer


Follow these steps to add a new PO format

In order to support a new PO format after the BizTalk solution is deployed, the following needs to be done...

  • Add new external, incoming, and outgoing schemas in a new project.
  • Two maps are required to be added, one for converting the "external PO" into "internal PO", and another for converting the "internal PO" into "POAck" as required by the external system.
  • Add the maps in the new Receive and Send Ports.


In this article, we have seen how to structure our BizTalk artifacts in order to ensure painless (post-deployment) maintenance of a BizTalk Solution. Generally speaking, being aware of the dependencies of the project will ensure avoidance of re-compilation and re-deployment.


  • All promoted properties and distinguished fields must be initialized with the default values in the schema.
  • Generally, all schemas must be placed in a separate project/DLL, and all related Orchestrations must also be placed in a separate project/DLL.
  • It is generally observed, in many cases, that map transformations are done within the Orchestration; this is unnecessary, and the same can be achieved in the Send and Receive Ports as demonstrated in the article.


This article, along with any associated source code and files, is licensed under The Code Project Open License (CPOL)


About the Author

Naveen Karamchetti
Architect AT&T Wi-Fi Services
United States United States
Naveen has done his Masters (M.S.) in Computer science, has started his career programming the mainframes and now has more than a decade of programming, development and design experience. Naveen has a sharp eye and keen observation skills. Naveen has worked for several companies and strived hard to build large scale business applications and bringing better solutions to the table.
Quite recently Naveen has built a fairly complex integration platform for a large bank. His hobbies include training, mentoring and research. Naveen spends his free time visiting National Parks nationwide.

Naveen has developed the BizTalk Control Center (BCC)

You may also be interested in...

Comments and Discussions

QuestionRegarding xml debatch Pin
raghavdon13-Mar-09 8:59
memberraghavdon13-Mar-09 8:59 
AnswerRe: Regarding xml debatch Pin
Naveen Karamchetti24-Mar-09 12:37
professionalNaveen Karamchetti24-Mar-09 12:37 
Questionhow to configure send port for more than one partner Pin
AlaaJarrah28-Apr-08 12:34
memberAlaaJarrah28-Apr-08 12:34 
AnswerRe: how to configure send port for more than one partner Pin
Naveen Karamchetti24-Mar-09 12:39
professionalNaveen Karamchetti24-Mar-09 12:39 
Generalsimple but complicate things Pin
Bogdan Nedelcu17-Apr-06 20:25
memberBogdan Nedelcu17-Apr-06 20:25 
GeneralRe: simple but complicate things Pin
Naveen Karamchetti17-Apr-06 21:29
professionalNaveen Karamchetti17-Apr-06 21:29 
It is from people like you, that I derive energy and inspiration to write more BizTalk articles. I work on BizTalk full time and am trying to write atleast 1 article per week.

thanks for the comments.

Always be there....| MCSD.NET | Sun Certified...
GeneralRe: simple but complicate things Pin
Brad Friedlander20-Apr-06 4:08
memberBrad Friedlander20-Apr-06 4:08 
GeneralRe: simple but complicate things Pin
jmicksch26-Apr-06 10:35
memberjmicksch26-Apr-06 10:35 

General General    News News    Suggestion Suggestion    Question Question    Bug Bug    Answer Answer    Joke Joke    Praise Praise    Rant Rant    Admin Admin   

Use Ctrl+Left/Right to switch messages, Ctrl+Up/Down to switch threads, Ctrl+Shift+Left/Right to switch pages.

Permalink | Advertise | Privacy | Cookies | Terms of Use | Mobile
Web03 | 2.8.190518.1 | Last Updated 27 Apr 2006
Article Copyright 2006 by Naveen Karamchetti
Everything else Copyright © CodeProject, 1999-2019
Layout: fixed | fluid