Make sure you have docker and docker-compose installed locally.
...
Clone the Repository locally
Code Block language bash git clone https://github.com/openmrs/openmrs-plir-dockerized-setup.git
Move to the project root directory and spin up the pre-configured OpenMRS ,OpenHIM ,Hapi-Fhir and the streaming-binlog pipeline instances .
Code Block language bash ./run.sh
You should be able to acces the OpenMRS ,OpenHIM and Hapi-Fhir instances at the following urls
After Logging in OpenHIM see more, go to the Export/Import tab and import the config-file inside theInstance 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
config
folder ieconfig/openhim-config.json
.Note:
The OpenMRS Instance is pre-loaded with CIEL and a sample form (HIV_form) to collect TX_PVLS specific data
The above script also loads the necesary TX_PVLS Measure and Library Resources into the Hapi FHir . see the Resources under the
resources
folder.- The Openhim instance is pre-configured with the necesary meta-data
anyWait for the plir-streaming-pipeline container to start running before adding any data into OpenMRS. The running Pipeline will then listen to any
data changes added in to OpenMRS and route them to the FHIR server through OpenHIM.
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>
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 .- 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
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