Sample 905: Inbound HL7 with Automatic Acknowledgement

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:

Inbound HL7 Automatic Acknowledgement

<?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">
    <!-- Generate a NACK containing an error -->
    <property name="HL7_RESULT_MODE" value="NACK"/>
    <property name="HL7_NACK_MESSAGE" expression="get-property('ERROR_MESSAGE')"/>
    <respond/>
</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.