User Guide > Designing and Executing Processes > Health Care Components and Schemas > 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
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
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: 12/03/2024