Projects

Wiki Spaces

Documentation
Projects
Resources

Get Help from Others

Q&A: Ask OpenMRS
Discussion: OpenMRS Talk
Real-Time: IRC Chat | Slack

Projects

Page tree
Skip to end of metadata
Go to start of metadata

OpenMRS 2.x Android Client

Project leads

Adam Grzybkowski, Avijit Ghosh, Tomasz Marzeion

OpenMRS point of contact
Rafal Korytkowski < 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 Rafal Korytkowski 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 Getting Started as a Developer (Archived Version).

Acknowledgements

Currently the project is maintained by Adam Grzybkowski and Tomasz Marzeion funded by the SolDevelo company and mentored by Rafal Korytkowski (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


  • No labels

6 Comments

  1. Venkat Parthasarathy

    I was trying to work on this project but the Gradle build is not successful. I installed Android 6.0 and Android 5.1 and have the latest SDK tools. Can anyone help me with resolving this issue? I have attached the log file of the Gradle console. 

    1. Rafal Korytkowski

      Avijit Ghosh, have you seen that? Looks like it may be related to your recent commit.

      1. Avijit Ghosh

        Sent a hotfix patch: https://github.com/openmrs/openmrs-contrib-android-client/pull/111

        1. Rafal Korytkowski

          Venkat Parthasarathy, could you please update to the latest revision and try building again?

          1. Venkat Parthasarathy

            I applied the patch and it built successfully. 

  2. Avijit Ghosh

    Rafal Korytkowski Indeed, this seems to be the error: http://stackoverflow.com/questions/25145539/android-studio-compile-error-content-is-not-allowed-in-prolog

    I'll just move the file out of the project and save it somewhere else (not on repo). 

Feedback on this page? Questions?

Visit OpenMRS Talk, our community discussion hub.

Copyright © 2004-2016 OpenMRS Inc. By using this site, you agree to the OpenMRS Privacy Policy.
Text is available under the Creative Commons 4.0 International Attribution License (CC BY 4.0).
Software is available under the Mozilla Public License 2.0 with Healthcare Disclaimer (MPL 2.0 HD).
"OpenMRS" is a registered trademark and the OpenMRS graphic logo is a trademark of OpenMRS Inc.