Introduction

Welcome to mSupply Mobile!

The original mSupply mobile docs are here We are slowly transferring documentation (and updating it) over to this web site.

Setting up mSupply Mobile on the device

mSupply Mobile can be set up on your Android device by the mSupply Support Team or by your internal IT team with our support

Choosing a device

Preparing the device

Preparing the device for mSupply is very dependant on factors including:

  • The make of the device
  • The version of Android running on it
  • The details of how the organisation plans to manage devices and communicate with users

Please consult with the mSupply Foundation support team ( support@msupply.org.nz ) on this.

Please note

  • A device is typically allocated to a facility, NOT an individual user. As such ALL operating system (i.e. Android) user accounts set up on the device must be for the site, not a person. This way, if a person leaves and another person takes over operation of the device, and nothing should need to be changed.
  • Each device running mSupply Mobile will correspond to one mSupply Store.

Initialising the store

After installing the mSupply Mobile app, you must initialise the data for the mSupply Store that the device is going to be used in. Most of the work is actually done by mSupply but you will need to set the store credentials on the device.

When first syncing the new device the amount of records to sync may be large (say around 50,000). This could take hours to sync, especially over a poor internet connection. For this reason it is possible for you to limit how many months of transactions and stocktakes you want to include. Limiting the sync date range below explains how to limit the sync date range if this is required.

When you open mSupply Mobile, the first screen looks as follows:

Setup screen!

  • PRIMARY SERVER URL: Please enter the correct URL for your mSupply Server, this uses HTTPS protocol for security. Forexample: https://your organisation.msupply.org
  • SYNC SITE NAME: The site name as configured on the primary server.
  • SYNC SITE PASSWORD: The password for the sync site as configured on the primary server.

Once you have entered the information, click Connect to start sync.

Initialising screen!

Initialisation can take between 1 and 15 minutes depending on the number of records on the server related to the site being synced.

Initialising screen!

Once the server has found all the records to sync, mSupply Mobile will start pulling them between 20 and 500 records at a time depending on the connection speed. If the connection is lost or you close the app, you can resume sync where it stopped by entering the exact same details. Please note that if you enter different details, it will restart the sync completely!

Logging in to the store

Once complete, you will be taken to the login screen. For guidance beyond here see the mSupply Mobile user guide.

Limiting the sync date range

When first syncing the new device the amount of records to sync may be large (say around 50,000). This could take hours to sync, especially over a poor internet connection. For this reason it is possible for you to limit how many months of transactions and stocktakes you want to include.

Initialising screen!

  • Change the store Synchronisation type from collector to active or none to unlock editing custom fields.
  • Add a new line setting the Field label to syncMonths and the Field value to the number of months you wish to include.
  • To edit the custom field double-click on the line.
  • Change the store Synchronisation type back to collector

Now whenever a sync is carried out the store will only sync transactions and stocktakes for the previous X months.