Differences

This shows you the differences between two versions of the page.

--- mobile:mobilesetup [2019/08/12 06:26] – ↷ Links adapted because of a move operation lou
+++ mobile:mobilesetup [2023/10/09 04:58] (current) – Nick Pendergrast
@@ Line 1: / Line 1: @@
-====== 17.02. Setting up mSupply mobile ======
+====== 22.02. mSupply Mobile technical instructions for setup ======
-<WRAP center round tip 60%>
+{{  :mobile:pasted:20191203-052654.png?nolink |}}
-Note - we will complete these steps for you.  The following instructions are for your information only.
-</WRAP>
-==== Requirements ====
+**The mSupply Mobile information has now been moved to the open source project website here: [[https://docs.msupply.foundation/mobile/introduction/introduction/|https://docs.msupply.foundation]]**
-  * A server running mSupply with a web server license registered
-  * Sync server has a static IP and any network permissions required configured
-  * A mobile tablet fitting the recommended specifications [[https://msupply.org.nz/mobile/|here]]
-==== Adding a store ====
-On mSupply desktop go to Special > Stores > New Store
-{{ :mobile:mob2_001.jpg?600 |}}
-{{ :mobile:newstore.jpg |}}
-Enter the Store Code and Store Name
-{{ :mobile:mob2_002.jpg |}}
-Click on the Master List tab and select a Master List
-{{ :mobile:mob2_003.jpg |}}
-Click OK
-Click OK again
-==== User Access ====
-Next you need to make the current user have access to the store you have just set up.
-Go to Admin > Edit Users
-{{ :mobile:mob2_004.jpg?600 |}}
-Select the user and go to Login Rights.
-{{ :mobile:mob2_005.jpg?600 |}}
-Select the new Store
-==== Logging in to the Store ====
-Now, you need to log in to the new Store
-Go to File > Switch (or ‘cmd 2’ (apple) or ‘ctrl 2’ (windows))
-{{ :mobile:mob2_006.jpg |}}
-Log in
-==== Setting up a Sync Site ====
-Got to Admin > Preferences
-{{ :mobile:mob2_007.jpg?600 |}}
-On the Synchronise tab on the left-hand side and click on the unlock button and enter the password
-{{ :mobile:mob2_008.jpg?600 |}}
-Add new Sync Site
-{{:mobile:mob2_009.jpg|}}
-Enter ID, Username and Password and click OK
-<WRAP center round tip 60%>
-Note - Keep track of these details, if they are lost you'll have to resynchronise from scratch! Sussol will typically have them securely stored if Sussol has done the sync setup.
-</WRAP>
-{{ :mobile:mob2_010.jpg |}}
-Log in to the Store
-Go to Special > Stores
-{{ :mobile:mob2_001.jpg?600 |}}
-Double-click the Store
-Click the unlock button and enter password
-Set Synchronisation type to active store
-Select store (as local)
-{{ :mobile:mob2_011.jpg?600 |}}
-Click OK
-Click the unlock button and enter password again
-Set Sync type to Collector and sync type to Active/Collector
-Click OK
-Click OK again
-Start the web server
-==== Initialising mSupply Mobile on Device ====
-After installing the app, you must do an initialisation of the data for the store the tablet is going to be used in. All above steps must be complete for this to work. The first screen upon opening the app looks as follows:
-{{ :mobile:first_screen.png?nolink&800 |}}
-You must enter:
-  - The correct URL for your mSupply server, usually using SSL/HTTPS protocol for security.
-  - Sync site name as defined above in this guide.
-  - Password for the sync site name
-{{ :mobile:explanation.png?nolink&600 |}}
-Once you have entered the information, click "Connect" to start sync:
-{{ :mobile:initialising.png?nolink&600 |}}
-Initialisation can take between 1 and 15 minutes, depending on the number of records on the server related to the site being synced. Once the server has found all the records to sync, mSupply Mobile will start pulling them adaptively between 20 and 500 records at a time depending on the connection speed. If connection is lost or you closed the app, you can resume sync where it stopped by entering the exact same details (will go back to square one if you get it wrong).
-{{ :mobile:pulling.png?nolink&600 |}}
-Once complete, you will be taken to the login screen. For guidance beyond here see the [[https://docs.msupply.org.nz/mobile:user_guide2#ok_here_we_go|mobile usage guide]].
-<WRAP center round tip 60%>
-Note that the login details here are for the **mSupply user** that can login into the synchronised store, not the store details that were entered for sync above.
-</WRAP>
-{{ :mobile:mobile_login.png?nolink&600 }}
-=== Limiting Initial Sync Record Count ===
-If the amount of records to sync are greater than around 50,000 it may take over an hour to sync on a //good// connection. Many hours on a slow connection. For this reason it is possible in mSupply to limit the amount of records up to a specified amount of months ago.
-{{ :mobile:msupply_sync_months.png?nolink&600 |}}
-  - You need to change the store synchronisation type from "collector" to "active" or "none" to unlock adding custom data
-  - Add a custom data row with "Field label" `syncMonths` and the numeric value desired in "Field value"
-  - Change the store synchronisation type back to collector
-Now when you do initial sync, the store will only get transactions and stock takes for as far back as specified from the current date.\\
 \\
-|  //  Previous:  **[[archived:mobile:user_guide2|17.01. mSupply mobile 2.0 user guide]]** | | Next: **[[archived:mobile:mobiledemo|17.03. mSupply Mobile Demo]]]** //  |
+\\
+|  //  Previous:  **[[mobile:user_guide2]]** | | Next: **[[mobile:msupply_configuration]]** //  |
 ---- struct data ----
+pagestatus.status    :
 ----