The HL72XML component is used to parse HL7 (Health Level Seven) v2.x document and convert it to XML format.
An equivalent XML format (XML Schema) is defined for each HL7 v2.x message format. The component, upon receiving an HL7 v2.x message, will convert it into an appropriate XML message that conforms to any of the XML Schemas defined.
Configuration
Component Configuration
Figure 1: Component configuration
Attributes
Error handling configuration
Please refer Error Handling section in Common Configurations page.
Figure 2: Error Handling Configuration
Output 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-up on clicking the ellipsis button.
Figure 3: Output Schema editor to provide XML schema that support Input Messages of same format
The component will convert any valid HL7 v2.x message to respective XML message conforming to XML schemas defined for HL7 messages, irrespective of the schema provided here. Defining an 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.
XML Schema files for hl7 messages are located at location FIORANO_HOME/xml-catalog/fiorano/hl7.
Enable input validation
Enable this property to validate the Input to conform with the HL7 message rules.
Validation Type
Figure 4: Validation Type appears after enabling Input Validation
- DEFAULT: Messages will be validated with standard HL7 message rules.
- CONFORMANCE PROFILE: Message will be validated with the conformance profile file configured for its type. Default validation is performed if conformance profile is not configured for a specific type. When this option is chosen, Conformance Profile Configuration property appears where the configuration can be set.
Conformance Profile Configuration
Click the ellipsis button to provide the Conformance Profile configuration.
Figure 5: Conformance Profile Configuration property appears after choosing the respective Validation Type
Click the Conformance Profile configuration ellipsis button and click Add in the dialog box to add the following attributes pertaining to Conformance Profile:
- Message Type
- Trigger Event
- File Path
Figure 6: Dialog box to set Conformance Profile Configuration
Input contains multiple messages
Select this check box if input contains multiple HL7 messages delimited by a character.
Message Delimiter
Provide delimited character in hex format.
Figure 7: Message Delimiter property to specify delimiter character
Elements to Encrypt
Select the elements to encrypt in output. Elements in the Input Message will be decrypted and those in Output Message will be encrypted.
Functional Demonstration
Scenario 1
This scenario explains the basic functionality of HL72XML component.
Create flow by connecting HL72XML to feeder and display components. Send sample input (valid HL7 message) to check the response (transformed XML message).
The HL7 input is sent from the feeder and the corresponding XML output can be seen in display.
Figure 8: Sample Event Process
Sample Input
Figure 9: Sample Input used in the feeder
Output
Figure 10: Output generated in the Display window in XML format