Objective

To configure HL7Sender and HL7Receiver to send and receive ORU R01 messages. HL7Sender and HL7Receiver are used to send and receive HL7 data over MLLP (Min Low Level Protocol is a socket communication protocol used for transferring HL7 data).

Prerequisites

• Start Fiorano Enterprise Server (FES) and Fiorano Peer Server (FPS)
• Login to eStudio application
• Understand the basic menus and perspectives (panels) in eStudio application

Scenario

1. Configure HL7Sender to send ORU R01 messages onto a port specified on a particular IP address.
2. HL7Receiver listens on the port and IP address specified to receive HL7 messages, sends the messages received on to the output port, and also sends an acknowledgement to HL7Sender.

Components used

• One HL7Sender component
• One HL7Receiver component
• One Feeder component
• Two Display components

Setting up the Example

Setting up the example involves configuring an HL7Sender, HL7Receiver and logically connecting both to run the example.

Configuring HL7Sender component

HL7Sender component can have multiple sender configurations. For every sender configuration added, a set of input and output ports will be generated with the sender configuration name as port prefix.

To configure HL7Sender component, perform the following actions in eStudio:

1. Add a new Event Process with name 'HL7Sender_Receiver_Eg'.
2. Drag the HL7Sender component from Bridges category in the Service Palette to the Fiorano Orchestrator.
   
   
   Figure 1: Adding HL7Sender component to Fiorano Orchestrator
   
   
3. Double-click the component in the Orchestrator to open Configuration Property Sheet (CPS).
4. Click Add button to add a Sender configuration by providing the following values:
   1. Select a Sender to Modify: ORU_R01_Sender (Sender Configuration Name)
   2. IP Address: localhost (retain default value)
   3. Port Number: 1011 (retain default value)
   4. Request Timeout (in ms): 60000 (retain default value)
   5. Receive Type: Both (to accept both XML as well as HL7 acknowledge formats)
   6. Send Type: Piped
      
      
      Figure 2: HL7Sender Configuration in CPS
      
      
5. Click Finish and notice that the component will have input and output ports generated after the above configurations.

Configuring HL7Receiver component

In HL7Receiver, multiple receive configurations can be configured to listen to various types of HL7 messages identified by Message Type and Trigger Event combination. For every receive configuration, an output port is generated with configuration name as port name prefix. An asterisk can be used as wildcard character for both message formats and trigger event which listens to all message types.

To configure HL7Receiver component, perform the following actions:

1. Drag the HL7Receiver component from Bridges category in the Service Palette to the Fiorano Orchestrator.
   
   
   Figure 3: Adding HL7Receiver component to Fiorano Orchestrator
   
   
2. Double-click the component in the Orchestrator to open Configuration Property Sheet (CPS).
3. Click button to add Receiver configuration by providing the following values:
   1. Select a Receiver to modify: ORU_R01_Receiver
   2. Port Number: 1011 (retain default value. This is same as the port number specified in HL7Sender)
4. Click Add button to add an event, and provide event details and message type:
   1. Events
      1. Message Type: ORU

      2. Trigger Event: R01

         Icon

          The Message Type value and Trigger Event value together forms an event and Hl7Receiver listens for messages matching this event. In the present example, HL7Receiver listens for ORU|R01 messages.

         Icon

         An asterisk * can be used as wild character for both message format and trigger event, where it receives all messages without filtering them.

   2. Message Type: Both (to send the received message as-it-is without any conversion)

      Icon

      If you select 'XML', when the received message is of type 'Piped', the message is encoded as XML before sending it to output port.

       

      
      Figure 4: HL7Receiver Configuration in CPS
      
      

      Icon

      An Acknowledgement Generator Class (last tab in Figure 4) can be used to delegate the responsibility of generating an ack message for HL7 message received.

      If value is not provided a default ack generator is used which will generate AA if HL7 message is successfully converted to JMS Message and sent on output port and AE otherwise. Acknowledge Generator should implement com.fiorano.services.hl7receiver.engine.IAckGenerator and should have a default constructor.

      Expand for the sample Generator Class  Expand source
5. Click Finish and notice that the component will have the output port generated after the above configurations.

Composing the Event Process

Add more components and connect the components by performing the below actions:

1. Add one Feeder component and two Display components from Util category to the Fiorano Orchestrator.
2. Change the names of the Display components to distinguish between the ones connected to the components: HL7Sender and HL7Receiver.Click the Display1 component and do any of the following to rename the component from 'Display1' to 'Display_Sender':
   1. Press F2, change the name and click OK.
      
      
      Figure 5: Renaming using Keyboard action 'F2'
      
      
   2. Go to Name property under General tab in Properties, change the name and press ENTER.
      
      
      Figure 6: Renaming using General Properties
      
      
3. Similarly, rename the component 'Display2' to 'Display_Receiver'.
4. Connect the components in the following manner:
   1. Feeder1 component output port to HL7Sender component input port.
   2. HL7Sender component output port to Display_Sender component input port.
   3. HL7Receiver component output port to Display_Receiver component input port.
      
      
      Figure 7: Connecting Feeder and Display components to HL7 components

Running the Example

In the HL7Sender_Receiver_Eg Event Process Orchestrator, perform the following actions:

1. Click Check Resource and Connectivity icon (or press ALT+SHIFT+C) to check resource and connectivity.
2. Click Run Event Process icon (ALT+SHIFT+R) to run the event process. Feeder1, Display_Sender and Display_Receiver windows get opened.

3. In the Feeder1 window, replace 'Input Text' with the below sample input message and click Send.

    

   Expand for Sample Input Message  Expand source

   
   
   Figure 8: Sending Input from Feeder
   
   

4. The message received appears in Display_Receiver window.
   
   
   Figure 9: Display_Receiver window with Received Message
   
   
5. Acknowledgment message appears in Display_Sender window.
   
   
   Figure 10: Display_Sender window with Acknowledgement

Reference

Please note that the component options used in this example are minimum, which helps you to get an overview of the application. To explore the other options present in the HL7Sender, HL7Receiver, Feeder, and Display components, refer: HL7Sender, HL7Receiver, Feeder and Display sections.