Samenwerken op een survey project

Site: OpenCourseWare for GIS
Cursus: Velddatacollectie met Input, Mergin en QGIS
Boek: Samenwerken op een survey project
Afgedrukt door: Guest user
Datum: vrijdag, 26 april 2024, 09:55

1. Introductie

In de vorige tutorials hebben we een survey project gemaakt voor het karteren van putten en leidingen.

In de praktijk zal je de velddatacollectie vaak met een team doen. In deze tutorial leer je hoe je een project met collega's kan delen en hoe Mergin omgaat met versiebeheer.

Na deze tutorial kan je:

  • Projecten delen met een specifieke gebruiker
  • Projecten delen met veel gebruikers
  • De projectgeschiedenis bekijken en versies beheren

2. Een survey project delen met een andere gebruiker

We gaan het grondwater survey project delen met een andere gebruiker.

  1. Ga in een webbrowser naar cloudmergin.com.

  2. Klik op Sign in recht boven op de webpagina:
    Sign in mergin

  3. Gebruik je gebruikersnaam en wachtwoord om in te loggen.

    Na het inloggen kan je het dashboard zien:


  4. Klik op My projects in de grijze balk aan de linkerkant en klik vervolgens op grondwater:


  5. Klik op SETTINGS:


  6. Onder Invite collaborators kan je de gebruikersnaam invullen van de persoon met wie je op dit project wilt samenwerken:


    In dit voorbeeld zal ik mijn collega Charlie uitnodigen met de gebruikersnaam CharlieColleague:


    Waarschuwing: Het wordt aangeraden om altijd te controleren met de persoon met wie je wilt samenwerken wat de gebruikersnaam is. Er is anders een risico dat de verkeerde persoon toegang krijgt.

  7. Klik op Add na het selecteren van de gebruikersnaam:


    Je kan de toegevoegde gebruiker nu zien in de lijst van gebruikers met toegang:


  8. Als de gebruiker schrijfrechten moet hebben, kan je dat onder Permissions aanpassen naar writer.
Charlie zou nu toegang to het project moeten hebben. Dit betekent dat hij het project kan vinden onder de Shared with me tab, zowel in de Input app als in QGIS.

3. Een survey project delen met veel gebruikers

Als je een survey project met een grote groep gebruikers wilt delen is er een makkelijkere methode dan gebruikers individueel toe te voegen zoals we in het vorige hoofdstuk hebben gedaan.

De volgende stappen moeten uitgevoerd worden in het Mergin dashboard dat we ook in het vorige hoofdstuk hebben gebruikt.

  1. Klik op My projects en vervolgens op grondwater:


  2. Klik in de locatiebalk van de browser:


  3. Kopieer de URL.

  4. Verzend de link per e-mail aan de gebruikers die je wilt toevoegen aan dit project.

    Als de ontvanger op de link klikt zal worden gevraagd om in te loggen of een account te maken bij Mergin. Eenmaal ingelogd krijgen ze het volgende te zien:


    Ze moeten op Request Access klikken om toegang te vragen.

  5. Je kan de aanvragen voor toegang tot je project zien in je dashboard, zoals in onderstaand voorbeeld:
    Access requests

  6. Accepteer of weiger de verzoeken hier.
Waarschuwing: Het wordt aangeraden om de gebruikersnaam van de aanvrager te controleren voordat toegang wordt gegeven.

In het volgende hoofdstuk kijken we naar de geschiedenis en versiebeheer van het project.

4. Projectbeheer

De Mergin cloud service houdt bij welke veranderingen in het survey project worden gemaakt door verschillende gebruikers, computers en mobiele toestellen.

Ieder keer als je veranderingen in het project synchroniseert met de Mergin cloud, zal Mergin de inhoud van GeoPackage lagen vergelijken en samenvoegen, terwijl andere data, zoals foto's, rasters en shapefiles worden gekopieerd. Daarom wordt het aangeraden om het GeoPackage formaat te gebruiken voor de survey lagen.

Let op dat het synchroniseren van data en projecten twee kanten op werkt. Mergin maakt hiervoor gebruik van de Geodiff bibliotheek. Meer details kan je hier vinden.

In de volgende secties gaan we in op de projecthistorie, versiebeheer en het oplossen van problemen met synchronisatie.

4.1. Projectgeschiedenis en versiebeheer

De projectgeschiedenis kan je bekijken in het Mergin dashboard.

1. Ga naar My projects en kies grondwater.

2. Ga naar de HISTORY tab boven de projectbestanden:


Hier kan je de volledige projecthistorie bekijken:

  • Version: versienummer van het project op basis van aantal synchronisaties
  • Created: tijdstip waarop de versie is gemaakt
  • Auteur: Gebruikersnaam van de gebruiker die de versie heeft gemaakt
  • De volgende drie kolommen: respectievelijk aantal toegevoegde, verwijderde en bijgewerkte bestanden
  • Size: omvang van het project
  • Door op het pijltje in de laatste kolom te klikken kan je die versie van het project downloaden


3. Klik op een versienummer om uitgebreidere informatie over de veranderingen in die versie te tonen:

