This is the third part of HL7 essential for BizTalk developer , in this post I want speak about the essential things about HL7 development
The first is the HL7 project, a HL7 project is always divided in three parts, when we start a new HL7 project we must follow these steps (it is not really important the creation order)

Select an empty HL7 project for the first


The second important step, add new HL7 project and select the BTAHL7V2XCommon, this project include the common HL7 schema message parts


ACK for acknowledgement and MSH for Header

And for the last we must add the most important project, see picture below


These are the HL7 definitional schemas projects, the project that you’ll select must respect the HL7 version required

In this sample I select 2.3.1 HL7 version that correspond to BTAHL7V231Common project

Now we can start with the our first HL7 base solution.

Add new HL7 Schemas to main project, the HL7 accelerator has many schemas for many HL7 message type (ORM,ODT , etc.)
Select Add new BTAHL7 schema



now select Version, Message Type and, most important thing, the event trigger (

At this time I select 2.3.1 version, ORM message type and O01 event

This is the most important thing that a BizTalk developer must know to start, a HL7 project is divided in three parts


The second is to add BTAHL7V231Common project and BTAHL7V2XCommonproject as references to the main project


This is the base of HL7 project, now we can add our orchestrations, add other projects and so on

The two last and important essential things to start with HL7 development are the BizTalk parties and pipelines.

Without a BizTalk party and pipelines we cannot work with HL7 accelerator features for example the acknowledgement
In the HL7 pipelines in the disassembler

Now create a new BizTalk party, in the Value column you must enter the value of MSH.3 field of message header (


Now we can start to configure our BTAHL7 and now you’ll notice a new voice


ok now we are ready to exploit all the potential of the HL7 accelerator


Remember to use the HL7 pipelines in your BizTalk ports, the most important thing that you must know about HL7 pipelines is:

There are four pipelines (send/receive), two for FLAT file and two for XML file

If you need to create a custom pipeline you can use the HL7 pipeline components



Best Resources:

The best resource about HL7 is the Howard S. Edidin’s book, HL7 for BizTalk, this book is updated with the last BizTalk version and it is the most detailed resource about HL7 and BizTalk Server.

You can find the book here

Previous articleBizTalk HL7 essential knowledge part 2
Next articleNew BizTalk Book! BizTalk Server 2010 Cookbook
I have +25 years of hands-on experience in Cloud Technologies and Cybersecurity, supporting and driving global companies to adopt technologies in the most secure and profitable way. My cores expertises are Security and Cloud Governance, and I strongly believe in the conjunction of both to achieve the top result. In my career, I had the opportunity to lead global cloud infrastructures, providing guidance and leadership in Security and Cloud Governance. Security is my first passion, but I have deep experience in many other areas like Cloud Governance and Integration. I define myself as a very versatile person. In my past, I had the opportunity to work in many different areas, supporting different company roles, from technical roles to Sales, Pre-Sales and High Stakeholders. I see myself as a hands-on geek manager. I love to get my hands dirty and also be able to lead and create important things and initiatives. Mt passion for technology is also the reason for my activities in the IT community. I love sharing my experience and motivating people on engaging the technology with the right motivation and passion. I do conferences around the world, sharing my passion. I have been Microsoft MVP since 2006, Certified Ethical Hacker (CEH) and with a Master in Cybersecurity.


Please enter your comment!
Please enter your name here