/openmrs-module-labonfhir

A FHIR-based Lab Workflow for iSantePlus

Primary LanguageJavaOtherNOASSERTION

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
  1. Use omod file as part of an OpenMRS distribution.

Usage

To use this Module , first Load the Order Entry UI module and the Order Entry OWA for creating the Orders With in OpenMRS .

see more instructions for Configuring the OWA and the User Guide

Note: 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.truststorePass , Truststore password
  • labonfhir.keystorePath , Path to keystore for HttpClient
  • labonfhir.keystorePass , Keystore password
  • 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
  • labonfhir.password ,Password for HTTP Basic Auth with the LIS
  • 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