Saltar a contenido

QFieldSync

QFieldSync (QFS) es el complemento de QGIS que debe usar para «empaquetar» sus proyectos para QField, es decir, para que su proyecto esté disponible para QField. Este es también el complemento que necesita usar para conectarse a QFieldCloud.

QFieldSync hará lo siguiente:

  • Empaqueta tu proyecto en un formato 'legible por QField' (por ejemplo, portable_project).
  • (Puede) crear mapas base a partir de una sola capa ráster o de un estilo definido en un tema de mapa.
  • De forma predeterminada, QFS configurará su proyecto en "edición sin conexión".
  • Se utiliza para sincronizar los cambios realizados en el campo con el proyecto de escritorio.

Para obtener una visión general rápida del proceso, aquí tiene una lista de pasos habituales:

  1. Crear un paquete QField. Esto es una copia de trabajo en una carpeta separada.
  2. Copiar el paquete QField en el dispositivo de destino.
  3. Salir y recopilar los datos.
  4. Copiar los datos modificados de vuelta a su ordenador de escritorio.
  5. Sincronizar la información modificada con su base de datos o ficheros.

Instalación

Antes de comenzar a usar QField, deberá descargar el complemento a través del repositorio de complementos.

Flujo

  1. En QGIS, vaya a Complementos > Gestionar e instalar complementos.

  2. Busque "QFieldSync".

  3. Seleccione el complemento en la lista y haga clic en "Instalar".

QFieldSync en el repositorio de complementos de QGIS
QFieldSync en el repositorio de complementos de QGIS

Configuración de QFieldSync

Prepararás tu proyecto QGIS según tus necesidades y lo guardarás como un archivo .qgs.

Puedes guardarlo en una carpeta específica y usarlo repetidamente.

Configurar proyecto
Configurar proyecto

Empaquetado de capas

Para sincronizar tus proyectos de QField con el escritorio mediante QFS, cada capa debe convertirse a un formato que QFieldSync pueda interpretar. Estas conversiones se realizan mediante "Acciones de capa". En el cuadro de diálogo de configuración del proyecto, puedes establecer la "Acción" necesaria para cada capa. Una acción define si QFS debe registrar los cambios realizados en la capa, acceder a ella directamente (en el caso de una capa WMS o Postgres) o tratarla como una capa de solo lectura.

Configurar las capas del proyecto
Configurar las capas del proyecto

Dependiendo del tipo de capa, hay disponibles diferentes tipos de acciones:

  • Copia (solo disponible para capas basadas en archivos (por ejemplo, Gpkg, Shp, Tiff)): La capa se copiará a la carpeta del proyecto empaquetado, pero no se realizará su seguimiento. Se creará una nueva copia en la carpeta del proyecto empaquetado.

  • Conservar existente (copiar si falta): La fuente de la capa se dejará intacta. En el caso de un proyecto a largo plazo, donde la sincronización se produce con frecuencia, es recomendable utilizar esta opción para no tener que volver a empaquetar el archivo cada vez.

  • Edición sin conexión: La capa se copia en la carpeta del proyecto empaquetado. Esta capa se rastrea y los cambios realizados se registran en un registro de cambios, que QFS utilizará posteriormente para la sincronización. Al sincronizar los cambios, este registro se reemplazará y todos los cambios también se aplicarán a la capa de origen original. Esto te permite realizar un seguimiento de los cambios y también trabajar con varios usuarios. Nota: No existe ningún mecanismo de gestión de conflictos.

  • Acceso directo a la fuente de datos: (solo sin archivos) Se accederá directamente a los datos. Esta opción solo está disponible para datos en línea como capas WMS/WFS o Postgres. En este último caso, si desea trabajar en línea, también deberá copiar las credenciales de Postgres (información de la base de datos) a QField. Consulte más información en PostgreSQL

  • Eliminar: La capa no se copiará a su proyecto empaquetado.

Área de interés y mapa base

