高级设置向导

支持矢量数据

Currently, QFieldCloud supports GeoPackage and PostGIS layers for collaborative editing. Other formats supported by QGIS should also work but are not officially supported.

使用地理包

使用地理包通常是简单设置的最佳选择，可将QField用户收集的数据集中到一个文件中。

If you would like to set up a relation, it is recommended to add a UUID field and to use that as the primary or foreign key.

Note

Do not use the default 'fid' field for relations (as primary or foreign key). It will lead to errors over time.

工作流程示例 (地理包)

桌面端筹备工作

1. 创建新工程。
2. Create GeoPackage layers, save it in the same folder than the QGIS project.
3. 在QField同步插件中将地理包设置为 "离线编辑" 。
4. 将工程上传到QFieldCloud。

QField界面

1. Sign in to QFieldCloud and download the project to your device.
2. Collect and edit some data and upload the changes.

Desktop

1. Using QFieldSync, download the updated files (the GeoPackage file should have changed).

Warning

This workflow does not support changing the GeoPackage on the desktop, as being file-based, the whole GeoPackage will be replaced. This means that data can only be digitized using QFieldCloud.

PostGIS

Using PostGIS layers is a good choice if your data should directly be editable for multiple users through QFieldCloud when they sync their work without any further steps.

It requires your database to be publicly accessible, and credentials must be saved unencrypted in the QGIS project. Please be aware of the security implications of such requirements, and remember to have backups.

工作流程示例 (PostGIS)

桌面端筹备工作

1. 创建新工程。
2. 创建并添加PostGIS图层，确保将网络凭证存储在工程中。
3. 确保PostGIS数据库连接可以公开访问 (公共IP或域名，不能与 127.0.0.1 或 localhost一起使用)。
4. 在QField同步工程设置中，如果QField用户在外业没有可靠的网络连接或无法 直接访问数据库 ，请将地理包设置为 离线编辑 。
5. 将工程上传到QField云。

QField界面

1. Signin to QFieldCloud and download the project.
2. 收集一些数据 (如果您使用 离线编辑 ，请将更改上传回办公室)。

Desktop

1. All changes should be directly visible inside the PostGIS database.

Note

When using direct database access, QFieldCloud will directly edit data in the PostGIS database. This will only work with a reliable internet connection in the field, but has the advantage that all data is directly visible to all users and allows to use any PostGIS specific setup (triggers, generated fields, etc).

Note

When using offline editing, QField will work on a local copy of the database in a GeoPackage, which will be synced by QFieldCloud to the original database once synchronized by the user. This is the best choice if the connection in the field is not reliable Changes will only be visible to users once the synchronization via QFieldCloud has been applied on the different devices. As a local copy is created, advanced PostGIS operations (like triggers) will not be available on QField. Just like for regular GeoPackages, if relationships are defined, it is recommended to use a UUID field instead of the fid as the primary key to avoid conflicts if multiple users create data at the same time.

您可以在 QFieldCloud技术参考 中找到更多信息。

Restriction of Project Files

To prevent any modification to the core QGIS project file, the project administrators can restrict the access to these files. This can be achieved under the settings section in QFieldCloud.

Restricted Files

When enabled, the following files can only be modified or uploaded by a user with an "admin" or "manager" role for the project:

• The primary QGIS project file (e.g., my_project.qgz).
• The attachments zip archive associated with the project (e.g., my_project_attachments.zip).
• QGIS auxiliary data files that store information like label positions (e.g., my_project.qgd).
• QField style files (.qml) that share the same name as the project file.

How to Enable Restriction

By enabling the Restrict project files, you activate this administrative control. Once set, only administrators and managers will be able to push changes to the files listed above. Other project collaborators can still upload and modify other project files, such as data in GeoPackages, but they cannot alter the main project file or its core components.

Automatic push to QFieldCloud

With this functionality, users and managers of QFieldCloud projects can enforce automatic pushing of pending changes to QField devices in the field, as well as specify the interval in between automated pushes. The functionality is activated through a project setting, allowing remote activation.

桌面端筹备工作

1. Access Project Settings: Navigate to the "QField" tab > "QFieldCloud Packaging" in the Project Settings dialog provided by the QFieldSync plugin.

2. Enable Auto-Push: Toggle the "Automatically push pending changes on the following interval" option and establish your preferred interval.

Auto push QFieldSync

Auto push QField

Note

Benefits:

• Real-Time Updates: Ensures prompt synchronization of field data with the QFieldCloud project.
• Streamlined Workflow: Minimizes manual intervention and ensures surveyors do not need to worry about synchronization, helping them focus on data quality.

Considerations:

• Network Stability: Ensure stable internet connectivity for auto-push functionality.
• Battery Optimization: Implement strategies to mitigate battery consumption on QField devices during prolonged fieldwork.

Create a project in an organization

如何在组织中创建工程：

