Summary

IRIS-HL7v2Gen is a web application designed to generate HL7 test messages, validate them against HL7 specifications, display the message structure hierarchy, and transmit the messages to production via TCP/IP

Application Layout

Features

• Generate HL7 Test Messages
• Validate HL7 Messages
• Construct HL7 Message Type Structures
• Send Messages via TCP/IP
• Generate a Test Message by Invoking a Class Method
• Currently Supports HL7 Version 2.5
• Generate Test Messages for 205 Message Types

Prerequisites

Make sure you have git and Docker desktop installed.

Installation

Docker (e.g. for dev purposes)

Clone/git pull the repo into any local directory

$ git clone https://github.com/mwaseem75/iris-HL7v2Gen.git

Open the terminal in this directory and run:

$ docker-compose up -d

IPM

Open IRIS for Health installation with IPM client installed. Call in any namespace:

USER>zpm "install iris-HL7v2Gen"

Run the Application

Navigate to http://localhost:32783/csp/HL7v2Gen/index.csp to run the application

Generate HL7 Message

Select a message type from the dropdown list and click the “Generate Test Message” button

The application will generate a test message

Validate HL7 Message

Click the “Validate Message” button

Explore the Structure of the Message

The application will construct the message structure based on HL7 specifications

Send Message to Production

Click on “View Production” to open the production page. Make sure the production is started

Click on “Send message to production” button from the application

Select business service “HL7TcpService” and Open message viewer

Generate a Test Message by Invoking a Class Method

Connect to the IRIS Terminal, execute the GenMessage function of the dc.HL7v2Gen class, and pass the desired HL7 message type

set mes = ##class(dc.HL7v2Gen).GenMessage("ADT_A01")
write mes

Thanks