Guia de configurações avançadas

Ajuda

Temos uma plataforma de discussão da comunidade para colocares as tuas perguntas, dúvidas e ideias. Não hesites em utilizar.

Dados vectoriais suportados

Atualmente, o QFieldCloud suporta camadas GeoPackage e PostGIS para edição colaborativa. Outros formatos suportados pelo QGIS, também deverão funcionar, mas não são oficialmente suportados.

Trabalhar com GeoPackages

Utilizar GeoPackages é normalmente a melhor opção e de configuração simples para centralizar os dados recolhidos pelos utilizadores do QField num único ficheiro.

Se desejas configurar relações, é recomendável adicionar um campo UUID, nas tuas tabelas e usar esse campo como chave estrangeira em vez do fid do GeoPackage, pois eles são únicos e isso permite evitar conflitos, caso dois utilizadores criem novos registos ao mesmo tempo.

Workflow de exemplo (GeoPackage)

1. Configuração no QGIS desktop:
   1. Criar um novo projeto
   2. Cria uma camada GeoPackage, e guarda-a na mesma pasta do projeto QGIS.
   3. Define o GeoPackage com a opção "Edição off-line" no plugin QFieldSync.
   4. Carregar o projeto no QFieldCloud.
2. Recolhe informação no dispositivo com o QField:
   1. Abre o QFieldCloud e importa o projeto.
   2. Recolhe alguns dados e carrega a alterações.
3. Download dos resultados para o QGIS desktop:
   1. No QFieldSync, descarrega os ficheiros atualizados (o ficheiro GeoPackage deverá ser diferente).

Atenção

Este workflow não suporta, alterações do GeoPackage no desktop, por ser um ficheiro, todo o GeoPackage será substituído. Isto significa que os dados só podem ser digitalizados com o QFieldCloud.

PostGIS

Usar as camadas PostGIS, é uma boa escolha se pretenderes ter informação dos teus utilizadores de QField, atualizada diretamente na tua base de dados pelo QFieldCloud quando eles sincronizarem os seus trabalhos sem mais nenhum passo adicional.

Reque que o tua base de dados seja pública e acessível remotamente e as credenciais de acesso terão ser guardadas no projeto QGIS desencriptadas. Deves estar ciente das implicações de segurança de tais requisitos e lembra-te de ter backups.

Workflow de exemplo (PostGIS)

1. Configuração no QGIS desktop:
   1. Criar um novo projeto
   2. Cria e adiciona uma camada PostGIS, certificando que guardas as credenciais de acesso no projeto.
   3. Certifica-te que a base de dados PostGIS é acessível de forma remota ( através de um IP público ou domínio, não funcionará com 127.0.0.1 ou localhost).
   4. Nas configurações do projeto QFieldSync, defina o GeoPackage para Edição offline, caso os utilizadores de QField não tenham ligação internet fiável no campo ou Acesso direto à base de dados.
   5. Carregar o projeto no QFieldCloud.
2. Recolhe informação no dispositivo com o QField:
   1. Abre o QFieldCloud e importa o projeto.
   2. Recolhe alguns dados (e carrega as alterações, quando tiveres no gabinete, caso estejas a usar o modo de Edição off-line).
3. Vê os resultados para o QGIS desktop:
   1. Todas as alterações deverão ser observáveis na base de dados PostGIS.

Nota

Ao usar acesso direto à base de dados, o QFieldCloud irá editar os dados diretamente na base de dados PostGIS. Isto só irá funcionar com uma ligação de internet fiável no campo, mas tem a vantagem de que toda a informação é visível diretamente para todos os utilizadores e permite utilizar qualquer configuração específica do PostGIS (triggers, campos dinâmicos, etc).

Nota

Ao usar a edição offline, o QField trabalhará com a cópia local da base de dados num GeoPackage, que será sincronizado pelo QFieldCloud com a base de dados original. Esta é a melhor escolha, se a ligação no campo não for fiável. As alterações só serão visíveis para os utilizadores quando eles sincronizarem com o QFieldCloud. Como uma cópia local é criada, os recursos avançados do PostGIS não estão disponíveis no QField. Assim como para GeoPackages regulares, se definir relações, é recomendável usar UUIDs em vez de chaves primárias inteiras para evitar conflitos, caso vários utilizadores criem dados ao mesmo tempo.

Podes encontrar mais informações na referência técnica do QFieldCloud.

Enabling automatic pushing of changes 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 panel 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

How to create a project in an organization:

Option 1: Directly convert your local project to an Organization QFieldCloud project:

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

2. Change the owner of the project to your Organization.

   

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

   

Note

QField Sync 4.6 or newer is required for this functionality

Option 2: Uploading directly to the organization:

1. Select your organization.

   

2. Once you get into the organization, click on "Create a project".

   

3. Select "Create a new empty project".

   

4. You can see the new project in the overview.

   

5. On QGIS in QFieldSync, you will see the new project listed, click on "Edit Selected Cloud Project".

   

6. Choose the folder where you want to save the project.

   

7. In the selected folder, you can either paste an already worked-on project or save a new one.

   

8. Once the folder contains the project, you can synchronize it.

   

9. Finally, push the changes to the cloud.

   

10. You can verify that the files are present in the Organization project.

    

Option 3: Moving the project from your own account to the Organizations:

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 "Here be dragons" and click "Transfer project".

   

Activate email notifications for QFieldCloud changes

1. Access the Settings of your account.

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: - User created - Organization created - Organization deleted - Organization membership created - Organization membership deleted - Team created - Team deleted - Team membership created - Team membership deleted - Project created - Project deleted - Project membership created - Project membership deleted

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 to use 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.

Connect to a custom QFieldCloud server in QField and QFieldSync

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

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

1. Open the login screen in QField or QFieldSync.
2. Double-tap on the Nyuki icon (the blue bee QFieldCloud logo).
3. This action will reveal a field where you can enter the preferred QFieldCloud server address.
4. Enter the details of the desired server in the provided field. (Leaving the field empty will connect to the default QFieldCloud server at app.qfield.cloud.)

Reveling server in QField Sync

Reveling server in QField

Note

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.