Differences
This shows you the differences between two versions of the page.
Both sides previous revision Previous revision Next revision | Previous revision | ||
en:mobile:user_guide:getting_started [2021/05/26 01:12] – [Initialisations] Mark Glover | en:mobile:user_guide:getting_started [2022/01/21 01:12] (current) – [Sync] Mark Glover | ||
---|---|---|---|
Line 15: | Line 15: | ||
* mSupply may be able to work on older versions of Android, but, for ease of management, **Android 6** is the lowest acceptable version. | * mSupply may be able to work on older versions of Android, but, for ease of management, **Android 6** is the lowest acceptable version. | ||
* 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? | * 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? | ||
- | === Minimum specifications === | + | |
+ | === Hardware === | ||
+ | |||
+ | == Minimum specifications == | ||
* Minimum display size: **9.8 inches** (measured diagonally) | * Minimum display size: **9.8 inches** (measured diagonally) | ||
* Minimum display resolution: **768 × 1024 pixels** | * Minimum display resolution: **768 × 1024 pixels** | ||
* Android Version: **6.0** | * Android Version: **6.0** | ||
+ | |||
+ | But, if the operator' | ||
+ | |||
+ | == Recommended specification == | ||
If [[en: | If [[en: | ||
Line 27: | Line 35: | ||
The device must also be compatible with MDM (Mobile Device Management) software and support google services. | The device must also be compatible with MDM (Mobile Device Management) software and support google services. | ||
- | + | == Processor and RAM == | |
- | === Recommended Specifications === | + | |
These recommended specifications will allow mSupply Mobile to operate well on the device. | These recommended specifications will allow mSupply Mobile to operate well on the device. | ||
- | * **1.5 Gb** Ram | + | * **1.5 Gb** RAM |
* Quad-core 1.3 GHz | * Quad-core 1.3 GHz | ||
=== How will it connect to the internet? === | === How will it connect to the internet? === | ||
+ | |||
The most challenging aspect of any remote data recording solution is management of the internet connection. | The most challenging aspect of any remote data recording solution is management of the internet connection. | ||
* Who is responsible for keeping the device connected? | * Who is responsible for keeping the device connected? | ||
Line 51: | Line 59: | ||
</ | </ | ||
+ | ==== Configuration on the mSupply Server ==== | ||
+ | Before using mSupply Mobile, the mSupply central server needs to be configured for it - refer to [[https:// | ||
- | ==== Installation ==== | + | <WRAP center round important> |
- | You can download the latest version of mSupply Mobile from GitHub [[https:// | + | If you are upgrading |
- | + | ||
- | If you are upgrading | + | |
* Upgrade to mSupply Server v3.83 or higher | * Upgrade to mSupply Server v3.83 or higher | ||
* Set Visibility for Supplying Stores (including main Supplying Store) | * Set Visibility for Supplying Stores (including main Supplying Store) | ||
* Add a new Supplier as facility (External Supplier) and make it visible in mobile store | * Add a new Supplier as facility (External Supplier) and make it visible in mobile store | ||
* Set all other mobile/ | * Set all other mobile/ | ||
- | |||
- | ==== Initialisations ==== | ||
- | The mSupply Mobile app needs to be installed on your tablet. Once it is started, you need to enter the ' | ||
- | <WRAP center round important 60%> | ||
- | 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! | ||
</ | </ | ||
- | |||
- | There is also a little configuration required within | + | ==== Installation ==== |
+ | You can download the latest version of mSupply | ||
- | ==== OK. Here we go! ==== | + | ==== Connecting to the central server |
- | (Check | + | After the mSupply Mobile is installed on your tablet and you' |
- | This is the login screen. You will be given a user name and password when your tablet computer is installed at your clinic. Your tablet computer can only log in to one facility. | + | <WRAP center round important 60%> |
+ | * 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 | ||
+ | </ | ||
- | The first thing to do is to choose your preferred language by clicking **Language** at the bottom left of your screen. <WRAP clear/> | + | ==== Logging in ==== |
- | <wrap center round tip> | + | After the device has synced to the central server you will see the login screen: |
- | The tablet above is asking for the user name and password for the person that will be operating | + | |
- | </ | + | |
- | For example, if your first language is Tetum, then you're in luck!< | + | {{ : |
- | {{ :mobile:language.jpg |}}<WRAP clear/> | + | === Selecting the language |
- | <WRAP clear/> | + | * 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 [[https://en.wikipedia.org/ |
- | <WRAP clear/> | + | |
+ | {{ : | ||
- | Once you have selected the language of your choice, enter your user name and password and click **Login**! | + | === Logging in the user === |
+ | |||
+ | <WRAP center round important 60%> | ||
+ | * Users need to be configured on the mSupply central server -refer to [[https:// | ||
+ | </ | ||
+ | |||
+ | Once you have selected the language of your choice, enter the credentials (user name and password) for the store user and tap **Login** | ||
{{ : | {{ : | ||
- | + | ||
- | | + | <WRAP center round important 60%> |
- | <wrap info> | + | * 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. | ||
+ | </WRAP> | ||
+ | |||
+ | <WRAP center round info 60%> | ||
+ | After 3 minutes of not using the app (either it is in the background, or the app is asleep), you will be logged out. | ||
+ | </WRAP> | ||
+ | |||
+ | ==== 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. | 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. | ||
Line 99: | Line 117: | ||
{{ : | {{ : | ||
- | Red badges indicate there are unfinalised transactions requiring attention. Click a badge for a description. Badges will automatically disappear when there are no unfinalised transactions remaining. | + | === Icon badges |
+ | |||
+ | [[https:// | ||
{{ : | {{ : | ||
+ | |||
+ | === Sync === | ||
+ | |||
+ | <WRAP center round tip 60%> | ||
+ | * 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 [[en: | ||
+ | </ | ||
A link on the top right of the screen shows the **Sync Status**. | A link on the top right of the screen shows the **Sync Status**. | ||
Line 107: | Line 135: | ||
{{ : | {{ : | ||
- | Clicking this link will take you to a page where you can choose to do a manual sync if there is internet connectivity. | + | 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. | You can close this page by clicking the cross on the top right. | ||
+ | |||
+ | === Settings === | ||
Users with the appropriate permissions can access the mobile **[[en: | Users with the appropriate permissions can access the mobile **[[en: | ||
{{ : | {{ : | ||
+ | |||
+ | === Logging out === | ||
To log out, click the **Log Out** button on the bottom left of the screen. | To log out, click the **Log Out** button on the bottom left of the screen. | ||
Line 132: | Line 164: | ||
- | === Suppliers === | + | === Suppliers === |
{{mobile: | {{mobile: | ||
Line 144: | Line 176: | ||
- | === Stock === | + | === Stock === |
{{mobile: | {{mobile: | ||
<WRAP clear/> | <WRAP clear/> | ||
- | |||
{{: | {{: | ||
- | |||
{{: | {{: | ||
| | ||
+ | ==== Tetum ==== | ||
- | ---- | + | And here is the main screen in Tetum! |
- | + | ||
- | (And here' | + | |
- | <WRAP clear/> | + | |
{{ : | {{ : | ||
- | <WRAP clear/> | ||