You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/migrate/qfield/index.md
+26-31Lines changed: 26 additions & 31 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,21 +3,20 @@
3
3
4
4
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.
5
5
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 <QGISlink="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 <QGISlink="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.
8
7
9
8
## QField and Mergin Maps ecosystems
10
9
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:
| 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 |
17
16
| QFieldCloud SDK and CLI | <GitHubRepoid="MerginMaps/python-api-client"desc="Python client" /> | Interaction with REST API via Python or console |
18
17
19
18
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.
21
20
22
21
On top of <GitHubRepoid="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/).
23
22
@@ -26,7 +25,7 @@ You can also [customise](../../dev/customapp/) <MobileAppName /> and deploy your
26
25
### Users, organisations, workspaces
27
26
There are some similarities and differences in how QField and <MainPlatformName /> manage their users and projects:
28
27
* 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)
30
29
**organisations* in QFieldCloud are similar to [*workspaces*](../../manage/workspaces/) in <MainPlatformName />
31
30
**project collaborators* in QFieldCloud are [*workspace members or guests*](../../manage/permissions/) that have access to a project in <MainPlatformName />
32
31
**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
40
39
41
40
We also recommend going through the [Get Started tutorial](../../tutorials/capturing-first-data/) to get familiar with <MainPlatformName />.
42
41
43
-
44
42
## Migrate QField project to Mergin Maps
45
43
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.
47
45
48
46
Therefore, if you open the project in QGIS on your desktop, you will be able to upload it to <MainPlatformName />.
49
47
50
48
51
-
### Transfer QField project to desktop
49
+
### Transfer QField project to the desktop
52
50
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.
53
51
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.
56
53
57
54
### Convert QField project to QGIS project
58
55
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.
59
56
60
57
1. Close QGIS
61
58
62
59
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).
65
62
66
63
:::tip
67
64
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.
68
65
:::
69
66
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.
71
68
72
69
For each layer, check its properties and verify that the sources do not point to any QFieldCloud databases.
73
70
74
71
Some layers in the project may appear unavailable. Make sure they were copied to the folder or fix their data source.
75
72
76
-
5. If you made changes, save the project and close QGIS.
73
+
5. If you made changes, save the project and close QGIS.
77
74
78
75
Then, reopen the project in QGIS again to make sure that the project loads correctly.
79
76
80
77
:::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.
82
79
:::
83
80
84
81
### 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)
86
83
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.
89
85
90
86
## Migrate QFieldCloud Settings
91
87
92
88
### Organisations and permissions
93
89
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 />.
95
91
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 />.
97
93
98
94
For a smooth transition, it is best to read about [working collaboratively](../../tutorials/working-collaboratively/index.md) in <MainPlatformName />.
99
95
@@ -110,31 +106,30 @@ While QFieldCloud has a per-seat model, the <MainPlatformName /> Team subscripti
110
106
## Known differences between QField and Mergin Maps platforms
111
107
Here are some key differences between QField and <MainPlatformName />.
112
108
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.
115
111
116
112
- synchronisation in <MainPlatformName /> is conceptually based on ideas from Git. <GitHubRepoid="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.
118
114
119
115
Here is a non-definitive list of other known differences:
120
116
121
117
* 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.
123
119
* There is no concept of *secrets* in <MainPlatformName />. For `pg_service` configuration, you need to transfer it manually as described [here](../../gis/supported_formats/).
124
120
* 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.
126
122
* QField is built around *modes*. There is not such concept in <MainPlatformName />
127
123
* You can use the [*preview panel*](../../tutorials/further-project-customisation/#customising-the-preview-panel) in <MobileAppName />
128
124
129
125
If there is a feature missing in the <MobileAppName />, check our <WishListLink />.
130
126
131
-
132
127
## 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!
134
129
135
-
Book a short video call with our <MerginMapsEmailid="sales"desc="sales team" /> or write your questions to our <MerginMapsEmailid="support"desc="support team" />. You can also chat with our open-source community.
130
+
Book a short video call with our <MerginMapsEmailid="sales"desc="sales team" /> or write your technical questions to our <MerginMapsEmailid="support"desc="support team" />. You can also chat with our open-source community.
136
131
137
132
<CommunityJoin />
138
133
139
-
If you are looking for professional partner to migrate your workflow, you can ask our <MainDomainNameLinkid="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 <MainDomainNameLinkid="partners"desc="partners"/> network or <LutraConsultingWeb />, the developers of <MainPlatformName />
0 commit comments