How to Send a Lab Request from OpenMRS and Result in OpenELIS

How to Send a Lab Request from OpenMRS and Result in OpenELIS

 

PART 1: INTRODUCTION

Components Overview

Interoperability Layer

The Interoperability Layer (IOL) is the core component of the OpenHIE architecture responsible for securely routing messages between the various other components of the HIE, and providing the entrypoint interface for external point-of-service clients. IOL OpenHIE Documentation 

Shared Health Record

The Shared Health Record (SHR) service stores the longitudal health record for each patient from across the health system. This component supports workflows that require access to a shared central repository of patient data, such and laboratory order and result workflows. SHR OpenHIE Documentation (hapifhr)

Point of Care Systems

  1. OpenMRS 

  2. OpenELIS

PART 2: INTRODUCTION TO OPENMRS

How to login to OpenMRS

To login to OpeMRS,  You will require a username and password obtained from the administrator of your OpenELIS instance. 

  1. Type in your username  and click on the Continue button. In this 

Enter username and continue
  1. Upon clicking on the Continue button, enter Password. In this illustration the password entered is Admin123. 

Enter password
  1. Select your location from the list below. Use the search bar to find your location.

Select location
  1. Click on the Confirm button

Click confirm
  1. Upon successful login, you will be navigated to the Home page. To create a new patient, click on the patient icon at the top right.

Create a patient button
  1. Upon clicking on the new patient icon, the patient registration form is displayed. Fill in the Basic Information section which entails:

  • First name

  • Middle name

  • Last name

  • Sex

  • Date of birth

Enter basic information
  1. Upon filling the Basic information page click on the Register Patient button. The Cancel button will close the button.

Register patient

Note

  • The No toggle button is used when the patient name is unknown.

No toggle button
  • The Edit or the pencil icon are used to edit a passport photo size of the patient

Edit passport photo
  • The No toggle button under Date of Birth Known will allow you to estimate the patient’s age in years or months

Unknown date of birth
  • The Configure -> is used to change the patient identifier. In this illustration, the configured identifier is OpenMRS ID which is auto generated when a patient is created.

Identifier congiguration
  • Clicking on the Configure identifier will open a side page that allows the user to select from the check boxes the patient identifier and configure it. The Cancel button closes the side page.

Select identifier to configure
  • The Contact Details section allows you to capture the patient's address which includes;

    • Address

    • Country

    • Telephone number

Contact details
  • The Relationship section allows you to capture a patient’s relationship by clicking on the Add Relationship button.

Add relationship
  • Search for a name and select the Relationship to the patient from the Relationship drop-down menu.

Search firstaname or familyname

 

  1. Upon registration of the patient, the patient summary page is displayed. To add a laboratory order, click on the order basket icon at the top right.

Click order busket
  1. Click on the Start Visit button. The Cancel button will close the dialogue. 

Start visit

Note.

  • The new appointment is selected by default.

New visit option
  • The Ongoing tab should be used only for an active visit.

On-going visit option
  • The Visit start date should be entered from the date and time picker

Visit start date
  • The In the past tab should only be used to enter a retrospective visit.

Retrospective visit
  • The Visit start and end date are picked from the date and time

Retrospective visit dates

 

  1. Select the visit location from the drop-down menu. In this illustration, the Ubuntu location is selected as an example. The X icon is used to remove the current location.

Encounter location
  1. Search for a Visit Type under Search for visit type text box. Alternatively, select the visit type from the radio-buttons listed. In this illustration, Facility Visit is selected.

Type of visit

Note:

  • The punctuality drop-down menu item allows a clinician to select options; On time, Late and Early for the patient’s visit

Punctuality
  • The Insurance Policy Number allows for capturing of an insurance policy number for the patient if the patient has an insurance

Insurance policy
  1. Click on the Start visit button

Start visit

 

  1. Note: This patient is newly created.  As a user, you had to start a visit for a laboratory order to be raised. Click on the order basket to create the order.

Order busket
  1. Click on Add + under  the Lab order.

Add order
  1. Search for a test type in the Search for a test type text field.

Search lab order
  1. In this illustration, White blood cells is searched. Click on the Add to basket button.

Add order to basket
  1. The test will be added to the basket and tagged as incomplete. Click on the test.  The trash icon is used to delete the test.

