User Guide > Integrating Health Care Data > Health Care Components and Schemas > XML to HL7 Transformer
Was this helpful?
XML to HL7 Transformer
The XML to HL7 transformer generates an HL7 v2.x message using the data provided. You must provide a v2.xml source message. If you are using custom XML, provide an XSLT that formats your XML into v2.xml.
The information in this section applies to version 2.0.0 of the XML to HL7 Transformer component. Version 2.0.0 of the component includes support for v2.6 HL7 messages.
The transformer then performs the following actions:
1. Optionally reads a custom XML message using an XSLT that transforms the message to v2.xml format.
2. Reads the v2.xml source message.
3. Converts the message to an HL7 v2.x message.
4. Displays the HL7 v2.x target message.
Note:  It is important that you familiarize yourself with the v2.xml specification. Go to 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.1.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
Provide a DJMessage for the Message parameter. The DJMessage body will be used as the source for the Transformer component. A new DJMessage can be created by clicking in the Message parameter field, and then selecting Add new DJMessage from the drop-down menu. The body of the DJMessage can be loaded by clicking the More Options button.
Execute
TargetMessage
Provide a DJMessage for the Message parameter. The DJMessage body will be used as the target, or output, for the Transformer component. A new DJMessage can be created by clicking in the Message parameter field, and then selecting Add new DJMessage from the drop-down menu. The body of the DJMessage can be loaded by clicking the More Options button.
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
Error Code
Error Name
Description
Reason
0
ERR_OK
OK status.
No error. OK 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.
This error code does not mean that your HL7 XML message is invalid. However, your XML source message may be malformed. Verify that your XML syntax is correct.
See the process log for specific message.
46
LICENSING
Component is not licensed for the product version.
Component is not licensed.
Last modified date: 12/03/2024