Conjuntos de datos compartidos¶
Es posible utilizar capas almacenadas en una única ubicación (denominada "ruta de datos localizada") en varios proyectos.
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.
- Sincronización a través de QFieldCloud: Los conjuntos de datos que se compartirán se cargan y almacenan en una ubicación dedicada en QFieldCloud a la que pueden acceder los proyectos preconfigurados.
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.
- En QGIS, vaya directamente a Configuración > Opciones > Fuentes de datos
- En la sección "Rutas de datos localizadas" agregue la ruta necesaria donde se encuentran los conjuntos de datos que se compartirán. Una vez añadidos correctamente, QGIS, QField/QFieldCloud los tratarán como conjuntos de datos compartibles.
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:
- Your shared dataset files need to be copied into the directory [App Directory]/QField/basemaps on your device.
QField buscará automáticamente en esta carpeta mapas base y otros datos reconocibles.
Configuración de conjuntos de datos compartibles con QFieldCloud¶
QFieldCloud facilita la gestión de conjuntos de datos compartidos utilizados en múltiples proyectos, reconociendo la configuración de datos localizada de QGIS.
Los proyectos en la nube cargados hacen referencia a los conjuntos de datos compartidos almacenados en un proyecto de QFieldCloud designado, denominado shared_datasets.
Este tipo especial de proyecto puede ser creado por el usuario con antelación o se crea automáticamente durante la carga de un archivo mediante 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.
- 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.
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.
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.
Esto se puede solucionar sincronizando el proyecto de nuevo desde QGIS con QFieldSync, asegurándose de que la opción "Subir conjuntos de datos localizados faltantes" esté marcada Sincronización con QFieldSync.
Como alternativa, si cuenta con los permisos necesarios, puede administrar el proyecto shared_datasets directamente (consulte la sección Sincronización directa del proyecto shared_datasets).
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.
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¶
Los usuarios con permisos de "administrador" o "administrador" para el proyecto shared_datasets pueden administrar su contenido directamente usando QFieldSync:
- En QFieldSync, descargue el proyecto
shared_datasetsde QFieldCloud a un directorio local en su ordenador. - Ahora puede agregar, actualizar o eliminar archivos dentro del directorio de archivos preconfigurado de los conjuntos de datos localizados.
- Utilice QFieldSync (con el proyecto
shared_datasetsseleccionado) 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.
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.
- Inicie sesión en QFieldCloud utilizando la CLI.
$ 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"
- Enumera los proyectos de QFieldCloud y obtén el ID del proyecto
shared_datasets:
$ 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.