OpenMRS Laboratory Workflows Module

Overview

This module provides support for FHIR-based communication between OpenMRS and a FHIR-enabled Laboratory Information System (LIS) like OpenELIS.

The laboratory workflows supported by this module are based on OpenHIE specifications and the FHIR Workflow Module resources and communication patterns.

The technical and functional specification for the workflows supported by this module can be found in the following FHIR Implementation Guide: https://i-tech-uw.github.io/laboratory-workflows-ig

Building and Deploying

1. Build and create .omod file:

mvn clean package

2. Use omod file as part of an OpenMRS distribution.

Usage

Ensure to Configure these Global Properties(Settings) Required by the OWA to function

The Lab on FHir Module only generates the Lab WorkFlow Fhir Bundle When an order is created in OpenMRS and Pushes the Lab Fhir Bundle to an external LIS system ,and Polls for Completed Orders from the LIS

see more about the EMR-LIS FHIR Workflow

Configure the Following Global Properties Required By the Lab on Fhir Module

• labonfhir.lisUrl ,The URL for the OpenELIS system to communicate with
• labonfhir.lisUserUuid ,UUID for the service user that represents OpenELIS
• labonfhir.truststorePath , Path to truststore for HttpClient
• labonfhir.truststorepassword , Truststore password , You can also set this through the OMRS_EXTRA_LABONFHIR_TRUSTSTOREPASSWORD env variable
• labonfhir.keystorePath , Path to keystore for HttpClient
• labonfhir.keystorepassword , Keystore password .You can also set this through the OMRS_EXTRA_LABONFHIR_KEYSTOREPASSWORD env Variable
• labonfhir.activateFhirPush ,Switches on/off the FHIR Push Functionality with in the module to an external LIS
• labonfhir.authType , The HTTP Auth type to support .Either SSL or Basic
• labonfhir.username ,User name for HTTP Basic Auth with the LIS ,You can also set this through the OMRS_EXTRA_LABONFHIR_USERNAME env variable
• labonfhir.password ,Password for HTTP Basic Auth with the LIS. You can also set this through OMRS_EXTRA_LABONFHIR_PASSWORD env Variable
• labonfhir.filterOrderBytestUuids ,Allows filtering Oders by Test Uuuids- either true or false
• labonfhir.orderTestUuids ,Concept UUIDs to filter by for Test Orders that get sent to the LIS
• labonfhir.labUpdateTriggerObject ,The OpenMRS object type that should trigger LIS synchronization - either Encounter or Order
• labonfhir.addObsAsTaskInput ,Allows Adding Obs as Task Input- either true or false
• labonfhir.filterDemoData , Allows filtering Demo Data generated by the Demo Data module - either true or false

See the EMR-LIS Exhange demo video using the Lab on FHIR module