Sample 905: Inbound HL7 with Automatic Acknowledgement

1 Introduction
2 Prerequisites
3 Building the sample
- 3.1 Inbound HL7 Automatic Acknowledgement
4 Executing the sample
5 Analyzing the output

Introduction

This sample illustrates how the HL7 Inbound Protocol 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:

Inbound HL7 Automatic Acknowledgement

<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.