This is the user guide for OpenMRS-iOS. If you're looking for the development guide, it's over here.
Download
| Anchor | ||||
|---|---|---|---|---|
|
...
| Widget Connector | ||
|---|---|---|
|
| Anchor | ||||
|---|---|---|---|---|
|
After building or downloading the app, you will see a login screen:
Host: The URL of your OpenMRS installation. Note that the app requires the URL that you would visit in a web browser to log in; demo.openmrs.org/openmrs will work, but demo.openmrs.org will not.
...
Password: The password that you use to login to OpenMRS
Sign in: To sign in with the info you just entered
Demo: To sign in with the login info below
Demo Login info:
- Host:
demo.openmrs.org/openmrs - Username: admin
- Password: Admin123
| Anchor | ||||
|---|---|---|---|---|
|
After successfully logging in, you will see a main menu:
Patient Search: This opens a window where you can search for existing patients.
...
Settings: This opens a window where you can logout of OpenMRS on your device. Logging out also destroys any saved patients on your device.
Active visits: This opens a window where you can see currently active visits available from the server.
Filled XForms: This opens a window with XForms that were filled and saved offline.
Log out: This will log you out after showing you a warning that you the offline saved data will be removed
| Anchor | ||||
|---|---|---|---|---|
|
- First section:
- Logged in: username logged
- Backend host: server URL
- App version: App version you are on
- About the project: Open the project webpage
- Send feedback: It will show you a view where you can enter text to send feedback to us!
- Second section:
- Remove offline patients: Remove all offline patients
- Sync offline patients: Synced offline saved edits to server.
- Patient refresh interval: Set number of minutes for timer to refresh patient data when you are looking at it, to disable set to 0
- Third section:
- XForm view: Click to select from 2 views for the forms Wizard mode or Single form, screenshots below.
- Show locked fields: Turn off if you want to hide all locked fields
- date/time/dateTime formats: If you are having problems submitting xforms make sure they match the one on the server from the settings
| Anchor | ||||
|---|---|---|---|---|
|
Shows a list of all active visits, with it's types, location and dates!
| Anchor | ||||
|---|---|---|---|---|
|
Shows a list of forms saved filled and saved offline you can review them by tabbing on them, or delete them by swiping,
or send them individually after reviewing by submitting them like normal forms
or send them all from that button at the top: Sync filled form
| Anchor | ||||
|---|---|---|---|---|
|
By tapping the add patient button on the main menu, you can add a patient to the OpenMRS database:
Note that when specifying an identifier, you must manually enter the identifier. The app currently does not support automatically generated identifiers.
and make sure you are entering appropriate values in fields
| Anchor | ||||
|---|---|---|---|---|
|
Clicking Patient Search in the main menu will bring you to a table view with a search box. Type your search into the box, and the list will update in real-time with matches:
Patients appear in an Identifier - Patient Name format. Tapping on one of the results will open a view with more information about the patient selected.
If you have saved patients for offline use, they will appear in the list even if you are not connected to the Internet.
| Anchor | ||||
|---|---|---|---|---|
|
When you select a patient, you will see a screen with information about the patient:
Tapping the Actions... button will expand to show actions that can be taken on the patient:
...
- Save for Offline Use: This button will sync all information about a patient to an encrypted database on your local device. When you aren't connected to the Internet, you will still be able to view information about the patient. If the patient is already saved, this button will update the patient with the most recent data from OpenMRS.Selected the visits or encounters rows will show a list of visits or encounters. Tapping one of the items in the Encounters list will show a list of details about the encounter.
- Update offline record: If record already saved, to update it from server, or sync it's offline edits with server if not synced
- Remove offline record: If record already saved, you can remove it.
- Start Visit/End visit: This button will show a view to start a visit or warn you if u want to stop current active visits.
- Edit Patient: This button shows a view where you can edit current patient data
| Anchor | ||||
|---|---|---|---|---|
|
Tapping the add visit note... button button on a patient view will show a page where you can type in a note:
...
Note that you must choose a location before submitting the vitals. Also, you do not need to include units of measure when entering the values.
| Anchor | ||||
|---|---|---|---|---|
|
Shows a form that has the patient data filled already, and you just edit the stuff you want and press save
If you are not connected to the internet it will be saved offline to be synced later
| Anchor | ||||
|---|---|---|---|---|
|
This view displays the visits for this patient and showing the following info:
- Visit type
- Location
- Status
- DateTime
| Anchor | ||||
|---|---|---|---|---|
|
Showing the encounters for that patient and when you open it, you get a list of obs, OR If your server has version 4.3.6 of the XForms module
and that encounter is filled with an XForm, it will show a copy of that filled xform.
| Anchor | ||||
|---|---|---|---|---|
|
Shows available xforms on the server, and you can select any of them to start filling it for that patient.
| Anchor | ||||
|---|---|---|---|---|
|
You basically get 2 ways to view the xform that you can select from the settings
Single form:
Wizard mode:
*Navigation by swiping left and right
Demo filling an XForm on the iOS client:
| Widget Connector | ||
|---|---|---|
|