Page tree

Versions Compared

Key

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

...

mUzima Application gives you the chance to customize the application with your special requirements. This is done through default settings (settings that personalize the app to the users user's needs), that can be personalized.

...

  1. On any page where the options menu is available, tap the three vertical dots () at the top-right corner.
  2. Then a A menu will appear which gives you an access to further actions related to the current activity such as Settings, Help, and also gives the ability to log out.


  3. Choose the 'Settings' menu item, then the Settings menu will be appear.  You can now configure the parameters of the feature you would like to change.

OpenMRS Settings

Server URL

...

  1. Tap on the available server link and you will be enable able to make the necessarily necessary changes by typing a new server URL.


  2. Tap 'OK' to save the changes or tap 'CANCEL' to revert the changes.
    After tapping 'OK', an alert dialog will be appear which warns you that if you change the server URL, all your mUzima data will be cleared.
    At this point, you can withdraw you server URL changes (by tapping 'NO') or confirm them (by tapping 'YES').

Note

If you change the server URL, it will clear all mUzima data from your device.

...


Note

There is no option to change the

...

username or the password. They can only be changed from the server-side.

mUzima Settings

Session Timeout

...

  1. Tap on the session timeout field. The session timeout dialog pop-up.

  2. Set the new session timeout value in minutes.

  3. Tap 'OK' to save the changes or tap 'CANCEL' to revert the changes.

...

Note

For security reason, it is recommended not to set the session timeout to a large value since it will take long to automatically log you out if you forget to log out. If you set it too short, it

...

will make the application to log you out more often.

Automatic form save interval (mins)

Automatic form save interval is the time interval the application takes to automatically save the current form changes (saved as a draft), this helps in reducing the risk of important data loss.

...

If Internet connection is not available, completed form data will be synced when connection becomes available later.

If the Real Time Sync check box checkbox is ticked, the real time synchronization is set (enabled), otherwise it is disabled.

To set this feature, tap on the Real Time Sync check boxcheckbox:

Require medical record number

...

Info

This setting depends on the server side setting. It will only be set if the server side is set (enabled), else it will be disabled.

For setting To set this feature:

  1. Tap on the 'Require medical record number' field. 
    If the checkbox is ticked, it means you need to set the primary medical number to the new client clients (patients) during the registration process.
  2.  After, you tap on this settings, a dialog appear: This will check if the server side setting is enabled in order for it to enable the mobile side.

...

Duplicate form data warning

If the check box checkbox is checked, you will be warned in case the same form template has been filled for the same patient with the same encounter date. This feature helps in avoiding form data duplication. If not checked, no possible duplicate warning will be given.

To avoid the form duplication, set this feature on, by taping the check boxcheckbox:

Font size

mUzima application lets you adjust the font size to one that most suits you. This font size applies only to all forms.

To set the font size:

...

mUzima application gives you the opportunity to select the landing page: dashboard or client list. This means after in the next log inlogin, the selected page appears(dashboard/client list) is displayed.

To set the landing page:

  1. Open the landing page dialog by tapping on the landing page settings. 
  2. Choose one of the available options: Dashboard, Client List.


Dashboard:

Client List:

Enable

...

Day Mode (New Feature coming up in versions greater than 2.4.0)

mUzima App provides two different themes: Dark and Light. The default theme is the dark.

To set the Light theme as the mUzima Application theme, tap on the 'Enable Night Day Mode' checkbox:

Dark Theme:

Light Theme:

Some examples of multi-themed pages of mUzima Application:

                 Image Added

                Image Added

Enable SHR

With this these settings, you can enable or disable the use of smart card feature.

To make it enabled, tap on the 'Enable SHR' checkbox. 

Image Modified

If SHR is enabled, on the clients listing page, you can will see a yellow sim card icon with a search icon in it. When SHR is disabled, the yellow icon is not seen. 


Clients List: (SHR Enabled)

Image Modified

Client List: (SHR Disabled)

Image Modified

If SHR is enabled, on the client summary page, you can see a yellow sim card icon and the SHR data tab. Otherwise they can not be seen:

Clients Summary:(SHR Enabled)


Image Modified

Client Summary:(SHR Disabled)

Image Modified


Enable GPS

Checking/Ticking this enables collecting GPS coordinates when a form template is opened assuming user agrees to turn on device location and internet connectivity is available. This feature is used for setting device location in forms automatically. If it is enabled, the location on forms will be set according to the device's location.

Image Modified


Info

You need to enable the permission to capture location data on your device, otherwise, permission denied message will be populated.

...

Provider/Location Settings

Default encounter provider

In mUzima application, you can set the logged in user as the default encounter provider. If the check box checkbox is checked, the logged-in user will automatically be populated as the encounter provider for all forms on from form load.

Image Modified

Manage Providers

Under this section, you can manage providers by downloading more providers from the server or removing provider or providers (s) from the device. For opening To open the Providers dialog, tap on 'Manage providers' field.

Adding a new provider 

 Start typing the name of the provider you would like to add to the providers' list.
After typing at least three characters, if mUzima app finds any name which matches your request, a list appears and you can choose the provider you want.

Choose the desired name from the list. The selected name will be added instantly to the providers' list:

Image Modified

Info

Internet connection is needed when adding providers to the provider list.


Remove provider

You can remove one or more providers at the same time:

Select the provider(s) you would like to remove.
The background color for the provider will turn into blue signifying it is selected. At the same time, a bin icon (Image Modified ) appears at the top-right corner of the screen. 

Tap on the bin (Image Modified) icon. The provider(s) will be removed immediately from your providers' list.
You can remove multiple providers at the same time by selecting all of them one by one.
Image Modified

Default Encounter Location

...

Follow the following steps to set the default encounter location:

Tap on the Default Encounter Location field (this field shows you the current default encounter location). 

A pop-up dialog appears upon tapping, select a location from the list. After your selection, the default encounter location will be set immediately. If you don't want to set or change it, tap on the 'Cancel' button.
Image Modified

Note

If the location you selected would be removed from your location list, the default encounter location will be changed into 'No default encounter location'.

...

Under this section, you can manage locations by downloading one from the server or removing one/more from your device. To open the Locations dialog, tap on Manage locations field.

Add new location

Start typing the name of the location you would like to add to the locations list. After typing at least three characters, if mUzima app finds any location name which matches your request, a list appears.

Choose the location you want to add to the locations list. The new location will appear on the locations list immediately.
Image Modified

Info

Internet connection is needed when adding providers to the provider list.

Remove location

You can remove one or more locations from your list at the same time:

Select the name of the location you want to remove from the locations list.
The background of the location will turn into blue

...

signifying it is selected for removal. At the same time, a bin icon (Image Modified) appears on the top-right corner of the screen.
You can deselect any location by

...

tapping on it again.

Tap on the bin (Image Modified) icon to remove the location or locations.
The location will be removed immediately from the list.
You can remove multiple locations at the same time by selecting all of them one by one.

Image Modified


Note
If you remove the location which was set as default encounter location before, the default encounter location will show 'No default encounter location'.

...

A cohort is a list of patients that share the same characteristics, e.g. location, age, gender. Cohorts are created according to the patient attributes.

To open the Manage cohort prefixes dialog tap on Manage cohort prefixes field.

Add new cohort prefix

Start typing part of the desired cohort you would like to add to your list. After typing at least three characters, all matching cohorts will be displayed in a list. 

Choose a cohort you would like to add your list and tap on the 'Add' button, mUzima app will append it to your cohort prefixes list:
Image Modified

Remove cohort prefix

You can remove a cohort prefix from your list by selecting the bin icon ( ) next to the name of the cohort prefix.

...

To open the Concepts dialog, tap on the Manage concepts field.  You can manage your concept list at any time. 

Adding new concept

Start typing the name of the concept you would like to add to the concepts list. After typing at least three characters, all concepts matching the characters will be displayed in a list. 

Choose the concept you would like to add your list and mUzima app will automatically add it to your concept list:
Image Modified

Remove concept

You can remove one or more concepts from your list:

Select the name of the concept you would like to remove.

The background of the concept will turn into blue signifying it is selected for removal. At the same time, a bin icon ( Image Modified) appears on the top-right corner of the screen.
You can remove multiple concepts at the same time by selecting all of them one by one.
You can deselect any concepts by

...

tapping on it again. 

To remove the concept from the concepts list, tap on the bin (Image Modified) icon and the concept will be removed immediately from your concepts list.
Image Modified