Configuring an Inbound and Outbound Process in iWay Service Manager

In this section:

How to:

The following section describes how to use the components described previously, in order to build a simple process, which receives an incoming HL7 message over MLLP, converts it to XML format, and saves it in a File. The outbound scenario accepts a file containing the HL7 message in XML format, converts it to HL7 format, and sends it over MLLP. The following two channels must be created in iWay Service Manager in order to run this process:


Top of page

x
Inbound Channel Components

The following table describes the inbound channel components.

Component

Sub-component

Description

Inlet

HL7 listener

Listens for incoming messages on the provided IP address and port number. Converts the message into XML format and sends back ACK or NACK, based on the message validation status.

Route

Move agent

Pre-existing service to move the input document to the outlet.

Outlet

File emitter

Writes the XML-based HL7 message into a file under preconfigured folder.

The following image shows the channels pane.



x
Outbound Channel Components

The following table describes the outbound channel components.

Component

Sub-component

Description

Inlet

File listener

Reads an XML-based message from a file that is placed in the preconfigured folder.

Route

HL7 adapter target

The HL7 Adapter target is added to a new Process. This process is added to the Route. HL7 Adapter target converts the XML based message into HL7 format and sends it out on the preconfigured IP and port number.

Outlet

Default.outlet

Writes the Acknowledgment message received against the sent HL7.

The following image shows the channels pane.



x
Procedure: How to Execute an Inbound and Outbound Process

To execute an inbound and outbound process in iWay Service Manager:

  1. In the left console pane of the Registry menu, select Channels.
  2. Mark the appropriate channels and click Build.
  3. From the iWay Service Manager Console, click Deployments and select the Deploy button.

    A list of available deployment channels is displayed.

  4. Select the inbound and outbound channels previously created, and ensure that both channels are running and active.

  5. Send a sample HL7 Version 2.5 message over MLLP to the port number 10025.

    Note the Acknowledgment message received. The HL7 message will then be available in XML format under the preconfigured target folder.

  6. Validate the XML file by checking if all elements are populated.

    The inbound channel has now been executed.

  7. Copy the XML file generated during the above process into the configured incoming file folder.

    Ensure that an outbound HL7 message is received on port 22025. Note the Acknowledgment message saved in the destination folder configured in the file listener Outbound channel has now been executed.


Top of page

x
Validating Results

The following steps confirms the legitimate validation and processing of HL7 messages by the Inbound and Outbound channels:


iWay Software