User Guide > Integrating Health Care Data > Health Care Components, Connectors, and Schema > HL7 to XML Transformer
Was this helpful?
HL7 to XML Transformer
The HL7 to XML Transformer generates an XML message using the data provided. You must provide an HL7 v2.x source message. If you want the target message customized using XSLT, you must provide the XSLT.
The information in this section applies to version 2.0.0 of the HL7 to XML Transformer component. Version 2.0.0 of the component includes support for v2.6 HL7 messages.
The transformer performs the following actions:
1. Reads the HL7 v2.x source message.
2. Converts the message to a v2.xml document.
3. Displays the v2.xml target document.
4. Optionally transforms the v2.xml document into a custom one using an XSLT document that you provide.
5. Displays the custom v2.xml target document.
Note:  You should familiarize yourself with the v2.xml specification. Go to https://www.HL7.org and search for "XML encoding rules for HL7 v2 messages". To access this specification you must be a member of HL7.org.
Using Linux
For versions 1.2.1 and 2.0.0, check if the MSH segment in your data file ends with a version number and a line feed (LF), as shown in the following example:
IE: MSH|^~\&||^123457^Labs|||200808141530||ORU^R01|123456789|P|2.6
If it does, change the line feed to a carriage return (CR) to prevent the transformer from improperly parsing the file.
Supported Actions
 
Action
Description
Execute
Performs the transformation based on the specified parameters and properties.
Supported Action Parameters
 
Action
Parameter
Description
Execute
SourceMessage
Path and name of the source message.
Execute
TargetMessage
Path and name of the target message.
Supported Action Properties
 
Action
Property
Description
Execute
Optional XSLT Document
To create a custom document, enter the full path to the XSLT document you want to use. The XSLT document must consume v2.xml.
Error Conditions
This transformer returns the following error messages.
Error Code
Error Name
Description
Reason
0
ERR_OK
OK status.
No error. The information is returned successfully.
7
ERR_CREATERR
Error creating a file or table.
Error detected during component initialization.
8
ERR_WRITERR
Error writing to a file or table.
XSLT transformation failed. See the process log for specific message.
34
INVALID
Primary transformation failed.
HL7 source message may be malformed. See the process log for specific message.
46
LICENSING
Component is not licensed for the product version.
Component is not licensed.
Last modified date: 08/02/2023