Page Comparison

Make sure you have docker and docker-compose installed locally.

...

1. Clone the Repository locally 

   Code Block
   language bash
   git clone https://github.com/openmrs/openmrs-plir-dockerized-setup.git

   
   

2.  Move  Move to the project root directory and spin up the pre-configured OpenMRS ,OpenHIM and ,Hapi-Fhir and the streaming-binlog pipeline instances .

   Code Block
   language bash
   docker-compose up./run.sh

   
   

3. You should be able to acces the OpenMRS ,OpenHIM and Hapi-Fhir instances  at the following urls
   
   

   Instance	URL	credentials (user : password)
   OpenMRS	http://localhost:8080/openmrs	admin : Admin123
   OpenHIM	http://localhost:9000	root@openhim.org : openhim-password
   Hapi FHir	http://localhost:8090	hapi : hapi123

   After  After Logging into in OpenHIM  ( see more ), go to the Export/Import tab and import the Configconfig-file inside the Config  config folder ie     config/openhim-config.json json .
   
   

   Note

   that the

   :

   • The OpenMRS Instance

   above

   • is pre-loaded with CIEL and

   comes with

   • a sample form (

   TX

   • HIV_

   PVLS

   • form) to collect TX_PVLS specific data

   Load

   • The above script also loads the necesary

   FHIR Measure Resource For Calculation of TX_PVLS and FHIR CQL Libraries for the Calculation of TX_PVLS into

   • TX_PVLS Measure and Library Resources into the Hapi FHir .

   
   you can load the resources directly from the resources folder directly using the load-resources script. run the command below from the project root directory

   Code Block
   language bash
   chmod +x * ; ./load-resources.sh

   Spin up the streaming-debezium pipeline  . 

   Code Block
   language bash
   docker-compose -f pipeline-compose.yml up

   Note that you run the above command from the root directory of the cloned repository.
   You can use the TX_PVLS form pre-loaded in the OpenMRS instance to capture TX_PVLS specific data

   • see the Resources under the resources folder.

   The running Pipeline will listen to any  any data changes  added in to OpenMRS and route them to the FHIR server through OpenHIM.

   
   
   

4. Invoke the collect-data FHIR Operation using the Get request below to generate the relevant Dataset for TX_PVLS
   
   

   Code Block
   language bash
   GET: http://localhost:8090/fhir/Measure/TX-PVLS/$collect-data?periodStart=<date>&periodEnd=<date>

   
   

5. Invoke the evaluate-measure  FHIR Operation using the Get request below for the  indicator calculation based on CQL evaluation
   
   

   Code Block
   language bash
   GET: http://localhost:8090/fhir/Measure/TX-PVLS/$evaluate-measure?periodStart=<date>&periodEnd=<date>

   
   Note : substitute <date> in the GET request with your actual date parameter .
   
   

6. You can use a plir-widget innitially develeoped by the bahmni-plir team , to easily query and visualise the Measure report generated from the HAPI-FHIR server .
   

   • Install the http-server . see inginix (proxy-server) config under plir-widget/config/nginx.conf .

   • To run the widget , run the command below from the root directory
     
     

     Code Block
     ./run-widget.sh

   • you should be able to access the widget at http://localhost:7000/ .

   Procede to select the measure TX-PVLS , select the start date and generate the report using the widget

7. To remove and clean out all created containers and volumes, run
   

   Code Block
   ./stop.sh

   
   

   Main Repositories

   • Hapi FHir for OpenMRS PLIR https://github.com/openmrs/openmrs-contrib-plm-fhir-server
   • Analytics Engine Pipeline https://github.com/GoogleCloudPlatform/openmrs-fhir-analytics