Click on the test/order
  1. Enter the lab reference number. In this illustration, 2345098 is entered.

Enter lab reference number
  1. Select the priority for the test from the Priority drop-down menu.

Enter priority
  1. Enter any additional instructions to the laboratory staff.

Enter additional instructions
  1. Click on the Save order button.

Save order
  1. Click on the Sign and Close button. The laboratory test is saved successfully.

Sign and close
  1. Click on the Order menu item on the left side menu navigation. The order is listed under the Orders table for the patient with the status In Progress.

Click on order
  1. Upon successful processing of the laboratory order, click on the Order menu item on the left side menu navigation. The order is listed under the Orders table for the patient with the status Completed.

  2. Click on the lab order to view the results.

PART 3: INTRODUCTION TO OpenELIS

The OpenELIS Global system is made up of a variety of concise screens and workflows to help with the collection, management, and reporting of laboratory data.  The use of this system is intended to provide a structured approach to managing the data within the clinical laboratory setting to ensure high-quality testing processes and results data that is then made accessible to external systems and people in the clinical, population, and programmatic health workflows.

How to login to OpenELIS and Process an Electronic Order

To login to OpeELIS,  You will require a username and password obtained from the administrator of your OpenELIS instance. 

 

  1.  Type in your username and password and click on the Submit button.

 

Notice: Access to this service is for authorized personnel only. If you do not have the expressed authorization of the administrator, you must exit now. This organization prohibits unauthorized access, disclosure, duplication, modification, diversion, destruction, loss, misuse, or theft of its information.

OpenELIS Global 3.0 Login page

Once you connect to OpenELIS Global, the home page will display the laboratory management statistics for your understanding of the current state of the lab testing processes. 

OpenELIS Statistics

 

  1. Click on Electric Orders under the home page to view laboratory orders sent via the LinkEMR

Electronic orders

Note:

The Electronic Orders are displayed

Electronic orders

 

  1. To access the incoming laboratory orders, click on the hamburger menu item at the top left

Menu access
  1. Click on the Order drop-down menu.

Accessing orders
  1. Click on the Incoming Order

Incoming orders
  1. Search by family name, national ID number, lab number from referring lab, or passport number. In this illustration, the family name Doe is typed. Click on the Search button

Search incoming test request

Note;

Search by Date, and Status Enter the date range for test requests. This will search by the date of the referral, or the order date of the electronic request

Search parameters
  1. Click on the test Request(s) Matching Search - In the drop-down menu.

Click to select
  1. Add a lab number and select to accept the order as is. In this illustration, we generate a lab number by clicking on generate

Generate order

Note:

 Use the pencil icon  to make changes

Edit order

 

  1.  Upon generation of a lab order number, click on the add button to add the order.

Add order
  1. Click on the Next button under the Test Request page.

Click next
  1. Select a program under which to put the test request by selecting from the drop-down menu then click on the Next button.

Click next
  1. Select the Sample from the drop-down menu. In this illustration, whole blood is selected.

Select sample

 

  1. Select the order from the checkboxes.

Select order
  1. Click on the Next button

Click next
  1. At this juncture the lab order is processed and once ready for results entry, click on the hamburger menu item.

Access menu
  1. Click on the drop-down menu under Result

Click drop-down

Note:

Results can be entered by;

  • Unit

  • Patient

  • Order

  • Referred Out

  • Range of Order Numbers

  • Test, Date or Status

Results entry options
  1. In this illustration,  By Patient is clicked.

Results entry by patient
  1. The patient can be searched by;

  • PatientID

  • Previous Lab Number

  • Last name

  • First Name

       In this illustration the Last Name Doe is entered and the Search button is clicked

Search by name
  1. Select the patient matching your search results by clicking on the radio-button. Select the patient matching your search results by clicking on the radio-button

Select patient
  1. Enter the results in the Results text box and click on the Save button

Results entry
  1. Upon entry of results, the assigned lab staff can validate the results under the validation section. Click on the hamburger menu item.

Accessing validation
  1. Click on Validation drop-down menu

Click validation
  1. Results can be validated by;

  • Routine

  • Study

  • Order

  • Range of Order Numbers

  • Date

        The Order is clicked

Results entry by order
  1. Enter the lob order number and click on the Search button. In this illustration, DEV01250000000000024 is entered.

  1. Click on the Save button

Click save