Anonymous Patient Registration project - Description, Code and Installation guide

GSoC-2017-Openmrs.md

Anonymous Patient Registration Project

Student: Nipun Thathsara

Mentor: Sara Fatima

Project: Anonymous Patient Rgistration Project

Organization: Openmrs

Description: Openmrs supports registration of unknown patients. Project objectives are to make this function work out of the box for reference application and move unknown patient registration functionality to the openmrs-core by removing its dependency to modules.

Code

openmrs-core commits

https://github.com/nipunthathsara/openmrs-core/commit/a1efb660cf5b2017270ea8160cc460f165e52bd2

https://github.com/nipunthathsara/openmrs-core/commit/df556e306273c38ec4c0522b4664ee9472f1890c

https://github.com/nipunthathsara/openmrs-core/commit/e271240f22a785a2d341e1840b0eebc18c1efc9c

openmrs-module-registrationapp commits

https://github.com/nipunthathsara/openmrs-module-registrationapp/commit/93725dbf07833acc968c3d0b6bcc0b423314e7cf

https://github.com/nipunthathsara/openmrs-module-registrationapp/commit/7f080d9dd7a9569e8b4f034f4c5c72618e06d11d

openmrs-module-registrationcore commits

https://github.com/nipunthathsara/openmrs-module-registrationcore/commit/de328628e4722357acc43ebcb7cdf7a8b5fb4e93

https://github.com/nipunthathsara/openmrs-module-registrationcore/commit/915683fdf9d148f958717429131f6694fe69c2c4

https://github.com/nipunthathsara/openmrs-module-registrationcore/commit/15d70f0b7ab239a7395717f95d86096b4c07bfc8

Repositories involved

Project involves three repositories

• openmrs-core
• openmrs-module-registrationapp
• openmrs-module-registrationcore

Since Openmrs lacks reverse compatibility among its modules and platform, the versions which are available at the default download link are being used in the development process. Branch created (b-version) in each repository when pushing the changes.

Documentation

• openmrs talk

• openmrs wiki

• Demonstration video

Running the project

1. Build Platform

   Clone: git clone https://github.com/nipunthathsara/openmrs-core.git

   Checkout branch: git checkout b-2.0.5

   Build: mvn clean install -U -DskipTests (Build core first and update maven local repository (.m2) to build other modules)

2. Copy openmrs.war file from openmrs-core/webapp/target/ directory to <CATALINA_HOME>/webapps/ directory

   Restart the server.

   Go to http://localhost:8080/openmrs

   Install the web application.

3. Build RegistrationCore module

   Clone: git clone https://github.com/nipunthathsara/openmrs-module-registrationcore.git

   Checkout branch: git checkout b-1.7.1

   Build: mvn clean install -DskipTests

4. Build RegistrationApp module

   Clone: git clone https://github.com/nipunthathsara/openmrs-module-registrationapp.git

   Checkout: git checkout b-1.8.0

   Build: mvn clean install -DskipTests

5. Download other required modules

   Download

   Extract the zip file into ~/.Openmrs/modules directory.

   Delete registrationapp-1.8.0.omod and registrationcore-1.7.1.omod from the extracted directory.

   Replace them with your build artifacts. (copy registrationapp-1.8.0.omod from openmrs-module-registrationapp/omod/target/ to ~/.Openmrs/modules/ directory) (copy registrationcore-1.7.1.omod from openmrs-module-registrationcore/omod/target/ to ~/.Openmrs/modules/ directory)

6. Restart the server (Tomcat)

Note : If an exception like this appears,

org.apache.jasper.JasperException:/WEB-INF/view/uncaughtException.jsp(line:9,column:0)Unabletofindtaglib"c"forURI:/WEB- INF/view/module/legacyui/taglibs/c-rt.tld

re-start the server (Tomcat)

TODO

1. Write unit-tests.

2. Re-write validations to address the new changes.