Guía de configuración avanzada¶
Proveedores vectoriales soportados¶
Actualmente, QFieldCloud admite capas GeoPackage y PostGIS para la edición colaborativa. Otros formatos compatibles con QGIS también deberían funcionar, pero no son oficialmente compatibles.
Trabajar con GeoPackages¶
Usar GeoPackages es normalmente la mejor elección para una configuración sencilla en la que centralizar los datos recopilados por sus usuarios de QField en un solo archivo.
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.
Flujo de trabajo de ejemplo (GeoPackage)¶
Preparación en escritorio
- Crear un proyecto nuevo.
- Cree capas GeoPackage y guárdelas en la misma carpeta que el proyecto QGIS.
- Configurar el GeoPackage para "Edición fuera de línea" en el complemento QFieldSync.
- Subir el proyecto a QFieldCloud.
Trabajo de campo
- Inicie sesión en QFieldCloud y descargue el proyecto en su dispositivo.
- Recopile y edite algunos datos y suba los cambios.
:monitor-material: Escritorio
- Utilizando QFieldSync, descargue los archivos actualizados (el archivo GeoPackage debería haber cambiado).
Advertencia
Este flujo de trabajo no admite cambios en el GeoPackage en el escritorio, ya que al estar basado en archivos, se sustituirá todo el GeoPackage. Esto significa que los datos solo se pueden digitalizar utilizando QFieldCloud.
PostGIS¶
El uso de capas PostGIS es una buena opción si sus datos deben ser directamente editables por varios usuarios a través de QFieldCloud cuando sincronizan su trabajo sin necesidad de realizar pasos adicionales.
Requiere que su base de datos sea de acceso público y que las credenciales se guarden sin cifrar en el proyecto QGIS. Tenga en cuenta las implicaciones de seguridad que conllevan estos requisitos y recuerde realizar copias de seguridad.
Flujo de trabajo de ejemplo (PostGIS)¶
Preparación en escritorio
- Crear un proyecto nuevo.
- Crear una capa PostGIS, asegurándose de guardar las credenciales en el proyecto.
- Make sure the PostGIS database connection is publicly accessible (public IP or domain name, it will not work with
127.0.0.1
orlocalhost
). - 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".
- Subir el proyecto a QFieldCloud.
Trabajo de campo
- Sign in to QFieldCloud and download the project.
- Collect some data
- Push or synchronize the changes once back at the office if you were using
offline editing
.
:monitor-material: Escritorio
- Todos los cambios deben ser directamente visibles dentro de la base de datos PostGIS.
Nota
Al utilizar el acceso directo a la base de datos
, QFieldCloud editará directamente los datos en la base de datos PostGIS.
Esto solo funcionará con una conexión a Internet fiable sobre el terreno, pero tiene la ventaja de que todos los datos son directamente visibles para todos los usuarios y permite utilizar cualquier configuración específica de PostGIS (desencadenantes, campos generados, 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.
Puede encontrar más información en Referencia técnica de QFieldCloud.
Restricción de archivos de proyecto¶
Para evitar cualquier modificación del archivo principal del proyecto QGIS, los administradores del proyecto pueden restringir el acceso a estos archivos. Esto se puede hacer en la sección de configuración de QFieldCloud.
- From the QFieldCloud homepage direct to Settings
- 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.
Archivos restringidos¶
Cuando esta opción está habilitada, los siguientes archivos solo pueden ser modificados o cargados por un usuario con un rol de "administrador" o "gerente" para el proyecto:
- El archivo de proyecto QGIS principal (por ejemplo,
my_project.qgz
). - El archivo zip de archivos adjuntos asociado con el proyecto (por ejemplo,
my_project_attachments.zip
). - Archivos de datos auxiliares de QGIS que almacenan información como posiciones de etiquetas (por ejemplo,
my_project.qgd
). - Archivos de estilo QField (
.qml
) que comparten el mismo nombre que el archivo del proyecto.
Envío automático a 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.
Preparación en escritorio
-
Access Project Settings: Direct to Project > Properties... > QField > QFieldCloud Packaging
-
Activar envío automático: Active la opción "Enviar automáticamente los cambios pendientes en el siguiente intervalo" y establezca el intervalo que prefiera.
Nota
Beneficios:
- *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¶
Cómo crear un proyecto en una organización:
Option 1: Using QField Sync¶
-
Sigue los pasos configura tu proyecto en la nube, hasta llegar a los "Detalles del proyecto".
-
Cambia el propietario del proyecto a su Organización.
-
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¶
-
In the QFieldCloud landing page direct to your organization.
-
Click on "Create a project".
-
Select "Create a new empty project"
-
Puede ver el proyecto nuevo en la vista general.
-
In QGIS open QFieldSync and you will see the new project listed, click on "Edit Selected Cloud Project".
-
Elija la carpeta en la que quiere guardar el proyecto.
-
En la carpeta seleccionada puede pegar un proyecto ya creado o guardar uno nuevo.
-
Una vez que la carpeta contenga el proyecto, puede sincronizarlo.
-
Finalmente, suba los cambios a la nube.
-
Puede comprobar que los archivos están presentes en el proyecto de la organización.
Option 3: Changing the Ownership of a project¶
- On the QFieldCloud landing page, click on your project of concern.
-
Direct to the Settings and select "Transfer ownership of this project" and choose the desired Organization for the transfer.
-
Aparecerá una ventana emergente para confirmar la transferencia. Para continuar, deberá escribir el texto solicitado y hacer clic en "Transferir proyecto".
Activar las notificaciones por correo electrónico para los cambios QFieldCloud¶
If you wish to be notified by QFieldCloud what happens to your team(s) and your projects, you can activate the email notification option.
- On your QFieldCloud landing page direct to settings.
- 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:
- Usuario creado
- Organización creada
- Organización borrada
- Membresía de organización creada
- Membresía de organización borrada
- Equipo creado
- Equipo borrado
- Membresía de equipo creada
- Membresía de equipo borrada
- Proyecto creado
- Proyecto borrado
- Membresía de proyecto creada
- Membresía de proyecto borrada
Recibirá notificaciones de eventos en los que usted no sea el actor. Estas notificaciones son específicamente para eventos iniciados por otros miembros de tu organización o colaboradores en tus proyectos.
Mejore su proyecto con el "Empaquetador optimizado"¶
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.
- On the QFieldCloud landing page and select the project of concern
- 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:
Configuración de ejemplo:
- Capa 1.1:
- Fuente de datos:
layers.gpkg
- Tabla:
layer1
-
Filtro:
id % 2 = 1
-
Capa 1.2:
- Fuente de datos:
layers.gpkg
- Tabla:
layer1
- Filtro:
id % 2 = 0
Resultado:
Para el nuevo offliner:
- A single layer is generated in the offline GeoPackage, combining data from
layer1
with the specified filters.
Para el antiguo (QGIS) offliner:
- Se crean dos capas separadas, cada una de las cuales representa los conjuntos de datos filtrados:
- Capa 1: Filtrado con
id % 2 = 1
. - Capa 2: Filtrado con
id % 2 = 0
.
Nota
Esta configuración debe establecerse en la página Configuración de cada proyecto en QFieldCloud.
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.
- In QGIS navigate to Project > Properties... > QField.
- Agregue la ruta de su carpeta a la lista "Adjuntos y directorios". La ruta que ingrese debe ser relativa a la ubicación del archivo de su proyecto.
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.
Descargas de anexos a la carta¶
Para proyectos con muchos archivos adjuntos, puede habilitar la descarga bajo demanda en QField. Esto resulta útil para ahorrar espacio de almacenamiento en los dispositivos de campo y reducir la transferencia de datos en conexiones de red limitadas.
Para habilitar esta función:
- From the QFieldCloud landing page, select your project.
- Direct to Settings.
- Enable the "On demand attachment files download" option.
Nota
Esta función se puede activar durante la creación del proyecto o en cualquier momento para proyectos existentes.
Conectarse a un servidor QFieldCloud personalizado en QField y QFieldSync¶
QField and QFieldSync connect to the QFieldCloud service app.qfield.cloud by default.
You can modify the default that QField and QFieldSync connect to:
- Abra la pantalla de identificación en QField o QFieldSync.
- Double-tap on the Nyuki icon (the QFieldCloud logo).
- Esta acción mostrará un campo en el que puede introducir la dirección del servidor preferido de QFieldCloud.
- Introduzca los detalles del servidor deseado en el campo proporcionado. (Si deja el campo vacío, se conectará automáticamente al servidor QFieldCloud)
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.