Getting Started

Getting Started for mobile

Android device hardware requirements🔗

Google Mobile Services (GMS)🔗

• There is a good chance that if your proposed device is not on this list of supported models, then it will not support Google Mobile Services (GMS), mSupply Mobile and/or the mobile device management software used to remotely manage the device.
• Even if it is on this list, please make sure the model has been validated by Sustainable Solutions before procuring any significant quantities of the device. Please contact mSupply Support on support@msupply.foundation to see which models have been validated so far.

Android version🔗

• mSupply may be able to work on older versions of Android, but, for ease of management, Android 6 is the lowest acceptable version. Enrollment and management is even less error prone with Android 9+.
• Android 9 was released in August 6, 2018. Why would you be installing hardware that is already several years closer to it's end of service life?

Hardware🔗

Minimum specifications🔗

• Minimum display size: 9.8 inches (measured diagonally)
• Minimum display resolution: 768 × 1024 pixels
• Android Version: 6.0

But, if the operator's eyesight may be poor, or you will ever be wanting to monitor a fridge at the facility for very little extra cost, consider:

Recommended specification🔗

If mSupply Vaccine or mSupply Cold Chain are to be used on the device at any point, the following are required minimum specifications:

• Minimum display size: 10.1 inch (measured diagonally)
• Minimum display resolution: 800 x 1280 pixels
• Android Version: 8.1

The device must also be compatible with MDM (Mobile Device Management) software and support google services. Please contact Sustainable Solutions or mSupply Foundation for details.

Processor and RAM🔗

These recommended specifications will allow mSupply Mobile to operate well on the device:

• 1.5 Gb RAM
• Quad-core 1.3 GHz

How will it connect to the internet?🔗

The most challenging aspect of any remote data recording solution is management of the internet connection. It may be worth procuring devices that are mobile data enabled (3G minimum), at least to allow future flexibility. But that doesn't answer the harder questions:

• Who is responsible for keeping the device connected?
• Who pays for it?
• What happens when the bill isn't paid?
• What happens when a generous data cap is exceeded and the internet connection is down? (Somebody may have removed the SIM from the device and placed it in another device…)

• Ensuring device has connecting to the internet at least, say, once per week,
• Conducting stocktakes
• Placing Internal Orders
• Processing supplier invoices
• Other(s)

Of course, such an arrangement would still require management.

Configuration on the mSupply Server🔗

Before using mSupply Mobile, the mSupply central server needs to be configured for it - refer to the mSupply User Guide for details.

Installation🔗

You can download the latest version of mSupply Mobile from GitHub here.

Connecting to the central server🔗

After mSupply Mobile is installed on your tablet and you've started it, you need to enter the 'site' credentials (user name and password) and the URL for the mSupply server that will hold the data will be generated by the tablet.

• Be careful to enter the correct credentials here. If you fail to enter it three times in a row, you will be locked out from trying again for 1 hour!
• Android auto-correct may try to add a space after each word. This will result in incorrect credentials being entered.

Logging in🔗

After the device has synced to the central server you will see the login screen:

Selecting the language🔗

• The first thing to do is to choose your preferred language by clicking Language at the bottom left of the screen. For example, if your first language is Tetum, then you're in luck! - see below.

Logging in the user🔗

• Users need to be configured on the mSupply central server - refer to Setting up the Users to access the store

Once you have selected the language of your choice, enter the credentials (user name and password) for the store user and tap

Login

• Be careful to enter the correct credentials here. If you fail to enter it three times in a row, you will be locked out from trying again for 1 hour!
• Android auto-correct may try to add a space after each word. This will result in incorrect credentials being entered.

After 3 minutes of not using the app (either it is in the background, or the app is asleep), you will be logged out.

Main screen🔗

This brings us to the main screen. We will be returning to the main screen a lot as we use mSupply Mobile, so it's important to understand the main functions. Let's go through them one by one.

Icon badges🔗

Icon badges (orange circle with a number) indicate there are unfinalised transactions requiring attention. Click a badge for a description. Badges will automatically disappear when there are no unfinalised transactions remaining.

Sync🔗

• mSupply Mobile will attempt to sync to the Primary server at regular intervals.
• The default sync interval is 10 minutes.
• The interval between these attempts (the sync interval) can be configured to be from 1 minute to 10 minutes by Editing the Sync Interval.

A link on the top right of the screen shows the Sync Status.

Clicking this link will take you to a page where you can choose to do a manual sync if you want to re-sync in-between the automatic syncs.

You can close this page by clicking the cross on the top right.

Settings🔗

Users with the appropriate permissions can access the mobile Settings on the bottom right of the screen.

Logging out🔗

To log out, click the Log Out button on the bottom left of the screen.

Customers🔗

The Customers area is for all the stock that goes OUT of your facility. Customers can be other facilities you supply, doctors and nurses doing outreach tours, or individual patients.

The Customer Invoices button shows a list of orders sent TO your customers and allows you to create new ones.

The Customer Requisitions button shows a list of orders placed BY customers requesting stock from your store.

Suppliers🔗

The Suppliers area shows orders that you have placed and received for your own stock. Usually, you will only have ONE supplier (a medical store or other healthcare facility) and this will be pre-programmed for you.

The Supplier Invoices button shows a list of orders you have received or are waiting to receive.

The Supplier Requisitions button allows you to place an order and shows a list of orders you have already placed.

Stock🔗

The Stock section is used to manage the stock in your store.

The Current Stock button allows you to easily see how much stock you have on hand ("How many paracetamol tablets do I have?"), search for an individual item, or check expiry dates.

The Stocktakes button allows you to do a stocktake on all items or a small selection of items and shows you a list of all previous stocktakes. You can also use this area to update the stock levels of an item when you realise there is a mistake.

Tetum🔗

And here is the main screen in Tetum language!