Introduction
This sample illustrates how the HL7 inbound endpoint can be used to 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:
<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 TestPanel.
Executing the sample
The sample client used here is the HAPI HL7 TestPanel.
To execute the sample
Connect to the port defined in the inbound endpoint (i.e., 20000, which is the value of
inbound.hl7.Port)
using the HAPI HL7 TestPanel.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 serialisation of this message in a SOAP envelope. You will also see that the HAPI HL7 TestPanel receives an acknowledgement.