Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Note

This page is outdated and no longer receives updates!

<< OpenMRS-iOS Client [Home]

This is the user guide for OpenMRS-iOS. If you're looking for the development guide, it's over here.

Download

...

Anchor
requirements
requirements
Requirements

...

Anchor
video
video
Demo Video

Widget Connector
overlayyoutube
_templatecom/atlassian/confluence/extra/widgetconnector/templates/youtube.vm
width400px
urlhttps://www.youtube.com/watch?v=mY6B50UKDn8
height300px

Anchor
loggingin
loggingin
Logging in

After building or downloading the app, you will see a login screen:Image Removed

...

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.

...

Demo: To sign in with the login info below

Demo Login info:

Anchor
mainmenu
mainmenu
Main Menu

After successfully logging in, you will see a main menu:Image Removed

...

Patient Search: This opens a window where you can search for existing patients.

...

Anchor
settings
settings
Settings:

...

  • 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
Active visits
Active visits
Active visits:

...

By tapping the add patient button on the main menu, you can add a patient to the OpenMRS database:Image Removed

...

Note that when specifying an identifier, you must manually enter the identifier. The app currently does not support automatically generated identifiers.

...

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:Image Removed

...

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.

...

When you select a patient, you will see a screen with information about the patient:Image Removed

...

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.

  • 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.

...

Tapping the add visit note... button on a patient view will show a page where you can type in a note:Image Removed

...

Note that you must choose a location before submitting the note.

...

Tapping the capture vitals button on a patient view will show a screen where you can record a patient's vitals:Image Removed

...

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.

...

This view displays the visits for this patient and showing the following info:

  • Visit type

  • Location

  • Status

  • DateTime

Anchor
Encounters
Encounters
Encounters:

...

Anchor
Form Entry
Form Entry
Form Entry:

...

Shows available xforms on the server, and you can select any of them to start filling it for that patient.

Anchor
Form Entry
Form Entry
Form Views

You basically get 2 ways to view the xform that you can select from the settings

Single form:Image Removed

...

Wizard mode:

*Navigation by swiping left and rightImage Removed

...

Demo filling an XForm on the iOS client:

Widget Connector
overlayyoutube
_templatecom/atlassian/confluence/extra/widgetconnector/templates/youtube.vm
width400px
urlhttps://www.youtube.com/watch?v=RvSRoguIdNs
height300px