The XML2HL7 component is used to parse XML document and convert it to HL7 (Health Level Seven) v2.x format. HL7 v2.x is a messaging standard used to define how information is packaged and communicated between different systems in hospital workflows.

An equivalent XML format (XML Schema) is defined for each HL7 v2.x message format. The component, upon receiving a XML message that confirms to any of the XML Schemas defined, will convert it into an appropriate HL7 v2.x message.


Component Configuration

Figure 1: Component Configuration panel


Custom HL7 Message Packages

The  Table contains a Map for version of HL7Message mapped to the list of provided Custom packages separted by delimeter ; 

this option is seen only if Show Expert Properties is enabled.

Error Handling Configuration

Please refer Error Handling section in Common Configurations page.

Input schema

If the component receives message of same format at all times, then XML schema of that message format can be provided here using schema editor which opens upon clicking the ellipsis  button  . The component will convert any valid XML message conforming to XML schemas defined for HL7 messages to respective HL7 v2.x message irrespective of the schema provided here. Defining a XML schema here will only set the schema on the input port of the component so that any required transformations can be defined using the schema.

  • Do not define the Schema here if the component can receive messages in different HL7 format. Instead the schemas should be loaded manually loaded into output structure of Mapper tool when defining transformations.
  • XML Schema files for hl7 messages are located at location FIORANO_HOME/xml-catalog/fiorano/hl7.

For the information regarding the below attributes, please refer to HL72XML page:

  • Enable input validation
  • Input contains multiple messages
  • Elements to Encrypt
Append MLLP characters to Response

Appends configured MLLP characters to the transformed HL7 message before sending it to output port, for example, ([StartBlock]Message[EndBlock][LastCharacter]).

Functional Demonstration


This scenario explains the basic functionality of XML2HL7 component.

Create flow by connecting XML2HL7 to feeder and display components. Send sample input (valid XML message) to check the response(transformed HL7 format). Message in XML format is sent from the feeder and the corresponding message in HL7 v2.x format can be seen in display.

Figure 3: Sample Event Process

Sample Input

 Expand source

Figure 4: Sample Input (Expand to see) provided in Feeder


Figure 5: Output in Display window

Useful Tips

Please refer to for more information about HL7 messages.

Adaptavist ThemeBuilder EngineAtlassian Confluence