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 van a compartir se cargan y almacenan en una ubicación específica en QFieldCloud accesible para 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', añada la ruta necesaria donde se encuentran los conjuntos de datos que se van a compartir. 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

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:

• En QField, abra un proyecto.
• Para mostrar la leyenda lateral, haz clic en el icono con las tres líneas, y para abrir el menú principal, haz clic en el botón con los tres puntos.
• Seleccione la pestaña del menú 'Acerca de QField'.
• Las ubicaciones de los directorios de aplicaciones se mostrarán en la parte inferior de la pantalla, justo debajo de la ruta 'Directorios de aplicaciones' (las rutas varían en función del sistema operativo).
• Copie los archivos de su conjunto de datos compartidos en el directorio [Directorio de la aplicación]/QField/basemaps de su dispositivo. QField buscará automáticamente en esta carpeta mapas base y otros datos reconocibles.

Directorios de la aplicación QField

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 localizados de QGIS. Los proyectos subidos a la nube hacen referencia a los conjuntos de datos compartidos almacenados en un proyecto QFieldCloud designado llamado shared_datasets. Este tipo especial de proyecto puede ser creado por el usuario con antelación o se crea automáticamente durante la subida de archivos utilizando 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

• 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

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

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 de nuevo el proyecto desde QGIS con QFieldSync, asegurándose de que la opción "Subir conjuntos de datos localizados que faltan" esté marcada Sincronización con QFieldSync). Alternativamente, si dispone de los permisos necesarios, puede gestionar directamente el proyecto shared_datasets (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.

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

Los usuarios con permisos de 'administrador' o 'gestor' para el proyecto shared_datasets pueden gestionar su contenido directamente utilizando QFieldSync:

1. En QFieldSync, descargue el proyecto shared_datasets de QFieldCloud a un directorio local en su ordenador.
2. Ahora puede añadir, actualizar o eliminar archivos dentro del directorio de archivos preconfigurado de los conjuntos de datos localizados.
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.

Carga directa de archivos de conjuntos de datos localizados al proyecto en la nube 'shared_datasets' utilizando QFieldSync

Archivos localizados enumerados en el proyecto en la nube 'shared_datasets' en la interfaz web

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 USUARIO CONTRASEÑA
Iniciando sesión como super_user...
Bienvenido a QFieldCloud, USUARIO.
QFieldCloud ha generado un token secreto para identificarle. Introduzca el token en su entorno utilizando el siguiente código, para que no tenga que volver a escribir su nombre de usuario y contraseña:
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
Listando proyectos...
Proyectos a los que tiene acceso el usuario actual:
| ID | PROPIETARIO/NOMBRE | ES PÚBLICO |
--------------------------------------------------- ------------------------
| 90e83606-dce8-4b0d-854a-388904d8a739 | USUARIO/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 'TU_ID_PROYECTO' "./ruta/a/tu/local/compartido/datos/"

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.