Skip to content

Commit 1fa557f

Browse files
committed
fix review comments
1 parent 113c1af commit 1fa557f

File tree

1 file changed

+26
-31
lines changed

1 file changed

+26
-31
lines changed

src/migrate/qfield/index.md

Lines changed: 26 additions & 31 deletions
Original file line numberDiff line numberDiff line change
@@ -3,21 +3,20 @@
33

44
This guide is intended for current QField and QFieldCloud users considering switching to <MainPlatformName /> as well as for <MainPlatformName /> users looking to transfer their data from QField ecosystem.
55

6-
Mergin Maps is the closest alternative to QField Ecosystem. Both QField and <MainPlatformName /> are open-source projects powered by QGIS. Their respective mobile apps are both officially recommended for QGIS projects by <QGIS link="en/site/forusers/download.html" text="QGIS.org" />. Both platforms support almost the same set of [supported formats](../../gis/supported_formats/) via QGIS data providers and GDAL. Moreover, the mobile apps are based on the same open-source GIS stack and technology. As such their projects are almost fully interoperable.
7-
6+
Mergin Maps is the closest alternative to QField Ecosystem. Both QField and <MainPlatformName /> are open-source projects powered by QGIS. Their respective mobile apps are both officially recommended for QGIS projects by <QGIS link="en/site/forusers/download.html" text="QGIS.org" />. Both platforms support almost the same set of [supported formats](../../gis/supported_formats/) via QGIS data providers and GDAL. Moreover, the mobile apps are based on the same open-source GIS stack and technology. As such their projects are almost fully interoperable.
87

98
## QField and Mergin Maps ecosystems
109
The QField ecosystem consists of QField (mobile application), QFieldCloud (geo data collaboration server), QFieldSync (QGIS plugin) and QFieldCloud SDK (Python API client). Let's see the tools from <MainPlatformName /> that are counterparts:
1110

1211
| QField Ecosystem | <MainPlatformName /> | Note |
1312
|---|---|---|
14-
| QField | <MobileAppName /> | Mobile application powered by QGIS |
15-
| QFieldCloud | <MainPlatformName /> | Server for sharing geo-data |
16-
| QFieldSync | <QGISPluginName /> | QGIS Plugin for sync and manipulation of projects |
13+
| QField | <MobileAppName /> | Mobile application powered by QGIS |
14+
| QFieldCloud | <MainPlatformName /> | Web application (server) for sharing geo-data |
15+
| QFieldSync | <QGISPluginName /> | QGIS Plugin for sync and manipulation of projects |
1716
| QFieldCloud SDK and CLI | <GitHubRepo id="MerginMaps/python-api-client" desc="Python client" /> | Interaction with REST API via Python or console |
1817

1918

20-
QFieldCloud is based on PostgreSQL and PostGIS database and there might be direct connection to these. <MainPlatformName /> is fully based on a file-based system, so it is not possible to connect directly to a PostGIS database. However, you can use the [DB Sync](../../dev/dbsync/) tool to map your <MainPlatformName /> project to a PostGIS database schema.
19+
QFieldCloud is based on PostgreSQL and PostGIS database and there might be direct connection to these. <MainPlatformName /> is fully based on a file-based system, so it is not possible to connect directly to a PostGIS database. However, you can use the [DB Sync](../../dev/dbsync/) tool to map your <MainPlatformName /> project to a PostGIS database schema or vice versa.
2120

2221
On top of <GitHubRepo id="MerginMaps/python-api-client" desc="Python client" />, <MainPlatformName /> offers also other developer tools to manage projects for larger teams, such as [Media Sync](../../dev/media-sync/) and [Work Packages](../../dev/work-packages/).
2322

@@ -26,7 +25,7 @@ You can also [customise](../../dev/customapp/) <MobileAppName /> and deploy your
2625
### Users, organisations, workspaces
2726
There are some similarities and differences in how QField and <MainPlatformName /> manage their users and projects:
2827
* a *user* is a key management unit in both platforms. Each user needs to [have an account](../../setup/sign-up-to-mergin-maps/).
29-
* a [*project*](../../manage/project/) is a basically the same concept in both platforms (a `.qgz` file with associated files)
28+
* a [*project*](../../manage/project/) is basically the same concept in both platforms (a `.qgz` file with associated files)
3029
* *organisations* in QFieldCloud are similar to [*workspaces*](../../manage/workspaces/) in <MainPlatformName />
3130
* *project collaborators* in QFieldCloud are [*workspace members or guests*](../../manage/permissions/) that have access to a project in <MainPlatformName />
3231
* *organisation members* in QFieldCloud are [*workspace members*](../../manage/permissions/) in <MainPlatformName />
@@ -40,60 +39,57 @@ Before the start of migration, you need to have a <MainPlatformName /> account a
4039

