📥 Campos de descarga

Con los campos de descarga, puedes poner a disposición de quien rellena el formulario archivos de onOffice para su descarga directa, por ejemplo, un contrato de alquiler, la ficha descriptiva actual, actas de entrega o documentación recopilada del propietario. Este tipo de campo es el complemento del campo de carga de archivos y también se puede combinar con él.

Contenido

• Casos de uso
• Configurar el campo
• Fuentes de archivos
• Seleccionadores: ¿qué archivo?
• Varios archivos → Paquete ZIP
• Híbrido: carga + descarga en el mismo campo
• Actividad al descargar
• [Limitaciones](#limits)

Casos de uso

• Documentación del inquilino: el arrendador hace clic en el enlace → el formulario muestra todos los documentos del inquilino (DNI, nóminas) para su descarga
• Página de estado del propietario: el propietario abre el enlace → ve el PDF actual del informe de la propiedad + el informe de actividad
• Confirmación de reserva: el comprador abre el enlace → puede descargar el acuerdo de reserva firmado en formato PDF
• Descarga del borrador del contrato: el notario/vendedor abre el formulario → obtiene el borrador actual del contrato de compraventa
• Descarga masiva: varios archivos de una pestaña se ofrecen agrupados en un archivo ZIP

Configurar el campo

1. Editor de formularios → Añadir campo → Tipo especial «Descargar archivo»
2. Asignar nombre al campo (p. ej., «Descargar borrador del contrato»)
3. Seleccionar fuente del archivo (véase la siguiente sección)
4. Opcional: configurar selector (más reciente / más antiguo / todos / filtrado)
5. Opcional: activar «Ocultar campo si no se encuentra ningún archivo» — evita que aparezcan botones vacíos

---

Fuentes de archivos

Para cada campo de descarga, selecciona de dónde debe proceder el archivo:

> 💡 Combinar varias fuentes: «Característica del documento Y el nombre del archivo contiene 2024» → solo proporciona la variante de 2024 del documento marcado.

## Selectores: ¿qué archivo?

Si hay varios archivos que coinciden con la fuente (p. ej., tres versiones de un contrato), el selector decide:

Además: Filtro «El nombre del archivo contiene la cadena» — p. ej., solo archivos con «contrato» en el nombre.

## Varios archivos → Agrupación en ZIP

Si el selector devuelve varios archivos:

• propform los empaqueta automáticamente en un archivo ZIP
• El nombre del archivo ZIP se puede configurar (con macros, p. ej., Unterlagen_<Vorname>_<Nachname>.zip)
• En los navegadores móviles, el ZIP se descarga como cualquier otro archivo (comportamiento predeterminado)

Híbrido: carga + descarga en el mismo campo

Un campo de carga de archivos puede incorporar además una función de descarga, lo cual resulta práctico para flujos de trabajo del tipo «descargar documento contractual, firmarlo y volver a cargarlo».

Configuración:

1. Campo de carga de archivos existente → Ajustes del campo
2. Establecer el modo en «Modificar + Descargar» (en lugar de «Solo carga» o «Solo descarga»)
3. Ambas configuraciones de origen están disponibles (destino de carga + origen de descarga)

En el formulario, el usuario ve:

• Botón de descarga para el archivo existente
• Área de carga para un archivo nuevo o de sustitución

## Actividad en la descarga

Opcionalmente, puedes registrar una actividad en onOffice con cada descarga, para el registro de auditoría y la generación de informes:

• Configurable como otras actividades (tipo de acción, clase de acción, texto personalizado)
• Opcional: registrar el hash del archivo — demuestra que se ha descargado exactamente esta versión del archivo
• Se puede combinar con «Actividad al abrir el formulario» (véase Configuración de formularios); así tendrás tanto «El usuario ha abierto el documento» como «El usuario ha descargado el documento» en el historial

Limitaciones

Campos de archivo de la máscara de onOffice

Los archivos que se encuentran en campos de archivo de la máscara de direcciones/inmuebles (es decir, directamente en el registro, no en la pestaña «Archivos») no se pueden recuperar a través de la API de onOffice — véase Preguntas frecuentes: Fallo en la subida de archivos.

Consecuencia:

• En el módulo Inmuebles: solo se puede acceder a los archivos que se subieron originalmente a través de propform (con referencia de ID de archivo)
• En el módulo Direcciones: se puede acceder a todos los archivos desde la pestaña «Archivos» (la API está completa aquí)

Límite de tamaño de archivo

• Por archivo: 128 MB (corresponde al límite de carga, por parte de nginx)
• Paquetes ZIP: no hay un límite estricto, pero el rendimiento es lento cuando hay muchos archivos (>100)

Seguridad

Los campos de descarga deben combinarse siempre con otros mecanismos de protección:

• Requisito de UUID (véase Protección de formularios) — evita la manipulación de la URL
• Filtro por formulario (véase Preguntas frecuentes: Filtro por formulario) — limitado a registros específicos
• Opcional: lista blanca de IP o clave de formulario

Relacionado

• 📖 Campos — todos los tipos y opciones — Resumen general de todos los tipos de campos
• 📖 Protección de formularios — Requisito de UUID, lista blanca de IP, clave de formulario
• 📖 Combinar varios registros — Bucles de direcciones para flujos de trabajo entre inquilinos y propietarios
• 📖 Preguntas frecuentes: error al subir un archivo — Problemas con el iPhone y limitaciones de la API