Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

The Easiest way to have the PLIR set up locally is by using Docker and Docker Compose 

...

  1. Clone the Repository locally 

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


  2.  Move to the project root directory and Spin Up the pre-configured OpenMRS ,OpenHIM and Hapi-Fhir instances .

    Code Block
    languagebash
    docker-compose up


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

    InstanceURLcredentials (user : password)
    OpenMRShttp://localhost:8080/openmrs    admin : Admin123
    OpenHIM http://localhost:9000 root@openhim.org : openhim-password
    Hapi FHirhttp://localhost:8090

     hapi : hapi123

    After Logging into OpenHIM  (see more ), Import the Config-file inside the Config folder ie    config/openhim-config.json 
    Note that the OpenMRS Instance above is pre-loaded with CIEL and comes with a sample form (TX_PVLS form) to collect TX_PVLS specific data

  4. Load the necesary TX_PVLS [Measure](https://wiki.openmrs.org/display/projects/FHIR+Measure+Resources+For+PLIR) and [Library](https://wiki.openmrs.org/display/projects/Sample+FHIR+CQL+Libraries+for+the+Calculation+of+TX_PVLS) Resources into the Hapi FHir .
    you can load the resources directly from the resources folder directly using the loadResources script. run the command below from the project Root directory



    chmod +x * ; ./loadResources.sh

    see how to [load the Resources](https://wiki.openmrs.org/display/projects/Steps+For+Testing+Calculation+of+TX-PVLS+Indicator+Using+CQL) into Hapi Fhir using PostMan client.


    5. Spin up the streaming-debezium pipeline  . 

    Code Block
    languagebash



    docker-compose

    -f

    pipeline-compose.yml

    up




    Note that you run the above command from the root directory of the cloned repository.

     You




    You can use the TX_PVLS form pre-loaded in the OpenMRS instance to capture TX_PVLS specific data

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

     See here how to invoke the evaluate-measure and collect-data operation


    7. Invoke the **collect-data** FHIR Operation using the Get request below to generate the relevant Dataset for TX_

    PVLS and the actual indicator calculation based on CQL evaluation

    PVLS


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

    see sample [here](https://wiki.openmrs.org/display/projects/Steps+For+Testing+Calculation+of+TX-PVLS+Indicator+Using+CQL)

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

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

    see sample resultset [here](https://wiki.openmrs.org/display/projects/Steps+For+Testing+Calculation+of+TX-PVLS+Indicator+Using+CQL)