Manual/Referencia

Field Sync

Field Sync conecta una capa de recolección de campo a un GeoServer WFS. Carga el conjunto completo de features del servidor en la capa de recolección, preserva las capturas locales no publicadas durante la actualización e inserta esas capturas mediante WFS-T.

Requisitos de GeoServer

  • WFS 2.0 con GetCapabilities, DescribeFeatureType, GetFeature e Insert transaccional habilitados.
  • Salida GeoJSON de GetFeature en EPSG:4326.
  • Un tipo de feature de punto, línea o polígono. El plugin construye el formulario de recolección a partir de las propiedades no geométricas de DescribeFeatureType.
  • Acceso desde el navegador al endpoint WFS, incluida CORS cuando está en otro origen. Las credenciales introducidas en el panel permanecen en memoria y no se guardan en el proyecto.

Abra Plugins → Field Sync, introduzca el endpoint WFS, descubra sus capas y luego cree una nueva capa de recolección o vincule una existente. Actualizar las features de todos reemplaza la instantánea propiedad del servidor manteniendo las features locales no publicadas. Publicar inserta solo esas features locales y recarga la capa.

Contrato del servicio de fotos

WFS no define almacenamiento de adjuntos binarios. La publicación de fotos es por tanto una frontera opcional y separada. Configure a la vez una URL de subida de fotos y una propiedad de cadena del tipo de feature WFS.

El plugin envía una petición multipart/form-data por imagen:

  • file: los bytes de la imagen y el nombre de archivo original
  • photoId: el identificador estable asignado durante la captura
  • typeName: el tipo de feature WFS, como survey:trees

El servicio devuelve:

{ "url": "https://assets.example/field/photo-a.jpg" }

Después de que todas las fotos tengan éxito, la propiedad WFS recibe una cadena JSON que contiene el arreglo de URLs devueltas. El servicio de subida debería tratar photoId como clave de idempotencia, porque un fallo posterior de WFS puede hacer que el cliente reintente el paso de fotos.

Las credenciales Basic de GeoServer nunca se reenvían a la URL de fotos. Los despliegues que protejan el servicio de fotos deberían usar una puerta de enlace autenticada de mismo origen u otra sesión de navegador propiedad del servicio.

Recolección de campo acepta hasta diez fotos y 10 MB de datos de foto codificados por feature, con un límite de 2 MB codificados por foto. Mientras ambos ajustes de foto no existan, una feature con fotos permanece pendiente en lugar de enviar datos base64 inline a GeoServer.