[CONF] Apache Camel: HL7 DataFormat (page edited)

Thu, 26 Feb 2009 04:52:35 -0800

Page Edited : CAMEL : HL7 DataFormat

HL7 DataFormat has been edited by Claus Ibsen (Feb 26, 2009).

(View changes)

Content:

HL7 DataFormat

The HL7 component ships with a HL7 dataformat that can be used to format between String and HL7 model objects.

  • marshal = from Message to byte stream (can be used when returning as response using the HL7 MLLP codec)
  • unmarshal = from byte stream to Message (can be used when receiving streamed data from the HL7 MLLP

To use the data format simply instantiate an instance and invoke the marhsal or unmarshl operation in the route builder:

DataFormat hl7 = new HL7DataFormat();
  ...
  from("direct:hl7in").marshal(hl7).to("jms:queue:hl7out");

In the sample above the HL7 is marshalled from a HAPI Message object to a byte stream and put on a JMS queue.
The next example is the opposite:

DataFormat hl7 = new HL7DataFormat();
  ...
  from("jms:queue:hl7out").unmarshal(hl7).to("patientLookupService");

Here we unmarshal the byte stream into a HAPI Message object that is passed to our patient lookup service.



Notice there is a shorthand syntax in Camel for well known data formats that is commonly used.

Then you don't need to create an instance of the HL7DataFormat object:




from("direct:hl7in").marshal().hl7().to("jms:queue:hl7out");
  from("jms:queue:hl7out").unmarshal().hl7().to("patientLookupService");





The unmarshal operation adds these MSH fields as headers on the Camel message:



Camel 1.x





 Key 
 MSH field 
 Example 




 hl7.msh.sendingApplication 
 MSH-3 
 MYSERVER 




 hl7.msh.sendingFacility 
 MSH-4 
 MYSERVERAPP 




 hl7.msh.receivingApplication 
 MSH-5 
 MYCLIENT 




 hl7.msh.receivingFacility 
 MSH-6 
 MYCLIENTAPP 




 hl7.msh.timestamp 
 MSH-7 
 20071231235900 




 hl7.msh.security 
 MSH-8 
 null 




 hl7.msh.messageType 
 MSH-9-1 
 ADT 




 hl7.msh.triggerEvent 
 MSH-9-2 
 A01 




 hl7.msh.messageControl 
 MSH-10 
 1234 




 hl7.msh.processingId 
 MSH-11 
 P 




 hl7.msh.versionId 
 MSH-12 
 2.4 






Camel 2.0





 Key 
 MSH field 
 Example 




 CamelHL7SendingApplication 
 MSH-3 
 MYSERVER 




 CamelHL7SendingFacility 
 MSH-4 
 MYSERVERAPP 




 CamelHL7ReceivingApplication 
 MSH-5 
 MYCLIENT 




 CamelHL7ReceivingFacility 
 MSH-6 
 MYCLIENTAPP 




 CamelHL7Timestamp 
 MSH-7 
 20071231235900 




 CamelHL7Security 
 MSH-8 
 null 




 CamelHL7MessageType 
 MSH-9-1 
 ADT 




 CamelHL7TriggerEvent 
 MSH-9-2 
 A01 




 CamelHL7MessageControl 
 MSH-10 
 1234 




 CamelHL7ProcessingId 
 MSH-11 
 P 




 CamelHL7VersionId 
 MSH-12 
 2.4 






All headers are String types. If a header value is missing its value is null.



Dependencies



To use HL7 in your camel routes you need to add the a dependency on camel-hl7 which implements this data format. 



If you use maven you could just add the following to your pom.xml, substituting the version number for the latest & greatest release (see the download page for the latest versions).





<dependency>
  <groupId>org.apache.camel</groupId>
  <artifactId>camel-hl7</artifactId>
  <version>1.6.0</version>
</dependency>

Powered by Atlassian Confluence (Version: 2.2.9 Build:#527 Sep 07, 2006) - Bug/feature request

Unsubscribe or edit your notifications preferences

Reply via email to