选项 1: 直接将您的本地工程转换为组织的QFieldCloud工程:

1. Follow the steps configure your cloud project, until you get to the "Project details".

2. 将工程的所有者更改为您的组织。

   

3. Click on "Create" to start the conversion and synchronization. When finish you will see the project is in your Organization in QFieldCloud.

   

笔记

此功能需要 QField Sync 4.6 或更高版本

选项 2: 直接上传到组织:

1. 选择您的组织。

   

2. 进入组织后，单击 "创建工程" 。

   

3. 选择 "创建新的空工程" 。

   

4. 您可以在概览中看到新工程。

   

5. 在QGIS中的QFieldSync，您将看到列出的新工程，单击 "编辑选中的云工程" 。

   

6. 选择要保存工程的文件夹。

   

7. 在所选文件夹，可以粘贴已处理或保存新的工程。

   

8. 一旦文件夹包含工程，就可以对其进行同步。

   

9. 最后，将更改推送到云端。

   

10. 您可以验证这些文件是否存在于组织工程中。

    

选项 3: 将工程从您自己的帐户转移到组织:

1. If you already have a project in QFieldCloud (refer to configure your cloud project). In the project, click on "Settings" and select "Transfer ownership of this project" to choose the desired Organization for the transfer.

   

2. A pop-up window will appear to confirm the transfer. To proceed, you will need to type the requested text and click "Transfer project".

   

Activate email notifications for QFieldCloud changes

1. 访问您帐户的设置。

2. Navigate to the Notifications section. Here, you can customize the frequency of notifications you wish to receive at the email address registered with your account.

   您收到的通知包括: - 已创建的用户 - 已创建的组织 - 已删除的组织 - 已创建的组织成员 - 已删除的组织成员 - 已创建的团队 - 已删除的团队 - 已创建的团队成员 - 已删除的团队成员 - 已创建的工程 - 已删除的工程 - 已创建的工程成员 - 已删除的工程成员

You will receive notifications for events in which you are not the actor. These notifications are specifically for events that are initiated by other members of your organization or collaborators on your projects.

Enhance your project with the "Optimized Packager"

We recommend using the new "Optimized Packager" over the deprecated "QGIS Core Offline Editing" for all your projects. Set the packager under "Packaging Offliner" in the "Settings" tab of your project.

The "Optimized Packager" supports consolidating filtered layers of same datasource into a single offline layer, respecting distinct symbology but also using less storage. Here is an example to illustrate this feature:

Example Configuration:

• Layer 1.1:
• Data Source: layers.gpkg
• Table: layer1

• Filter: id % 2 = 1

• Layer 1.2:

• Data Source: layers.gpkg
• Table: layer1
• Filter: id % 2 = 0

Result:

For the new offliner: - A single layer is generated in the offline geopackage, combining data from layer1 with the specified filters.

For the old (QGIS) offliner: - Two separate layers are created, each representing the filtered datasets: - Layer 1: Filtered with id % 2 = 1 - Layer 2: Filtered with id % 2 = 0

Note

This configuration must be set in the Settings page of each project in QFieldCloud.

Synchronisation of Attachment Folders

To ensure an entire folder and its contents is downloaded to your QField device, you must add it under "Attachments and Directories".

1. In QGIS navigate to Project > Properties > QField.
2. Add your folder's path to the "Attachments and Directories" list. The path you enter must be relative to the location of your project file.

Example

You used pictures for a specific symbology. These are stored in a folder named assets located inside your project home folder. Add them under the folder name to the list.

On-Demand Attachment Downloads

For projects with many attachment files, you can enable on-demand downloading in QField. This is useful for saving storage space on field devices and reducing data transfer over limited network connections.

To enable this feature:

1. Navigate to your project on the QFieldCloud web platform.
2. Open the project's Settings tab.
3. Enable the On demand attachment files download option.

Note

This feature can be activated during project creation or enabled at any time for existing projects.

Connect to a custom QFieldCloud server in QField and QFieldSync

默认情况下，QField 和 QFieldSync 连接到 app.qfield.cloud 上的 QFieldCloud 服务。

You can modify the default QFieldCloud server that QField and QFieldSync connect to:

1. 在 QField 或 QFieldSync 中打开登录界面。
2. 双击 Nyuki 图标 (蓝色蜜蜂 QFieldCloud 徽标)。
3. 此动作将显示一个字段，您可以在其中输入首选 QFieldCloud 服务器地址。
4. 在提供的字段中输入所需服务器的详细信息。 (Leaving the field empty will automatically connect to the QFieldCloud server)

Revealing server in QField Sync

Revealing server in QField

Note

QField will remember the last entered URL for future sessions. It's important to note that QFieldSync does not support the same cloud project in multiple QGIS profiles. As a recommendation use a single QGIS profile for your QFieldCloud projects to avoid synchronization issues.