Saltar a contenido

Conjuntos de datos compartidos

It is possible to use layers stored in a single location — referred to as a "localized data path" — across multiple projects.

Esto puede ayudar a reducir los requisitos de almacenamiento para grandes conjuntos de datos, como archivos ráster de ortofotos, archivos vectoriales de uso del suelo, etc., así como facilitar la gestión de las actualizaciones de los conjuntos de datos.

Hay dos posibilidades para compartir datos entre proyectos:

  • Transferencia manual: Los conjuntos de datos que se van a compartir se copian manualmente a los dispositivos.
  • Synchronization through QFieldCloud: The to be shared datasets are uploaded and stored in a dedicated location on QFieldCloud accessible to the pre-configured projects.

Gestión de rutas de datos localizadas en QGIS

Preparación en escritorio

Al preparar un nuevo proyecto para QField, asegúrese de que los conjuntos de datos que desea compartir entre varios proyectos estén almacenados en la ruta de datos localizada en QGIS.

  • In QGIS direct to Settings > Options > Data Sources
  • Under the "Localized Data Paths" section add the necessary path where the datasets to be shared are located. Una vez añadidos correctamente, QGIS, QField/QFieldCloud los tratarán como conjuntos de datos compartibles.

Cuadro de diálogo Opciones de QGIS que muestra la configuración de fuentes de datos y rutas de datos localizadas
Cuadro de diálogo Opciones de QGIS que muestra la configuración de fuentes de datos y rutas de datos localizadas

Configuración manual en dispositivos portátiles en QField

Para transferir manualmente los conjuntos de datos compartidos en QField, estos deben añadirse al directorio correcto de su dispositivo:

  • Los archivos de su conjunto de datos compartido deben copiarse en el directorio [Directorio de aplicaciones]/QField/basemaps en su dispositivo.

QField buscará automáticamente en esta carpeta mapas base y otros datos reconocibles.

Directorios de la aplicación QField
Directorios de la aplicación QField

Configuración de conjuntos de datos compartibles con QFieldCloud

QFieldCloud eases the management of shared datasets used in multiple projects recognizing the QGIS localized data settings. Uploaded cloud projects reference the shared datasets stored in a designated QFieldCloud project named shared_datasets. This special type of project can be created by the user in advance or is automatically created during a file upload using QFieldSync.

La estructura de archivos dentro del proyecto shared_datasets reflejará la estructura de la ruta localizada desde la que se originan los conjuntos de datos. Por ejemplo, si su ruta de datos localizada de QGIS es ./GIS_Common/BaseData/ y tiene un archivo ./GIS_Common/BaseData/Administrative-boundaries.gpkg, aparecerá como Administrative-boundaries.gpkg dentro del proyecto en la nube shared_datasets.

Nota

Solo los colaboradores cuya función de usuario sea “gerente“ o “administrador“ (asignados directamente o como propietarios o administradores de la organización) pueden añadir archivos al proyecto shared_datasets.

Preparación de un proyecto QGIS que contiene conjuntos de datos compartidos

Siga los mismos pasos descritos anteriormente en Preparación del escritorio (QGIS).

  • Asegúrese de que las rutas de datos localizadas en QGIS estén configuradas correctamente para apuntar a la ubicación de los conjuntos de datos compartidos en su ordenador. Esto le indica a QFieldSync qué archivos debe tratar como "localizados" para su gestión en la nube.
  • Asegúrese de que sus capas compartidas formen parte de su proyecto QGIS y que sus rutas sean relativas a una de las rutas de datos localizadas configuradas.

Carga de conjuntos de datos compartidos en QFieldCloud

Sincronización con QFieldSync

  • En QGIS, abra su proyecto y utilice el complemento QFieldSync para cargarlo o sincronizarlo con QFieldCloud.
  • Al inicio del proceso de sincronización, verá una nueva casilla de verificación Cargar conjuntos de datos localizados que faltan. Asegúrese de que esta opción esté marcada. Si pasa el cursor por encima de la casilla de verificación, verá la lista de archivos que se cargarán. Esta casilla de verificación solo está disponible para los usuarios con permiso para añadir archivos al proyecto shared_datasets.

Cuadro de diálogo de sincronización de QFieldSync con la opción de carga de conjuntos de datos localizados habilitada
Cuadro de diálogo de sincronización de QFieldSync con la opción de carga de conjuntos de datos localizados habilitada

  • Haga clic en el botón Realizar acciones para continuar. Durante la fase de carga, aparecerá una lista de los conjuntos de datos compartidos y habituales del proyecto a medida que se transfieran. Esto indica a QFieldSync que busque los archivos de datos reales a los que hacen referencia sus rutas de datos localizadas y los suba al proyecto en la nube shared_datasets.

Revisión del registro de cargas

Una vez completada la sincronización, puede consultar el registro de QFieldSync. En él se detallarán los archivos cargados, incluidos los conjuntos de datos compartidos que se enviaron a QFieldCloud.

FieldSync Lista de archivos cargados en el registro
FieldSync Lista de archivos cargados en el registro

Localización de conjuntos de datos dentro de la interfaz web de QFieldCloud

Una vez cargados, estos conjuntos de datos compartidos aparecerán en dos lugares clave de la interfaz web de QFieldCloud:

  • Dentro del propio proyecto dedicado shared_datasets.
  • Se hace referencia a ellos en la pestaña Archivos de cualquier proyecto normal en la nube que los utilice.

