OWA’s are simple web apps developed using web technologies like JS, HTML and CSS. OpenMRS REST API can be used for the server side calls. It is configured using an OpenMRS OMOD. Please refer this OpenMRS wiki page before configuring the OWA.
Configure OWA module in Bahmni
You will need to do the following only if you have custom setup Bahmni or want to enable OWA in release 0.90 or prior. From 0.91 onwards, the OWA module comes packaged with Bahmni. If you are looking to write your own OWA, then please refer to the 'Developer Guide'.
Download the latest version of owa-X.X.omod from here.
Copy the omod to /opt/openmrs/modules in bahmni instance. And restart the openmrs service.
This will create owa folder inside /opt/openmrs path. And you will be able to see Open Web Apps Module in OpenMRS Administration page as shown in the below screenshot.
Once the above setup is done, we can add our custom OWA to OpenMRS. This can be done in either of two ways. Check this openmrs owa repo for reference. This repo has detailed instructions on how to deploy the code in server.
Copy your custom OWA folder inside /opt/openmrs/owa path. Then you can access the app from “Manage Apps” page.
2. Create a zip file out of your custom owa folder. Browse and Upload it from OpenMRS UI as mentioned in the below screenshot.
To upload it from OpenMRS UI, you need to set module.allow_web_admin value to true in /opt/openmrs/etc/openmrs-runtime.properties file. This value is set to false by default.