-
Notifications
You must be signed in to change notification settings - Fork 16
Test: Synchronisation, Settings & Help Pages
Maria Khaydar edited this page Jan 27, 2025
·
1 revision
- For Desktop, just install and run! There should be no crash.
- For Android (apk), install the app - it should run after installation. You should see welcome screen with choices of 'Client' or 'Server'.
- Choose 'Server' as this is our setup for testing :)
- Enter something random as the URL, for example 'abcd', random site name and random password and press Enter. Get 'Invalid URL' error.
- Enter valid URL and press Enter -> get 'Site name not found' error.
- Enter a valid site name -> get 'Incorrect password' error.
- Enter valid password. Starts initialising!
- You now see the login screen. Enter your user details and log into the store.
- After login there are usually 1 or 2 pending logs to sync. These should show on the sync icon badge at the bottom left of navigation drawer.
- Badge shows correctly whether or not the drawer is expanded to full width.
- When the Sync icon is pressed, a modal appears.
- When pressing the 'Sync now' button, the 'Number of records to push' should go down to 0, 'Last Sync' and 'User last updated' should be updated to the current time, and Push should move to Pull Central, then Pull Remote, then Integrate. If you are on Remote Site, then it should be
Push V6 -> Push -> Pull Central -> Pull Remote -> Pull V6 -> Integrate. - The modal can be closed with the
xin the corner - Create an outbound shipment with 1 line. The badge on "Sync" should update promptly.
- On Primary Server make a new master list and add 3 items -> sync Open mSupply -> you should get "Pull Central" 4/4. (Should be at least 4, don't be concerned if something extra snuck, but not 50 extra).
- On Primary make a Customer Invoice with 3 lines to the OMS store. Should get "Pull remote" 4/4, and "Number of records to push" up to 4-5. This for the transfer/inbound shipment made on OMS needing to be sent back to the central server on the next sync cycle.
- Get an idea in your head of what data you had, perhaps from all your testing above
- Clear app data and restart app
- Reinitialise the app -> you will have to go through the steps above to successfully initialise the site and login again.
- All your data from previous testing should still be there.
- Set up a remote site in previous Open mSupply version. Login and sync -> everything should be working.
- Now get the latest release version for Open mSupply (usually Vx.x.x-RC5 or something similar).
- Upgrade your setup and log into your store.
- Logins should be smooth. No errors after the version upgrade.
- All the previous data from your testing should still be there. Sync a few times to make sure you don't get sync errors.
- Toggle the Custom Theme on -> a text box should appear where you can enter custom code. Save button should be enabled.
- Toggle the Custom Logo on -> an empty text box should appear where you can enter a link. Save button should be enabled. Hovering over the ⓘ symbol next to 'Custom Logo' will show a text box explaining the necessary format to upload the picture. Note that on omSupply mobile, you need to press the ⓘ symbol for a few seconds for the information to appear.
- Central Server URL text field should be editable.
- Site name text field should be editable.
- Site password text field should be editable. Clicking the eye icon will either hide or show your password.
- Interval seconds text field should be editable.
- For the time being, none of the changes can be saved unless the password is entered. If the password is not entered, the Save button is greyed out and not clickable.
- You can click the 'View' button next to Server Log -> a window will appear, where you can choose a log file. Depending on how big the log file is, it can be split into multiple ones -> omsupply.log will always have the most up-to-date information. You should be able to click on the dropdown field to choose a log file.
- Clicking 'Save' will download the file.
- Clicking 'Copy to Clipboard' will copy the file's contents to clipboard
- Clicking 'OK' will close the window.
- Download button next to 'Download Database' should be enabled -> clicking the button will download the Database file.
- In the top right corner, omSupply version number should be displayed, alongside the Site's name, the server being used and a QR code.
- You should be able to click on the QR Code to enlarge it -> this is for an easier integration with Cold Chain, where you can scan the barcode with a camera.
- You can toggle the Mode between Client and Server. If you are on a Server setting, switching to Client will log you out and present you with the initial setup screen. There, you can select Available Servers -> select your home one. After that, you will need to log into omSupply. When using Client mode, you are unable to download the Database. The rest of the settings should look the same.
- If you are on a Client setting, switching to Server will not log you out, and you can continue testing as per normal.
- You can click the 'View' button next to Server Log -> a window will appear, where you can choose a log file. At the moment, there is no functionality to close the window, so you will have to use Android's back button to navigate out of this area.
- Download button next to 'Download Database' should be enabled -> clicking the button will download the Database file.
- In the top right corner, omSupply version number should be displayed, alongside the Site's name, the server being used and a QR code.
- You should be able to click on the QR Code to enlarge it -> this is for an easier integration with Cold Chain, where you can scan the barcode with a camera.
- IP Address field should be editable. To test, enter the IP address of the label printer you are using - for example, in the NZ office, you can enter 192.168.178.69
- Port number field should be editable
- Label height field should be editable
- Label width field should be editable
- Click 'Save' to save the changes. You can then click the 'Test' button to print out a test label. If the test is successful, you will get a short message in the bottom left corner, saying the test/connection is successful.
- You can toggle the Scanner Type between USB Serial and USB Keyboard. If USB Serial mode is selected, you will see an option to Detect one, and connect one to omSupply. The 'Detect' button should be clickable, and a barcode should be visible for your scanner to scan.
- Note that if your Client is located on a cloud, and not locally, the barcode scanner will not be recognised - you can only connect it if both client and the barcode scanner connect locally.
- If 'USB Keyboard' option is toggled, the option to detect a barcode scanner disappears.
- Initialise store properties for GAPS button should be clickable. Once clicked, it will be greyed out.
- Edit button next to your store's name at the bottom should appear, allowing the user to enter the necessary GAPS details.
- Clicking on 'User Guide' should bring up a new window, where omSupply documentation is available for reading.
- There is a 'Contact Us' form
- OMS Central MUST be running on desktop - email sending is not supported on Android
- Install MailHog: https://kinsta.com/blog/mailhog/
- Then, start MailHog by running mailhog in the command line.
- Plus these settings in your local.yaml configuration file
mail: host: "localhost" port: "1025" starttls: false username: "" password: "" from: "[email protected]" interval: 10
- The 'Send' button is disabled if:
- The email address is empty
- The email address is not valid (see a helper message appear)
- The body is empty
- The Request option has not be chosen
- If all fields have valid data, the send button is enabled
- Click 'Send', see that the fields are cleared and a success snack pops up
- Sync to OMS Central
- Run a manual sync on OMS central
- Wait up to 10 seconds (or whatever interval you put in local.yaml)
- Check MailHog (http://localhost:8025/) - you should have received an email with the contents of your contact form
- Test for both feedback and support request - ensure email mentions the correct contact type
- Clicking on your username should open a popup
- The heading is the user's name, the username and email are displayed beneath
- A 'Logout' button is displayed at the bottom of the popup
- Clicking the 'X' on the top right of the popup will close the popup
- Clicking 'Logout' will show a confirmation modal confirming if you wish to logout. Clicking 'OK' here will take you to the login screen, where you can enter login details.
- Click on the language to select a new language -> click between each Language to ensure the translations are displaying properly and the layout of the page stays the same (with the exception of Arabic).