HL7 Output Module

<img src=“https://secure.travis-ci.org/sdoxsee/hl7output.png?branch=master” alt=“Build Status” />

Description

The HL7 Output Module is intended to allow data from OpenMRS to be exported from OpenMRS as HL7v2.5 messages. HL7 messages are a common way to facilitate the interoperability of healthcare systems. This module uses the popular HL7 API (HAPI) to generate HL7 messages by mapping the OpenMRS data model to specific standard or custom HAPI objects. Please visit the wiki for more information.

Requirements

OpenMRS >= 1.8.4-SNAPSHOT for pom.xml change that updated HAPI version to 1.2

Building from Source

You will need to have Java 1.6+ and Maven 2.x+ installed. Use the command

mvn clean package -DskipTests

to compile and package the module. The .omod file will be in the omod/target folder.

Installation

Note: the hl7output module depends on the webservices.rest module and requires that it be running before installing/starting hl7output

1. Build the module to produce the .omod file.

2. Use the OpenMRS Administration > Manage Modules screen to upload and install the .omod file.

Usage

To get back a sample ZPT_ZP1 message with XML encoding, hit the following REST endpoint

http://localhost:8080/openmrs/ws/rest/hl7output/sample/XML

Project Status

Unfortunately I have not had time to actively work on this project recently. If you find a critical issue where it does not work as documented please ping me on Twitter and I’ll take a look.

Special Thanks

This module was originally based on the solution by Suranga Kasthurirathne in his RHEASHRadapter project.