Je kan hier naast het versienummer en de gebruiker ook het volgende zien:
    • De exacte tijd waarop deze versie is gemaakt
    • User Agent laat zien welk toestel, bestuuringssysteem en welke tool gebruikt is voor deze versie van het project
    • Als je het GeoPackage formaat voor de survey lagen gebruikt, dan kan je hier ook een samenvatting zien van toegevoegde, verwijderde of gewijzigde objecten voor elke tabel (kaartlaag).
4. Klik op Show Advanced om meer details over de objecten zichtbaar te maken:

Bovenstaand voorbeeld laat zien dat we onze eerste veldwaarneming voor de putten laag hebben toegevoegd.

In de volgende sectie gaan we in op synchronisatieproblemen.

4.2. Synchronisatieproblemen oplossen

Er kunnen synchronisatieproblemen optreden wanneer twee gebruikers enkele bestanden in een gedeeld project tegelijk bewerken. De technologie achter de Mergin-service probeert om wijzigingen van individuele gebruikers automatisch samen te voegen en daarom treden synchronisatieproblemen normaliter niet op, zelfs niet als meerdere mensen een enkele gegevensbron (bijvoorbeeld een GeoPackage) bewerken. Er zijn echter nog steeds gevallen waarin Mergin niet in staat is om automatisch synchronisatieproblemen op te lossen. In die gevallen zal Mergin conflictbestanden in de projecten creëren.

Allereerst is het belangrijk om deze situaties zoveel mogelijk te voorkomen.

Hier zijn enkele good practice aanwijzingen om problemen te voorkomen:

  • Gebruik altijd GeoPackage voor survey lagen. Als je andere formaten gebruikt, zoals ESRI-shapefile, kan Mergin geen wijzigingen van andere gebruikers detecteren en zal het bestand overschrijven. Overschreven bestanden worden opgeslagen in een conflictbestand.
  • Voeg wat extra back-up veldattributen toe bij het maken van een survey laag met verschillende typen (bijvoorbeeld een paar teksten, int, real, datum/tijd) en verberg ze in het formulierontwerp. Deze kunnen als back-up dienen: als je later in het veldformulier extra velden nodig hebt, maak dan een alias voor deze extra velden en voeg ze toe aan het formulier.
  • Als je een veld niet nodig hebt, verwijder het dan van het formulier. Je hoeft het niet uit de tabel te verwijderen.
  • Wijzig de alias van een veld in plaats van de naam van een veld te wijzigen.
  • Voeg nieuwe lagen toe aan je project als afzonderlijke GeoPackages. Voeg geen nieuwe tabel toe aan je bestaande GeoPackage met een survey laag. Voor de zekerheid is het beter om één GeoPackage te hebben voor elk van uw survey lagen.
  • Gebruik het GeoTIFF-formaat voor uw rasterbestanden of sla ze op in een aparte GeoPackage-database
Het is dus belangrijk om vooraf de survey lagen goed te ontwerpen voordat ze gebruikt worden. Veranderingen in het aantal attributen en data types kunnen problemen veroorzaken!

Er kunnen twee soorten synchronisatieproblemen zijn:
  • Problemen met edits
  • Conflicterende kopieën

Problemen met edits

Laten we als voorbeeld het grondwater project nemen, waarbij het veldwerk wordt uitgevoerd door Jan en Petra. Ze splitsen de taak in tweeën en gaan het veld in om de putten te observeren. Per ongeluk observeert Jan ook een put die aan Petra is toegewezen - ze bewerken allebei attributen van hetzelfde punt, met iets andere waarden. Hoe gaat Mergin daarmee om?

Als Jan de eerste is die zijn wijzigingen synchroniseert en Petra vervolgens haar wijzigingen synchroniseert, weet Mergin op het moment van Petra's synchronisatie dat er een conflict is in bewerkingen voor die ene put. De gebruiker die het laatst synchroniseert "wint", dus in dit geval zouden Petra's wijzigingen behouden blijven en Jan's wijzigingen worden overschreven (natuurlijk zouden al zijn niet-conflicterende bewerkingen voor de andere putten behouden blijven). Mergin houdt dit bij, voor het geval een projectbeheerder het bewerkingsconflict zou willen onderzoeken: als het probleem zich voordoet in putten.gpkg, dan zou een JSON-bestand met de naam putten (edit conflict, jan v123).json worden gemaakt, met daarin een lijst met conflicten. Voor elke conflicterende attribuutwaarde vermeldt het bestand de oorspronkelijke waarde en de twee verschillende gewijzigde versies.

Conflicterende kopieën

Mergin kan geen wijzigingen detecteren als je het gegevensschema wijzigt, zoals het verwijderen of toevoegen van attributen aan je survey laag of het wijzigen van het gegevenstype van een veld. Als je een laag probeert te synchroniseren met een gewijzigd gegevensschema, krijgt je een conflictbestand.
Hier kan je meer informatie vinden als het echt noodzakelijk is om het schema van een survey laag te veranderen.

4.3. Conclusie

In deze tutorial heb je geleerd hoe je een project met collega's kan delen en hoe Mergin omgaat met versiebeheer.

Nu kan je:

  • Projecten delen met een specifieke gebruiker
  • Projecten delen met veel gebruikers
  • De projectgeschiedenis bekijken en versies beheren
Voor meer informatie over Input en Mergin kan je de officiële documentatie van Lutra Consulting bekijken.

Er is ook een playlist op YouTube: