OpenMRS 2.x Android Client

Owned by Kamil Kalfas
Last updated: Jan 17, 2020 by Devansh Khetan
4 min read

OpenMRS 2.x Android Client

Project leads

Adam Grzybkowski, Avijit Ghosh, Tomasz Marzeion

OpenMRS point of contact
raff < rafal@openmrs.org >

Assigned to

SolDevelo

If you are an implementer and you wish to use our application, please do not hesitate to contact us via talk.openmrs.org. We are looking forward to collaborating with implementations of any size and geographic location that wish to use our product. We are very flexible and open to adjusting the objectives of the project to satisfy real life requirements first.

Abstract

The purpose of this project is to provide an OpenMRS 2.x client for Android devices. The app covers most of the functionality present in the web application including registering patients, taking visit notes, capturing vitals, etc..

The app communicates with OpenMRS instances using REST. It supports working offline (without network connection) with a chosen subset of patients. The database on the device is encrypted and password protected in order to secure patient data.

Screenshots - Click pictures to see enlarged version

Login PageDashboardDownloaded PatientsPatient DetailsPatient VisitsPatient VitalsActive VisitsRegister PatientForm EntryEncounter FormsVitals Form

Release notes

Version 2.5

Summary:

  1. Log in offline
  2. Coded fields in forms
  3. Edit forms
  4. Edit patients
  5. Bug fixes 

See more in JIRA.

Version 2.4

Summary:

  1. Added merging patients registered offline
  2. Find Patient storyboard refactoring
  3. Fixed bugs

See more in JIRA.

Version 2.3

Summary:

  1. All new Material Design
  2. Patient registration with offline support
  3. New dynamic Form UI builder using the REST API, not using ODKCollect and XForms anymore
  4. Form entry support offline, even for locally created but unregistered patients.
  5. Fixed a lot of bugs. 

See more in JIRA.

Version 2.2

Summary:

  1. Online/Offline mode.
  2. Online patient registration
  3. Integrate Android Espresso Test Framework
  4. Allow user to continue filling the form which was saved.
  5. Increase Code Coverage

See more in JIRA.

Version 2.1.2

Summary:

  1. Added possibility to capture vitals from visit dashboard
  2. Provided data integrity with server side
  3. Updated flow for capturing vitals
  4. Optimised memory consumption
  5. Optimised application architecture
  6. Extended error handling
  7. Reduced bandwidth consumption with GZIP
  8. Bugs fixes and minor views improvements

See more in JIRA.

Version 2.1.1

Summary:

  1. Added possibility to capture vitals.
  2. Added possibility to start and end visit.
  3. Few views have been redesigned.

See more in JIRA.

Version 2.1

Summary:

  1. Added location to the login screen.
  2. Single patient synchronisation.
  3. Imported ODK Collect module.
  4. Added tablets compatibility.
  5. Last searched patients are listed in separated tab.
  6. Moved URL dialog as the first screen of app.

See more in JIRA.

Version 2.0
The first release is named to match OpenMRS 2.0.

Summary:

  1. Login screen
  2. Read-only access to patient details (full name, birthdate, address), vitals and visits.
  3. Downloading and storing patient data in the encrypted database on the device

See more in JIRA.

User Manual

In order to test the application, you can use our test server which is http://devtest04.openmrs.org:8080/openmrs. The username is admin and the password is Admin123. It is an installation of OpenMRS 2.2 with the additionally installed REST module upgraded to 2.12-SNAPSHOT, which you can download here.

Support, Q&A, & Discussion

Developer Manual

If you are keen to contribute code, please do not hesitate to contact raff by posting to talk.openmrs.org.

Please see the Resources section for a handful of links.

We are working in sprints. The issues included in the latest Sprint can be always found in JIRA at https://issues.openmrs.org/secure/RapidBoard.jspa?rapidView=60.

For instructions on how to setup your development environment please see https://github.com/openmrs/openmrs-contrib-android-client

We accept pull requests for issues in JIRA following the best practices defined by the OpenMRS Community. All you need to know can be found by exploring /wiki/spaces/docs/pages/25475369.

Acknowledgements

Currently the project is maintained by Adam Grzybkowski and Tomasz Marzeion funded by the SolDevelo company and mentored by raff (Regenstrief).

We are also grateful to our growing number of volunteer developers and other paid developers, who will be listed under each release. Please see the full list of contributors.


The project was then developed by Avijit Ghosh as part of Google Summer of Code 2016. Please see OpenMRS Android Client - GSoC 2016.

The initial work (versions 2.0 and 2.1) was done and funded by the SolDevelo company.

Resources

  1. JIRA https://issues.openmrs.org/browse/AC/?selectedTab=com.atlassian.jira.jira-projects-plugin:summary-panel 

  2. Sprint board https://issues.openmrs.org/secure/RapidBoard.jspa?rapidView=60

  3. Dashboard https://issues.openmrs.org/secure/Dashboard.jspa?selectPageId=12851

  4. Repository https://github.com/openmrs/openmrs-contrib-android-client

  5. CI http://openmrs-ac-ci.soldevelo.com/ci/ 

  6. Google Play https://play.google.com/store/apps/details?id=org.openmrs.mobile