Order Entry UI Administrator Guide

Owned by Flavia Nshemerirwe
Last updated: Feb 25, 2022 by Moses Mutesasira
2 min read

Overview

Order Entry UI is an open web application that provides an interface for drug and lab order entry. This application is designed to be used by clinicians, nurses, doctors, and pharmacists when prescribing or dispensing drugs for patients and also when carrying out tests for patients. Reports indicate that many deaths have occurred due to errors made in the process of prescribing and dispensing drugs. An electronic order entry system minimises the occurrence of such errors by intercepting and providing warnings when such errors are made. The application can be used to create new drug orders, new laboratory orders and edit, discontinue existing drug orders and discontinue existing laboratory orders. 

Settings and Configuration

Ensure the  the orderentryui module is loaded into the OpenMRS instance , because it provides the Order Entry Widget on the Patient DashBoard used to acces the webb app

More Information on how to set up can be found here. 

For the Order Entry UI application to work, you are required to make the following one time configurations.


Add Encounter Type

  1. Creating a new order requires an encounter type. To create a new encounter type for drug order entry for example order entry, go to System Administration → Advanced Administration → Manage Encounter Types → Add Encounter Type. Add an encounter type called order entry. 
  2. Save the name of this encounter type under a setting called orderentryowa.encounterType. Go to System Administration → Manage Global Properties → Add  New Global Property and create a global property with the name orderentryowa.encounterType and value order entry. See video below:

Add Encounter Role

  1. Creating a new drug order also requires an encounter role. To create a new encounter role for drug order entry for example clinician, go to System Administration → Advanced Administration → Manage Encounter Roles → Add Encounter Role. Add an encounter role called clinician.
  2. Save the name of this encounter role under a setting called orderentryowa.encounterRole. Go to System Administration → Manage Global Properties → Add  New Global Property and create a global property with the name orderentryowa.encounterRole and value clinician.

         


Add Date and Time Format (Optional)

  1. Configure the time and date format to be used by the application. Go to System Administration → Manage Global Properties → Add  New Global Property and create a global property called orderentryowa.dateAndTimeFormat with DD-MM-YYYY HH:mm or any other valid date/time format as the value.

    NB: This step is optional. If the orderentryowa.dateAndTimeFormat is not configured, the application would use a default DD-MM-YYYY HH:mm representation.

Configuring Laboratory Orderables

  1.  Create and set the value of global property  orderentryowa.labOrderablesConceptSet  to da006137-88ca-4d11-ae58-8b4b439afdd6, go to System Administration → Manage Global Properties  Click on add new global property fill the form with the following details, The name of the property should be orderentryowa.labOrderablesConceptSet and the value should be da006137-88ca-4d11-ae58-8b4b439afdd6.
  2. Download the lab orderables metadata which can be found here
  3. Go to System Administration → Advanced Administration → MetaData Sharing → Import MetaData. Import the lab orderables metadata and wait for it to be installed.

Resources