4140
We also recommend going through the [Get Started tutorial](../../tutorials/capturing-first-data/) to get familiar with <MainPlatformName />.
4241

43-
4442
## Migrate QField project to Mergin Maps
4543

46-
Both platforms are using QGIS Projects (`.qgz` files) and associated online or offline geo-data sources.
44+
Both platforms are using QGIS Projects (`.qgz` files) and associated online or offline geo-data sources.
4745

4846
Therefore, if you open the project in QGIS on your desktop, you will be able to upload it to <MainPlatformName />.
4947

5048

51-
### Transfer QField project to desktop
49+
### Transfer QField project to the desktop
5250
If you use a USB cable for synchronisation of your data, use your common workflow to transfer the project to your computer, e.g. by using the **Send compressed folder to** option in QField to send the compressed project to your email.
5351

54-
If you use QFieldCloud, use QFieldSync to synchronise the latest changes.
55-
52+
If you use QFieldCloud, use QFieldSync to synchronise the latest changes.
5653

5754
### Convert QField project to QGIS project
5855
Now that you have your QField project on your computer, you need to convert it to a regular QGIS project. <MainPlatformName /> doesn't use offline editing, nor connections to QFieldCloud PostGIS databases, so we need to remove those.
5956

6057
1. Close QGIS
6158

6259
2. Find the project folder location on your computer (e.g. `C:\GIS\QField_MyProject`) and create a copy in a new location (e.g. `C:\GIS\MyProject`)
63-
- this folder should contain a single QGIS project file (`.qgz` or `.qgs`), local data files (such as GeoPackages `.GPKG`, Shapefiles `.SHP` or rasters) and other necessary files (such as photos `.jpg` or `.png`).
64-
- remove all hidden files and all files that are not strictly required by a regular plain QGIS project (such as QField configuration files or backups of the layers or offline synchronisation logs).
60+
- this folder should contain a single QGIS project file (`.qgz` or `.qgs`), local data files (such as GeoPackages `.GPKG`, Shapefiles `.SHP` or rasters) and other necessary files (such as photos `.jpg` or `.png`).
61+
- remove all hidden files and all files that are not strictly required by a regular plain QGIS project (such as QField configuration files, backups of the layers or offline synchronisation logs).
6562

6663
:::tip
6764
Depending on your project, it might be easier to just copy the QGIS project file (`.qgz` or `.qgs`) and other required data sources to the new folder one by one.
6865
:::
6966

70-
4. Open the project from the **new** folder (e.g. `C:\GIS\MyProject`) in QGIS.
67+
4. Open the project from the **new** folder (e.g. `C:\GIS\MyProject`) in QGIS.
7168

7269
For each layer, check its properties and verify that the sources do not point to any QFieldCloud databases.
7370

7471
Some layers in the project may appear unavailable. Make sure they were copied to the folder or fix their data source.
7572

76-
5. If you made changes, save the project and close QGIS.
73+
5. If you made changes, save the project and close QGIS.
7774

7875
Then, reopen the project in QGIS again to make sure that the project loads correctly.
7976

8077
:::tip
81-
There are some <MainPlatformName /> specific settings that can be set up in the project, such as selective sync, default photo quality or custom photo names. Go to [QGIS Project Preparation](../../gis/features/) for inspiration.
78+
Some <MainPlatformName /> specific settings can be set up in the project, such as selective sync, default photo quality or custom photo names. Go to [QGIS Project Preparation](../../gis/features/) for inspiration.
8279
:::
8380

