Sincronización

Pantalla de RadiAPS2 para subir al servidor los datos cargados en la tablet, controlar pendientes y actualizar catálogos (centros y sectores).

App: RadiAPS2 (tablet) Menú / pestaña: Sincronizar
Antes de sincronizar
Completá y guardá en Configuración al menos: territorio (zona/área/sector), DNI, apellido y nombre. Sin DNI el servidor no puede validar al agente. La app trabaja offline: la sync es el momento en que los cambios locales llegan al servidor.

1. ¿Para qué sirve?

  • Ver el estado de conexión con el servidor configurado.
  • Consultar totales: registros, sincronizados, pendientes y progreso.
  • Ver el detalle por tabla (barrios, viviendas, familias, personas, visitas, encuestas…).
  • Ejecutar Sincronizar (envío de datos + vinculación del agente).
  • Actualizar catálogos (centros de salud y sectores) cuando lo indique el administrador.
  • Diagnosticar red si no hay conexión.

2. Cómo acceder

  1. Pestaña inferior Sincronizar, o
  2. Menú lateral → Sincronizar.

El título de la pantalla es Sincronización de Datos.

3. Pantalla principal

Sincronización de Datos: estado de conexión, KPIs y tabla por entidad
Estado de red, resumen (total / sincronizados / pendientes / progreso) y Estado por Tabla.

3.1 Estado de conexión

Indicador Significado
Conexión activa (verde) La tablet alcanza el servidor; podés sincronizar.
Sin conexión (rojo) No hay red o el servidor no responde. Se muestra el motivo (URL, error de fetch, etc.).
Diagnosticar red Prueba de alcance al servidor; muestra un informe útil para soporte técnico.

La app verifica la conexión periódicamente (cada unos segundos) mientras estás en esta pantalla.

3.2 Resumen (KPIs)

  • Total Registros: cantidad de filas de datos de campo consideradas en el resumen.
  • Sincronizados: marcados como ya enviados.
  • Pend.: pendientes de subir (o a reenviar).
  • Progreso: porcentaje sincronizados / total.

3.3 Estado por tabla

Columnas: TABLA, TOTAL, SINC, PENDIENTES, PROGRESO, ESTADO.

Tabla (etiqueta) Qué incluye
Barrio Barrios del censo.
Vivienda Domicilios.
Familia Núcleos familiares.
Poblacion Personas / integrantes.
Visita Visitas domiciliarias.
Encuesta Encuestas individuales.
ViviendaEncuesta Encuestas de vivienda / priorización asociadas.

Estados por fila: Sincronizado, Pendiente, Error o Sin datos.

4. Botón Sincronizar

  1. Verificá Conexión activa.
  2. Pulsá Sincronizar.
  3. Confirmá el diálogo (indica cuántos registros se enviarán).
  4. Durante el proceso verás la tabla en curso (p. ej. «Sincronizando: Familia»).

4.1 Qué hace la sync (resumen)

  1. Vincula al agente con el servidor usando el DNI de Configuración (adopta el UUID del usuario y puede reasignar responsables locales).
  2. Prepara los registros de las tablas de campo y los envía al servidor (el servidor hace UPSERT: actualiza si existe, inserta si no).
  3. Actualiza los contadores de la pantalla al terminar.
Puerta de sync (sync gate)
El servidor puede bloquear la sync si la app está desactualizada o falta guardar la configuración. En ese caso verás un aviso indicando: actualizar RadiAPS2, abrir Configuración → Guardar, y volver a sincronizar.

5. Actualizar catálogos

Botón Actualizar catálogos: descarga del servidor centros de salud y sectores del área configurada (nombres, estado, UUID).

  • No sube ni modifica visitas, familias, barrios ni personas.
  • Antes de ejecutar, la app muestra un aviso: usalo solo cuando el administrador lo indique.
  • Requiere conexión activa.

6. Requisitos y mensajes de error

Situación Qué hacer
Sin conexión Wi‑Fi/datos; URL del servidor; botón Diagnosticar red; reintentar.
Falta el DNI Configuración → cargar DNI → Guardar → sincronizar de nuevo.
Usuario no registrado El DNI no existe en el servidor. Verificá el documento; si está bien, pedí alta al administrador.
Actualización / configuración requerida Actualizá la app (Versión / OTA o APK) y tocá Guardar en Configuración.
Sincronización con errores Modal con cantidad OK vs. con error y detalle por tabla. Los fallidos se reintentan en la próxima sync.

7. Relación con otros módulos

Módulo Relación
Configuración DNI, territorio, ronda y servidor; Guardar habilita la sync.
Censo (barrios → personas) Altas/edits/bajas quedan pendientes hasta sincronizar.
Visitas Badge Pendiente / Error / Sincronizado en cada visita.
Versión Actualizaciones OTA / versionCode cuando el gate exige versión mínima.

8. Consejos de uso en terreno

  1. Sincronizá al inicio del día (bajar estado del servidor vía catálogos si hace falta) y al final (subir pendientes).
  2. Preferí Wi‑Fi estable; en redes móviles inestables usá Diagnosticar red.
  3. Si hay muchos pendientes, sincronizá antes de cambiar de tablet o reinstalar.
  4. No uses «Actualizar catálogos» de forma rutinaria: solo con indicación del administrador.
  5. Tras cambiar DNI o territorio, Guardá Configuración y sincronizá para vincular el agente.

9. Resolución de problemas

Problema Qué revisar
Botón Sincronizar deshabilitado Sin conexión, o ya hay una sync / actualización de catálogos en curso.
Failed to fetch / gate / rondas URL del servidor, certificados HTTPS (tablets viejas), firewall, VPN.
Pendientes no bajan a 0 Abrí el modal de errores; corregí datos inválidos; reintentá sync.
Otro agente no ve mis datos Confirmá que tu sync terminó OK; el otro dispositivo también debe sincronizar/bajar.
Sectores o centros desactualizados Actualizar catálogos (con autorización) y Guardar Configuración.

10. Glosario

Término Significado
Pendiente Registro local que aún no se confirmó en el servidor (o se reenviará).
UPSERT El servidor actualiza si el UUID existe o inserta si es nuevo (evita duplicados).
Sync gate Control del servidor que exige versión mínima y/o configuración guardada.
Adoptar agente Vincular el DNI local con el UUID de usuario en el servidor.
Catálogos Centros de salud y sectores descargados del servidor.

Tutorial RadiAPS2 · Módulo Sincronización · Agosto 2026.