Un mapa base es una capa ráster que se añade como la capa inferior al archivo del proyecto empaquetado. Al trabajar sin conexión con QField, es necesario añadir una capa ráster o establecer un tema para el mapa.

!!! nota! La configuración de esta sección no se aplica al usar QFieldCloud. Las capas sin conexión deben prepararse antes del trabajo de campo.

Área de interés

Al preparar tu proyecto para QField, puedes definir un área de interés. Al definir un área o una capa, solo se incluirán en el paquete las entidades que intersecten esta área de interés al exportar el proyecto a QField.

Mapa base: Un mapa base es una capa ráster que se añade como la capa inferior al archivo del proyecto empaquetado.

Existen dos opciones posibles para establecer un mapa base:

  • Capa única: Una capa ráster es útil para tomar una copia sin conexión de una capa en línea como un WMS o para tomar una copia de trabajo de un formato no compatible como una capa ECW o MrSID.

  • Tema de mapa: Un tema de mapa es útil para crear un mapa base a partir de una combinación de varias capas con estilos. Estas capas se pueden eliminar del paquete de trabajo y no es necesario renderizarlas en el dispositivo. Esto puede ahorrar espacio en disco y batería en el dispositivo.

Tamaño de la tesela

El tamaño de la tesela define la resolución espacial, es decir, el número de unidades de mapa por píxel. Por ejemplo, si el SRC del lienzo del mapa utiliza metros como unidades y el tamaño de la tesela se establece en 1, cada píxel ráster tendrá una extensión espacial de 1x1 m.

Nivel de zoom:

Al establecer los niveles de zoom mínimo y máximo, defines el nivel de detalle que verás al acercar y alejar la imagen.

  • Nivel mínimo de zoom de los mosaicos: define el nivel de zoom mínimo para los mosaicos rasterizados. Un valor más bajo aumenta la cobertura espacial, pero la resolución espacial es limitada. (Predeterminado: 14)
  • Nivel máximo de zoom de los mosaicos: define el nivel de zoom máximo para las teselas raster. Un valor más alto aumenta el detalle, pero puede requerir más espacio de almacenamiento, además de aumentar la duración de la exportación sin conexión. (Predeterminado: 14)

Configuración del mapa base QFieldSync
Configuración del mapa base QFieldSync

Empaquetar para QField

Una vez que hayas terminado de configurar tu proyecto, capas y estilos, estarás listo para empaquetarlo.

Flujo

  1. Vaya a Complementos > QFieldSync > Empaquetar para QField o haga clic en el símbolo correspondiente en la barra de herramientas de QFieldSync.

Empaquetar el proyecto para QField
Empaquetar el proyecto para QField

  1. Seleccione las carpetas que también se copiarán a QField.

Seleccionar subdirectorios
Seleccionar subdirectorios

Por defecto, QFieldSync elige la ruta de archivo para exportar un proyecto.

Sin embargo, puede cambiar esta configuración predeterminada en Plugins > QFieldSync > Preferencias.

Botón de preferencias de QFieldSync
Botón de preferencias de QFieldSync

En esta ventana también puede gestionar si las opciones de empaquetado se muestran en la barra de herramientas de QFieldSync.

Preferencias de QFieldSync
Preferencias de QFieldSync

  1. Para empezar a trabajar en QField, copie toda la carpeta en su dispositivo.

Consulta la sección Almacenamiento para conocer la especificación del directorio, según tu sistema (Android, iOS, Windows).

Normalmente, la ruta de acceso será similar a esta:

Android/data/ch.opengis.qfield/files/QField/...

¡Consejo!

Asegúrate de guardar el proyecto de QGIS usando la opción "Guardar como" de QGIS, ya que tendrás que volver a abrirlo más adelante para sincronizar los cambios.

Sincronizar desde QField

Una vez finalizada la recopilación, es hora de sincronizar los datos con su proyecto de escritorio.

