Introduction
This sample illustrates how the inbound HL7 transport can be used receive a simple HL7 message.
Prerequisites
For a list of prerequisites, see Prerequisites to Start the ESB Samples.
Building the sample
The XML configuration for this sample is as follows:
<?xml version="1.0" encoding="UTF-8"?> <definitions xmlns="http://ws.apache.org/ns/synapse"> <inboundEndpoint xmlns="http://ws.apache.org/ns/synapse" name="Sample1" sequence="main" onError="fault" protocol="hl7" suspend="false"> <parameters> <parameter name="inbound.hl7.AutoAck">true</parameter> <parameter name="inbound.hl7.Port">20000</parameter> <parameter name="inbound.hl7.TimeOut">3000</parameter> <parameter name="inbound.hl7.CharSet">UTF-8</parameter> <parameter name="inbound.hl7.ValidateMessage">false</parameter> <parameter name="transport.hl7.BuildInvalidMessages">false</parameter> </parameters> </inboundEndpoint> <sequence name="main"> <in> <log level="full"/> <drop/> </in> <out> <send/> </out> <description>The main sequence for the message mediation</description> </sequence> <sequence name="fault"> <drop/> </sequence> </definitions>
This configuration file synapse_sample_905.xml
is available in the <ESB_HOME>/repository/samples
directory.
To build the sample
Start the ESB with the sample 905 configuration. For instructions on starting a sample ESB configuration, see Starting the ESB with a sample configuration.
The operation log keeps running until the server starts, which usually takes several seconds. Wait until the server has fully booted up and displays a message similar to "WSO2 Carbon started in n seconds."Download and install the HAPI HL7 Test Panel.
Executing the sample
The sample client used here is the HAPI HL7 Test Panel. To execute the sample:
Connect to the defined port in the inbound endpoint (20000) using the HAPI HL7 Test Panel.
Generate and Send an HL7 message using the Messages dialog frame.
Analyzing the output
You will see that the ESB receives the HL7 message and logs a serialization of this message in a SOAP Envelope. The HAPI HL7 Test Panel will receive an acknowledgement response.