Conjuntos de datos compartidos en proyectos en la nube

  • Abre tu proyecto en la interfaz web de QFieldCloud.
  • Vaya a la pestaña Archivos.
  • Encontrará una sección denominada Conjuntos de datos compartidos. Este cuadro de diálogo muestra todos los conjuntos de datos que se han identificado y cargado como recursos compartidos/localizados para sus proyectos.

Lista de archivos de conjuntos de datos compartidos a los que se hace referencia en un proyecto QFieldCloud normal
Lista de archivos de conjuntos de datos compartidos a los que se hace referencia en un proyecto QFieldCloud normal

Comprobación del estado del conjunto de datos

Para cualquier proyecto en la nube que contenga conjuntos de datos compartidos, la interfaz web de QFieldCloud indicará aquellos que faltan en la nube (es decir, aquellos a los que se hace referencia en cualquier proyecto pero que aún no se han subido al proyecto shared_datasets) utilizando el color rojo.

This can be fixed by synchronizing the project again from QGIS with QFieldSync, ensuring the "Upload missing localized dataset(s)" option is checked Synchronization with QFieldSync. Alternatively, if you have the necessary permissions, you can manage the shared_datasets project directly (see section Synchronizing directly the shared_datasets project).

Del mismo modo, si prepara un nuevo proyecto QGIS para utilizar archivos compartidos que ya están presentes en su proyecto QFieldCloud shared_datasets, QFieldSync lo reconocerá. La casilla "Subir conjuntos de datos localizados que faltan" no debería aparecer. Si aparece, QFieldSync no volverá a subir los conjuntos de datos que ya existen y están actualizados en el proyecto shared_datasets.

Conjuntos de datos compartidos en QField

Los usuarios pueden simplemente descargar los proyectos a QField o sincronizar los ya existentes para acceder a los conjuntos de datos compartidos. Una ventaja clave es que la descarga de estos conjuntos de datos localizados compartidos se gestiona de manera eficiente mediante QField. Cada conjunto de datos compartido solo se descargará una vez, incluso si lo utilizan varios proyectos. Esto ahorra espacio de almacenamiento y tiempo de sincronización.

Interfaz de QField que muestra un proyecto con conjuntos de datos localizados compartidos desde QFieldCloud
Interfaz de QField que muestra un proyecto con conjuntos de datos localizados compartidos desde QFieldCloud

Sincronización directa en el proyecto shared_datasets

En lugar de depender de la sincronización de proyectos individuales para rellenar el proyecto shared_datasets, los usuarios con los permisos adecuados pueden gestionar su contenido de forma más directa.

Con QFieldSync

Users with "manager" or "admin" permissions for the shared_datasets project can manage its content directly using QFieldSync:

  1. En QFieldSync, descargue el proyecto shared_datasets de QFieldCloud a un directorio local en su ordenador.
  2. You can now add, update, or remove files within the pre-configured file directory of the localized datasets.
  3. Utilice QFieldSync (con el proyecto shared_datasets seleccionado) para sincronizar estos cambios directamente con la nube.

Nota

Las funciones específicas de los usuarios deben configurarse para el proyecto shared_datasets al igual que para cualquier otro proyecto. Un colaborador con una función de administrador de un proyecto que utilice un conjunto de datos compartido no tendrá automáticamente permiso para el proyecto shared_datasets.

Uploading localized dataset files directly to the "shared_datasets" cloud project using QFieldSync
Uploading localized dataset files directly to the "shared_datasets" cloud project using QFieldSync

Localized files listed in the "shared_datasets" cloud project on the web interface
Localized files listed in the "shared_datasets" cloud project on the web interface

Con la CLI de QFieldCloud

Los administradores pueden automatizar aún más la sincronización del proyecto shared_datasets utilizando la herramienta CLI oficial de QFieldCloud, qfieldcloud-cli (que forma parte del paquete Python qfieldcloud-sdk).

La herramienta se puede utilizar para sincronizar archivos QFieldCloud desde un directorio local. Comprueba automáticamente si hay cambios en la versión del contenido del archivo.

$ qfieldcloud-cli login USER PASSWORD
Log in super_user...
Welcome to QFieldCloud, USER.
QFieldCloud has generated a secret token to identify you. Put the token in your in the environment using the following code, so you do not need to write your username and password again:
export QFIELDCLOUD_TOKEN="TOKEN_HERE"
$ export QFIELDCLOUD_TOKEN="TOKEN_HERE"
$ qfieldcloud-cli list-projects
Listing projects...
Projects the current user has access to:
| ID                                   | OWNER/NAME           | IS PUBLIC |
---------------------------------------------------------------------------
| 90e83606-dce8-4b0d-854a-388904d8a739 | USER/shared_datasets | 0         |

Nota

Tu ID de proyecto será diferente.

Suba los conjuntos de datos compartidos desde su directorio local de origen al proyecto shared_datasets:

qfieldcloud-cli upload-files 'YOUR_PROJECT_ID' "./path/to/your/local/shared/data/"

Puede configurar este comando como una tarea cron periódica que se ejecuta periódicamente (por ejemplo, diariamente) o activarlo manualmente en función de otras condiciones, para mantener actualizados sus conjuntos de datos compartidos en QFieldCloud.