TC 02: Configuration

[jozef-budac]

Goals

Ensure user can connect to public or different mergin servers, test connection and save credentials in QGIS

Prerequisites

• GQIS in latest stable version
• installed mergin plugin
• created user account (USER1) on public and developer mergin servers

---

Test A - connection window

A1: right click on the mergin plugin in Browser panel in QGIS. There is only one option Configure. Hit it

A2: New Mergin Settings window appears:

Check if there are all fields and other elements according to the screenshot (login, password, 2 checkboxes, button for testing connection, link to sign-in page)

---

Test B - wrong credentials test

B1: open configuration of mergin. insert this credentials to login and password:

• username: nonexistinguser
• password: randompassword

Hit Test connection. You should get Connection failed, invalid username and password notification

B2: hit OK. In Browser panel there should be this notification:

---

Test C - correct credentials

C1: open mergin settings and insert correct credentials for USER1 and press test connection. You should get OK notification.

C2: press OK. In Browser panel there should be tree with My projects, Shared with me and Explore

C3: check if the lists of projects (own and shared) correspond with the lists on mergin server.

---

Test D - Save credentials

TODO

---

Test E - custom mergin server

E1: open mergin settings and click on Custom Mergin Server. Use the developer mergin server. Test the connection. You should get OK notification.

E2: Hit OK and again same tree as in C2 should be visible.

---

Test F - selective sync

Note: Feature added in 2021.5.1 version

F1: In QGIS open any project and go to Project -> Properties.

F2: There should be new tab 'Mergin':

F3: enable Enable selective sync for Input option. Synchronize the project.

F4: in mergin portal, there should be file 'mergin-config.json` which contains this line:

{"input-selective-sync":true,"input-selective-sync-dir":""}

F5: disable Enable selective sync for Input option. Synchronize the project.

F6: in mergin portal, 'mergin-config.json` files contains

{"input-selective-sync":false,"input-selective-sync-dir":""}

F7: add two directories to the project: photos_a and photos_b. Put one photo to each of them.

F8: enable Enable selective sync for Input option. Only apply to folder set of photos_a folder. Synchronize the project.

F8: in mergin portal, there should be file 'mergin-config.json` which contains this line:

{"input-selective-sync":true,"input-selective-sync-dir":"photos_a"}

F9: check project on mergin contains both directories with pictures

F10: Change Only apply to folder to photos_b folder. Synchronize the project.

F11: in mergin portal, there should be file 'mergin-config.json` which contains this line:

{"input-selective-sync":true,"input-selective-sync-dir":"photos_b"}