Skip to main content

HL7 Server

The HL7 Server component is used to listen and receive HL7 messages on a specified port via the LLP Protocol. The HL7 Server responds to each received HL7 message by sending an acknowledgment ( ACK message) to the source system.

You can use this component both in production integrations to listen for HL7 messages or as a Test Listener utility representing a destination system.

How to Set it Up:

Import the HL7 Server component

On the Dashboard, click +COMPONENT and search for HL7 Server.

Configure the desired port to receive HL7 messages via LLP

You can configure the desired port in the component card custom field. The default port to receive HL7 messages is set to 65432.

Connect a downstream component - the HL7 Server is a feeder component

The HL7 Server is a feeder component which is designed to queue messages to a downstream component for processing or sending to a destination system.

If you want to process your HL7 message, add the HL7 Map component and the HL7 Client to send messages outbound to a destination.

See Linking components.

Use test source and destination systems within Iguana to simulate the HL7 integration

For testing your workflow you can use:

  1. The Simulator to send messages to localhost and the port configured for the HL7 Server. The HL7 Simulator does not need to be directly linked to the HL7 Server as messages won't be queued between the components, they use the LLP protocol.

  2. Add a second HL7 Server but name it “Test Listener” to act as your destination system receiving and responding to your HL7 feed.

  3. Make sure you change the port to receive messages from your HL7 Client via LLP.

  4. Since this is acting as a test destination, in HL7 Server's main.lua, comment or remove line 38, which queues the received messages. This ensures you keep your queue decluttered!

You can use the HL7 Server as is or you may want to modify the way the HL7 Server component handles the LLP protocol, for example: