Anleitung Erweiterte Einstellungen

Unterstützte Vektoranbieter

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

Arbeiten mit GeoPackages

Die Verwendung von GeoPackages ist normalerweise die beste Wahl für eine einfache Einrichtung, um die von deinen QField-Nutzern gesammelten Daten in einer einzigen Datei zu zentralisieren.

If you would like to set up a relation, add a UUID field and 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.

Beispiel-Workflow (GeoPackage)

Vorbereitung am Schreibtisch

1. Ein neues Projekt erstellen.
2. Create GeoPackage layers, save it in the same folder than the QGIS project.
3. Im QFieldSync-Plugin das GeoPackage auf "Offline bearbeiten" stellen.
4. Das Projekt in die QFieldCloud hochladen.

Feldarbeit

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.

Beispiel-Workflow (PostGIS)

Vorbereitung am Schreibtisch

1. Ein neues Projekt erstellen.
2. Fügen Sie einen PostGIS-Layer hinzu und stellen Sie sicher, dass die Anmeldeinformationen im Projekt gespeichert werden.
3. Make sure the PostGIS database connection is publicly accessible (public IP or domain name, it will not work with 127.0.0.1 or localhost).
4. In the QFieldSync project settings, set the GeoPackage to "Offline editing" if your QField users will not have a reliable internet connection in the field or "Direct database access".
5. Das Projekt in die QFieldCloud hochladen.

Feldarbeit

1. Sign in to QFieldCloud and download the project.
2. Collect some data
3. Push or synchronize the changes once back at the office if you were using offline editing.

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. We recommend to use this option to avoid unnecessary data losses in case of lost data connection.

Changes will only be visible to users once the Synchronisation via QFieldCloud has been applied on the different devices. When a local copy is created, advanced PostGIS operations (like triggers) will not be available on QField.

Weitere Informationen finden Sie unter [QFieldCloud technische Referenz].(../../reference/qfieldcloud/concepts.md).

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.

1. From the QFieldCloud homepage direct to Settings
2. Enable the Restrict project files button

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.

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.

Automatic push to QFieldCloud

With this functionality, you 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.

Vorbereitung am Schreibtisch

1. Access Project Settings: Direct to Project > Properties... > QField > QFieldCloud Packaging

2. Automatische Übertragung aktivieren: Schalten Sie die Option 'Ausstehende Änderungen automatisch im folgenden Intervall übertragen' ein und legen Sie das gewünschte Intervall fest.

Automatische Übertragung QFieldSync

Automatische Übertragung QField

Note

Benefits:

• Real-Time Updates: Ensures prompt Synchronisation of field data with the QFieldCloud project.
• Streamlined Workflow: Minimizes manual intervention and ensures surveyors do not need to worry about Synchronisation, 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.

Project creation in an organisation

Wie erstellt man ein Projekt innerhalb einer Organisation:

Option 1: Using QField Sync

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

2. Machen Sie Ihre Organisation zum Eigentümer des Projekts.

   

3. Click on "Create" to start the conversion and Synchronisation. When finished the project will appear in the list of projects of your Organization in QFieldCloud.

   

Option 2: Using QFieldCloud

1. In the QFieldCloud landing page direct to your organization.

   

2. Click on "Create a project".

   

3. Select "Create a new empty project"

   

4. Im Überblick ist nun das neue Projekt zu sehen.

   

5. In QGIS open QFieldSync and you will see the new project listed, click on "Edit Selected Cloud Project".

   

6. Wählen Sie den Ordner, in dem Sie das Projekt speichern möchten.

   

7. In dem ausgewählten Ordner können Sie entweder ein bereits bearbeitetes Projekt einfügen oder ein neues Projekt speichern.

   

8. Sobald der Ordner das Projekt enthält, können Sie es synchronisieren.

   

9. Nun übertrage die Änderungen in die Cloud.

   

10. Sie können überprüfen, ob die Dateien im Organisationsprojekt vorhanden sind.

    

Option 3: Changing the Ownership of a project

1. On the QFieldCloud landing page, click on your project of concern.

2. Direct to the Settings and select "Transfer ownership of this project" and choose the desired Organization for the transfer.

   

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

   

Aktivieren Sie E-Mail-Benachrichtigungen für QFieldCloud-Änderungen

If you wish to be notified by QFieldCloud what happens to your team(s) and your projects, you can activate the email notification option.

1. On your QFieldCloud landing page direct to settings.
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.

The events you get notified about are:

• Benutzer angelegt
• Organisation angelegt
• Organisation gelöscht
• Organisationsmitgiedschaft angelegt
• Organisationsmitgiedschaft gelöscht
• Team angelegt
• Team gelöscht
• Teammitgliedschaft angelegt
• Teammitgliedschaft gelöscht
• Projekt angelegt
• Projekt gelöscht
• Projektmitgliedschaft angelegt
• Projektmitgliedschaft gelöscht

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.

Verbessern Sie Ihr Projekt mit dem "Optimierten Packager"

We recommend using the new "Optimized Packager" over the deprecated "QGIS Core Offline Editing" for all your projects. The "Optimized Packager" supports consolidating filtered layers of same datasource into a single offline layer, respecting distinct symbology but also using less storage.

1. On the QFieldCloud landing page and select the project of concern
2. Direct to Settings and set the packager under "Packaging Offliner" in the "Settings" tab of your project.

Here is an example to illustrate this feature:

Beispiel-Konfiguration:

• Layer 1.1:
• Datenquelle: layers.gpkg
• Tabelle: layer1

• Filter: id % 2 = 1

• Layer 1.2:

• Datenquelle: layers.gpkg
• Tabelle: layer1
• Filter: id % 2 = 0

Ergebnis:

Für den neuen offliner:

• A single layer is generated in the offline GeoPackage, combining data from layer1 with the specified filters.

Für den alten (QGIS) offliner:

• Es werden zwei separate Ebenen erstellt, die jeweils die gefilterten Datensätze darstellen:
• Layer 1: Filtered with id % 2 = 1
• Layer 2: Filtered with id % 2 = 0

Anmerkung

Diese Konfiguration muss auf der Einstellungsseite jedes Projekts in [QFieldCloud] vorgenommen werden.(https://app.qfield.cloud/).

Configuration of Attachment Folders

If your project contains photos, documents or other attachments, you have to configure your QGIS project accordingly to ensure that the data are downloaded to your QField device.

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. From the QFieldCloud landing page, select your project.
2. Direct to Settings.
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.

Mit einem kundeneigenen QFieldCloud Server in QField und QFieldSync verbinden

QField and QFieldSync connect to the QFieldCloud service app.qfield.cloud by default.

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

1. Öffnen Sie den Anmeldebildschirm in QField oder QFieldSync.
2. Double-tap on the Nyuki icon (the QFieldCloud logo).
3. Bei dieser Aktion wird ein Feld angezeigt, in das Sie die bevorzugte QFieldCloud-Serveradresse eingeben können.
4. Geben Sie die Details des gewünschten Servers in das vorgesehene Feld ein. (Leaving the field empty will automatically connect to the QFieldCloud server)

Revealing server in QFieldSync

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 Synchronisation issues.