8481
### Upload QGIS project to Mergin Maps
85-
1. Use <QGISPluginName /> to package and upload project to <MainPlatformName /> as explained [here](../../manage/project/#packaging-qgis-project)
82+
1. Use <QGISPluginName /> to package and upload the project to <MainPlatformName /> as explained [here](../../manage/project/#packaging-qgis-project)
8683
2. Log in to <AppDomainNameLink /> to see that the project was successfully uploaded to the cloud
87-
3. Open the project on <MobileAppName /> and check if you your project as expected
88-
84+
3. Open the project on <MobileAppName /> and check your project, especially feature forms and all the layers.
8985

9086
## Migrate QFieldCloud Settings
9187

9288
### Organisations and permissions
9389

94-
There is no automatic tool to extract your QFieldCloud organisations and users and migrate them to <MainPlatformName />.
90+
There is no automatic tool to extract your QFieldCloud organisations and users and migrate them to <MainPlatformName />.
9591

96-
Therefore, you will have to manually set up workspaces (if needed) and assign appropriate [permissions](../../manage/permissions/) to your team members in <MainPlatformName />.
92+
Therefore, you will have to manually set up workspaces (if needed) and assign appropriate [permissions](../../manage/permissions/) to your team members in <MainPlatformName />.
9793

9894
For a smooth transition, it is best to read about [working collaboratively](../../tutorials/working-collaboratively/index.md) in <MainPlatformName />.
9995

@@ -110,31 +106,30 @@ While QFieldCloud has a per-seat model, the <MainPlatformName /> Team subscripti
110106
## Known differences between QField and Mergin Maps platforms
111107
Here are some key differences between QField and <MainPlatformName />.
112108

113-
- <MobileAppName /> is fully devoted to providing a no-training mobile application, operated even for surveyors without any prior GIS knowledge. QField is more focused on advanced GIS users and its interface more resembles full GIS applications like QGIS.
114-
Therefore <MobileAppName /> is more intuitive for non-technical users.
109+
- <MobileAppName /> is fully devoted to providing a no-training mobile application, operated even for users without any prior GIS knowledge. QField interface and workflows for various tools more resembles complex GIS applications like QGIS.
110+
Therefore <MobileAppName /> is more intuitive for non-technical users, still keeping all tools for advanced workflows.
115111

116112
- synchronisation in <MainPlatformName /> is conceptually based on ideas from Git. <GitHubRepo id="MerginMaps/geodiff" desc="Geodiff" /> creates difference files from GeoPackages that are sent over the network and applied. QFieldCloud synchronisation uses a concept of storage of differences made in SQL format and this difference log is then transmitted and applied.
117-
In <MainPlatformName />, synchronisation is an inherent part of the platform. As such, it is already set up for end-users in a smart way and there are no extra steps needed for mobile users.
113+
In <MainPlatformName />, synchronisation is an inherent part of the platform. As such, it is already set up for end-users in a smart way and there are no extra steps needed for mobile users. All synchronisation on mobile devices is done by hitting a single button.
118114

119115
Here is a non-definitive list of other known differences:
120116

121117
* QField mobile app can work without QFieldCloud (server) via USB transfer of the projects. This is not available in <MainPlatformName />, but you can [manually download](../../manage/missing-data/) your data or [upload large files](../../gis/settingup_background_map/#how-to-work-with-very-large-files-android) to your mobile device if needed.
122-
* *Organisation teams* in QFieldCloud do not have any equivalent concept in <MainPlatformName />
118+
* *Organisation teams* in QFieldCloud do not have any equivalent concept in <MainPlatformName />. On <MainPlatformName /> can have different workspaces for different teams.
123119
* There is no concept of *secrets* in <MainPlatformName />. For `pg_service` configuration, you need to transfer it manually as described [here](../../gis/supported_formats/).
124120
* There is no concept of *managing ongoing jobs* or *triggers* in <MainPlatformName /> accessible for users. Users see the results when jobs are finished (e.g. map rendering).
125-
* It is not possible to connect directly to a user accessible databases in <MainPlatformName />. Use [DB Sync](../../dev/dbsync/) to map your <MainPlatformName /> to PostGIS database schema.
121+
* It is not possible to connect directly to user accessible databases in <MainPlatformName />. Use [DB Sync](../../dev/dbsync/) to map your <MainPlatformName /> to PostGIS database schema.
126122
* QField is built around *modes*. There is not such concept in <MainPlatformName />
127123
* You can use the [*preview panel*](../../tutorials/further-project-customisation/#customising-the-preview-panel) in <MobileAppName />
128124

129125
If there is a feature missing in the <MobileAppName />, check our <WishListLink />.
130126

131-
132127
## Troubleshoot
133-
Struggling to migrate your projects? We are happy to help you!
128+
Struggling to migrate your projects? We are happy to help you!
134129

135-
Book a short video call with our <MerginMapsEmail id="sales" desc="sales team" /> or write your questions to our <MerginMapsEmail id="support" desc="support team" />. You can also chat with our open-source community.
130+
Book a short video call with our <MerginMapsEmail id="sales" desc="sales team" /> or write your technical questions to our <MerginMapsEmail id="support" desc="support team" />. You can also chat with our open-source community.
136131

137132
<CommunityJoin />
138133

139-
If you are looking for professional partner to migrate your workflow, you can ask our <MainDomainNameLink id="partners" desc="partners"/> network or Lutra Consulting Ltd., the developers of <MainPlatformName />
134+
If you are looking for a professional partner to migrate your workflow, you can ask our <MainDomainNameLink id="partners" desc="partners"/> network or <LutraConsultingWeb />, the developers of <MainPlatformName />
140135
<PublicImage src="logo_lutra.svg" title="Lutra Consulting Ltd. logo" style="width:50%" />

0 commit comments

Comments
 (0)