...
The application uses the Xforms module and is built on top of JavaRosa. The application hasn't been tested extensive on different phones but in theory it should work on most J2ME compatible phones.
[edit]
Prerequisites
...
Working OpenMRS installation with XForms Module installed
- Install OpenMRS
- Install the XForms Module
- Configure xform module
- Login to your OpenMRS installation and select "Administration" from the menu bar
- Select Manage Global Properties from the Maintenance section.
- Scroll down to xforms.showModelXmlTab and type "true" in place of the "false".
- Locate xforms.showXformsSourceTab and type "true" in place of the "false".
...
Use Cases
The functionality supported by OpenMRS-JR allows the user to download a list of patients as well as a list of forms and fill out a form for a patient and then either submit it back to the server or save it for later submission. A JavaRosa-specific form allows users of OpenMRS-JR to submit patient registration information to an OpenMRS server, thus allowing patients to be created. These functions are can be broken down into these two use cases.[edit]
Download Forms and Cohorts, and Fill out a form for a patient
...
http://archive.openmrs.org/wiki/Image:Mobilemrs-uc3.png[edit]
Creating new OpenMRS Patients
...
http://archive.openmrs.org/wiki/Image:Mobilemrs-uc2.png
[edit]
Installing the mobile application
The application can be installed on your mobile phone by visiting this link in your phone's browser: http://bitbucket.org/cell_life/openmrs-jr/downloads/OpenMRS-JR.jad If your phone gives problems downloading the application via the JAD, access the JAR directly at: http://bitbucket.org/cell_life/openmrs-jr/downloads/OpenMRS-JR.jar[edit]
Developer Guide
OpenMRS-JR requires a JavaROSA build. JavaROSA is hosted at bitbucket.org and can be downloaded using the instructions on their wiki: http://bitbucket.org/javarosa/javarosa/wiki/Home It is highly recommended that the Demo project in JavaROSA be compiling and running as a precursor to OpenMRS-JR.
...
A video showing the application at work can be seen here: http://screenr.com/WEA[edit]
Feature List
...
Properties
- Enter the base url for the OpenMRS server.
- All other URLs are generated off this base URL. If this URL is incorrect, none of the form download, patient download, cohort download, patient creation, user authentication, or form submission features will work.
http://archive.openmrs.org/wiki/Image:OJRProperties.jpg[edit]
Login
- Enter the username and password.
- If the user has not logged in using the phone before, authenticate the user by contacting the server and saving the user profile.
- otherwise simply verify the password using the local user profile.
http://archive.openmrs.org/wiki/Image:OJRLogin.jpg
[edit]
Cohorts
Shows a list of cohorts. Selecting a cohort causes the list of patients to be downloaded. Once the patients are downloaded, proceed to Patient List screen.
http://archive.openmrs.org/wiki/Image:OJRCohorts.jpg[edit]
Patient Select
This is the central screen of the app. It shows a list of patients. If there are no patients, load the Cohorts screen and download a list of available cohorts from the server. From this screen, it is possible to download more patients (via the cohort screen), view and download forms, create new OpenMRS patients, or view any unsent forms. Selecting a patient moves focus to the Patient Details screen, and then to the Form List screen.
http://archive.openmrs.org/wiki/Image:OJRPatientselect.jpg[edit]
Patient Details
This screen shows the patients= basic demographic details.
http://archive.openmrs.org/wiki/Image:OJRPatientdetail.jpg[edit]
Downloading Forms
Show a list of forms already on the phone, and presents the option to download more forms or update the existing forms with newer versions of the forms. Newly downloaded forms overwrite existing forms with the same name. Selecting a form opens the form for filling.
http://archive.openmrs.org/wiki/Image:OJRChooseForm.jpg[edit]
Filling a Form
This screen navigates the user through each question in the form prompting the user for answers. The user can move forwards or backwards through questions, or exit the form.
http://archive.openmrs.org/wiki/Image:OJRFormfilling.jpg
[edit]
Saving A Form For Later Sending
...
http://archive.openmrs.org/wiki/Image:OJRSavingforms.jpghttp://archive.openmrs.org/wiki/Image:OJRSendingForms.jpg[edit]
Viewing Unsent Forms
When the compulsory questions in a form are filled out, the form becomes able to be saved. Saved forms can be sent at a later stage either individually or as a group of forms.
http://archive.openmrs.org/wiki/Image:OJRUnsentForms.jpg[edit]
Creating A New Patient
It is possible to create OpenMRS patients. When this feature is selected, a form loads and the user is prompted to fill data for the minimum fields that OpenMRS requires for a patient creation. Once the form is filled out, and the form submitted, the newly created patient should be visible in the patient list in OpenMRS. Note that for the phone to download the new patient, there has to be a cohort that includes this patient, and the user needs to re-download that cohort.
http://archive.openmrs.org/wiki/Image:OJRNewPatient.jpg[edit]
Creating A Compatible XForm
The simplest form acceptable consists of 3 sections: Patient information, Encounter information and Observation information. The following fields MUST be present: PATIENT.PATIENT_ID, ENCOUNTER.ENCOUNTER_DATETIME, ENCOUNTER.LOCATION_ID and ENCOUNTER.PROVIDER_ID.[edit]
Designing the XForm
The simplest method of creating a form is to go Administration in your OpenMRS instance and select "Manage Forms"
...