Flujo

  1. Vuelva a abrir el proyecto en QGIS (el que guardó previamente con la opción "Guardar como").
  2. Copie la carpeta del proyecto de su dispositivo a su computadora.
  3. Vaya al menú Complementos > QFieldSync > Sincronizar desde QField para sincronizar los cambios del proyecto de QField con el proyecto de escritorio.

Sincronizar desde QField
Sincronizar desde QField

Atención

Asegúrese de sincronizar los datos solo una vez.

Esto significa que, si va a recopilar más datos, deberá crear un nuevo paquete de QField previamente para evitar problemas de sincronización posteriores (como duplicados).

Propiedades adicionales

Existen algunas opciones de propiedades más avanzadas que pueden resultarle relevantes dependiendo de su dominio:

  • Permisos: Deshabilitar las opciones para agregar o eliminar elementos, editar atributos o editar geometría.

  • Nombres predeterminados de los archivos adjuntos: Si desea guardar los archivos adjuntos dentro de sus datos, puede modificar los nombres predeterminados establecidos. Consulte Cómo configurar la ruta de sus archivos adjuntos.

  • Número máximo de elementos disponibles en una relación: Al trabajar con relaciones, puede establecer el número máximo de elementos que se muestran en el widget del editor de relaciones.

Propiedades de capas de QFieldSync
Propiedades de capas de QFieldSync

Configuración de la visibilidad máxima de elementos para QField

Para ajustar el número máximo de elementos visibles en una relación dentro de QField, siga estos pasos:

  1. Directamente a la capa vectorial Propiedades... > QField.

  2. En "Configuración de relaciones", establezca el "Número máximo de elementos visibles".

Nota

  • El número predeterminado es 4.
  • Si está vacío, el número es ilimitado.

Máximos elementos visibles para relación
Máximos elementos visibles para relación

Elementos visibles de QField
Elementos visibles de QField

Empaquetar para QField

Una vez que hayas terminado de configurar tu proyecto, capas y estilos, estarás listo para empaquetarlo.

  1. Vaya directamente a Complementos > QFieldSync > Package for QField o haga clic en el símbolo correspondiente en la barra de herramientas de QFieldSync.

Empaquetar el proyecto para QField
Empaquetar el proyecto para QField

  1. Seleccione las carpetas que también deben copiarse a QField.

Seleccionar subdirectorios
Seleccionar subdirectorios

By default, QFieldSync chooses the filepath for exporting a project.
It is however possible to change those defaults by directing to *Plugins* > *QFieldSync* > *Preferences*.

!![QFieldSync Preferences button](../../assets/images/qfieldsync-preferences-button.png,250px)

In this window you can also manage whether the packaging options are shown in the QFieldSync toolbar.

!![QFieldSync Preferences](../../assets/images/checkbox-show-package.png,850px)

!![](../../assets/images/unchecked-show-package.png,90px)

!![](../../assets/images/checked-show-package.png,150px)
  1. Para empezar a trabajar en QField, copie toda la carpeta en su dispositivo. Consulta la Sección de almacenamiento para conocer la especificación del directorio, según tu sistema (Android, iOS, Windows).

!! Consejo Asegúrate de guardar el proyecto de QGIS usando la opción "Guardar como" de QGIS, ya que tendrás que volver a abrirlo más tarde cuando quieras sincronizar los cambios.

Sincronizar desde QField

Una vez finalizada la recopilación, es hora de sincronizar los datos con su proyecto de escritorio.

  1. Vuelva a abrir el proyecto en QGIS (el que guardó con un "Guardar como" normal) anteriormente.
  2. Copia la carpeta del proyecto desde tu dispositivo a tu ordenador.
  3. Acceda directamente al menú Complementos > QFieldSync > Sincronizar desde QField para sincronizar los cambios del proyecto QField con el proyecto de escritorio.

Sincronizar desde QField
Sincronizar desde QField

Atención

Asegúrese de sincronizar sus datos solo una vez. Esto significa que, si va a recopilar más datos, deberá crear un nuevo paquete QField previamente para evitar problemas de sincronización posteriores (como duplicados).