Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 6 Next »

This needs to be generalized for all O2 / O3 deployments, this is a POC based on OpenMRS 2.8 in Cote d’Ivoire

OPENMRS CONNECTION TO HAPI FHIR SERVER

 IMPLEMENTERS GUIDE

Draft

Prepared by I-TECH DIGI and ITECH-CIV July 2024

INTRODUCTION

Welcome to the OpenMRS Connection to HAPI FHIR Server Implementers Guide. This guide is designed to assist you in setting up the project within your environment, providing detailed instructions and resources to ensure a smooth and efficient implementation process. It includes the steps required to set up the project locally, such as creating a project directory, cloning the repository, configuring necessary files, and starting the project using Docker. These foundational steps are crucial for ensuring that your implementation is set up correctly from the beginning.

INTENDED AUDIENCE

This guide is intended for implementers responsible for implementing and managing an OpenMRS Health Information Exchange implementation. It assumes a basic understanding of Docker, Git, and web-based application management. Whether you are setting up a new instance or integrating an existing implementation, this guide provides the necessary steps to ensure a successful implementation.

GETTING STARTED: LOCAL SETUP

HOW TO SET UP THE PROJECT LOCALLY

  1. To get started with setting up the project locally, create a directory for the project on your local machine and change directory to the created project.

  1. Open the visual studio code in the project directory

  1. Navigate to the project GitHub repository and click on SIGDEP-3/SIGDEP-3-Docker-Setup

  1. Copy the project url to clipboard

  1. On visual studio, clone the project in your project folder using the command; git clone https://github.com/SIGDEP-3/SIGDEP-3-Docker-Setup.git

  1. Upon successful cloning of the project, change the directory into the project using the command; cd SIGDEP-3-Docker-Setup/

  1. Click on the docker-docker-local-pilot.yml file

Note: The following services are setup in the docker-docker-local-pilot.yml file.

  • The Sigdep3 service displays the configuration for the OpenMRS

  • The Sigdep3 db represents the database service for the OpenMRS instance

  • The OPENHIM- Interoperability layer (IOL)service is configured for the Mongo database, OpenHIM console and OpenHIM core respectively.

  • The pipeline-controller is configured for FHIR analytics.

  1. At this juncture spin up the project by executing startup the project by running the command; sudo docker compose -f docker-compose-local-1.yml up. The project will be started successfully.

HOW TO STARTUP THE SIGDEP3 EMR LOCALLY 

  1. Upon successfully spinning up the project locally, the next step is to spin up the OpenMRS instance locally. Open a new terminal and startup the SIGDEP3 instance by executing the command sudo docker compose -f docker-compose-local-pilot.yml up sigdep3 sigdep-db. The SIGDEP3 instance will be started.

  1. Click on the README.md file to open. 

  1. Open a new terminal and execute the commands git lfs fetch,git lfs checkout and git lfs pull respectively

  1. Start up your browser and type the url;  localhost:8080/openmrs. The login page is displayed.

Note: You might encounter the system initializing the database setup before the login page is displayed. Please be patient this may take a few minutes to complete. 

  1. Login to the instance. The default username and password are admin | Admin123.

  1. Upon successful login click on Administration.

  1. At this juncture, the search index should be rebuilt. Click on Search Index under Maintenance.

Note: The search index must be rebuilt in order for the instance to execute any search. For instance, searching the concept dictionary or searching for a patient.

  1. Click on the Rebuild Search Index button.

Note: The server-side will execute the search index rebuild

Note: Upon the completion of the search index the search index rebuilding, a notification will be displayed

Note: A search in the dictionary will return the respective result(s). The illustration below shows a CD4 concept search. 

HOW TO STARTUP THE OPENHIM-IOL

The OpenHIM Interoperability layer service is started  during the initial spinning up of the project. 

  1. To access the OpenHIM instance, enter the url http://localhost:9000/ on your browser. The Console heartbeat will be displayed. The login page is displayed

  2. Ideally, you should enter the login credentials to proceed. However, this is a new installation. Notice the self signed certificate error message.

  1. Click on the link text field.

  1. Click on the Advanced button.

  1. Click on proceed to localhost (unsafe)

Note: Upon clicking on proceed to localhost, the OpenHIM console Heartbeat is displayed.

  1. Click on the previous tab on the browser. Log on to the instance by entering the credentials; username: root@openhim.org and password: OpenHIM and clicking on the Login button

  1. Upon successful login click on Transactions. The There are no transactions for the current filters  message is displayed.

  1. Click on Channels. The client registry channels are displayed as well as the central FHIR server channel.

  1. Click on the central FHIR server channel. 

Note: Upon clicking on the channel, the basic info tab is displayed. This tab displays the information about the channel. For instance, the name, description of what the channel does as well as the methods.

  1. Click on the Request Matching tab. The url pattern for matching the channel is displayed as well as the clients.

  1. Click on the Route tab. The central fhir server configuration is displayed.

  1. Click on the pencil configuration to view the configuration. The route name, host, port, route path, route path transform, basic authentication username and basic authentication password are displayed.

Note: These configurations are set on the project under the local-test-openhim-config.json file as illustrated below.

HOW TO STARTUP THE DATA PIPELINE 

  1. To startup the data pipeline, open a new terminal and execute the command: sudo docker -f docker-compose-pilot.yml up pipeline-controller 

  1. Type the url http://localhost:8090/ on your  browser. Upon a successful pipeline startup, the FHIR Pipelines Control Panel is displayed.

Note: The streaming pipeline configurations are displayed under the application.yml file of the local-streaming-pipeline folder of the project. This file displays the FHIR module loaded on the SIGDEP-3 instance, as well as the patient resources under the resourceList which are:

patient,Encounter,Observation,Condition,Practitioner,Location,MedicationRequest

HOW TO SEND A NEW PATIENT RESOURCES TO THE CENTRAL FHIR SERVER

In  this illustration, a new patient is created on the SIGDEP3 OpenMRS instance and the patient resource is routed via openHIM to the FHIR central server.

  1. To get started, Login to the instance. The default username and password are admin | Admin123.

  1. Click on the Find/Create Patient menu item

  1. Create a new person by filling  the person name, birthdate, gender and click on the Create Person button. 

  1. Fill in the middle name, family name, the ID Number and click on the Save button. The patient dashboard is displayed.

  1. Execute an incremental run on the local pipeline controller by clicking on the Run Incremental button

  1. Log on to the OpenHIM local instance using the credentials; 

and click on the Login button

Note: Upon login, the transaction log of the local instance displays the POST transaction to the remote HAPI FHIR Server

  1. Log on to the remote instance by entering the credentials; username: root@openhim.org and password: OpenHIM and clicking on the Login button

Note: Upon login, the transaction log of the local instance displays the POST transaction to the remote HAPI FHIR Server

Note: At this juncture, the pipeline is executed 

  1. Access the FHIR consolidated server by typing the url: https://test1.cihis.org/fhir/ 

  1. Filter the resource type by Patient to view the resources 

  1. Filter the patient resource by lastUpdated to view the newly created patient Jane Doe on the Hapi FHIR server.

HOW TO SEND A LABORATORY ENCOUNTER RESOURCES TO THE CENTRAL FHIR SERVER

In  this illustration, a new laboratory order is created on the SIGDEP3 OpenMRS instance and the observation resource is routed via openHIM to the FHIR central server.

  1. To get started, copy the patient ID number from the patient dashboard.

  1. Click on the Demande d’examen menu item

  1. Enter the Patient identifier and click on the view patient button.

  1. Select the date and click on new order button

  1. Fill in the form to completion.

  1. Click on the save button. The order will be saved successfully.

  1. Log on to the OpenHIM local instance using the credentials; 

and click on the Login button

Note: Upon login, the transaction log of the local instance displays the POST transaction to the remote HAPI FHIR Server

  1. Log on to the remote instance by entering the credentials; username: root@openhim.org and password: OpenHIM and clicking on the Login button

Note: Upon login, the transaction log of the local instance displays the POST transaction to the remote HAPI FHIR Server

Note: At this juncture, the pipeline is executed 

  1. Access the FHIR consolidated server by typing the url: https://test1.cihis.org/fhir/ 

  1. Filter the resource type by observation to view the resources.

  1. Filter the observation resource by lastUpdated to view the newly created observation for patient Jane Doe on the Hapi FHIR server.

GETTING STARTED: REMOTE SETUP 

  • No labels