Archivo
Las preguntas de archivo permiten a los encuestados cargar documentos y otros archivos como parte de sus respuestas a la encuesta.
El tipo de pregunta file permite a los encuestados cargar cualquier archivo desde su dispositivo — documentos, hojas de cálculo, PDFs u otros tipos de archivo. A diferencia de image, audio y video que lanzan herramientas de captura específicas, file abre un selector de archivos de propósito general.
Especificación básica de XLSForm
| type | name | label |
|---|---|---|
| file | document | Por favor cargue su documento |
Para obtener más detalles sobre el tipo de pregunta de archivo estándar, consulte la especificación de XLSForm.
Usos
Las preguntas de archivo se usan comúnmente para:
- Recopilar documentos de respaldo (recibos, certificados, contratos, informes)
- Cargar formularios en papel completados que fueron escaneados
- Recopilar hojas de cálculo o exportaciones de datos de otros sistemas
- Cualquier tipo de archivo digital que image/audio/video no cubra
Formato de datos
Los archivos cargados se almacenan como archivos adjuntos binarios:
- Formato: Preservado en formato original (PDF, XLSX, DOCX, etc.)
- Nomenclatura:
{instanceID}-{fieldname}.{extension} - Almacenamiento: Cargado a la carpeta multimedia del servidor junto con el envío
- Acceso: Descargable desde la interfaz de gestión de envíos
Extensiones de rtSurvey
Tipos de archivo aceptados
Use la columna parameters para restringir qué tipos de archivo se pueden seleccionar:
| type | name | label | parameters |
|---|---|---|---|
| file | report | Cargar el informe de inspección | accept=.pdf |
| file | spreadsheet | Cargar el archivo de datos | accept=.xlsx,.csv |
El parámetro accept usa la sintaxis estándar de extensión de archivo (separada por comas).
Orientación sobre el tamaño de archivo
rtSurvey no impone un límite de tamaño de archivo fijo a nivel de pregunta, pero se aplica el límite de carga del servidor. Use hint para comunicar las expectativas al encuestador:
| type | name | label | hint |
|---|---|---|---|
| file | receipt | Cargar el recibo de pago | Aceptado: PDF o imagen. Tamaño máximo de archivo: 5 MB |
Integración con el sistema de archivos del dispositivo y almacenamiento en la nube
En Android e iOS, la pregunta file abre el selector de archivos nativo del dispositivo, que puede incluir acceso a:
- Almacenamiento local del dispositivo
- Tarjeta SD (Android)
- iCloud Drive (iOS)
- Google Drive, Dropbox (si están instalados)
En web, abre el cuadro de diálogo estándar de carga de archivos del navegador.
Ejemplo de uso
Carga de PDF requerida
| type | name | label | hint | required | required_message |
|---|---|---|---|---|---|
| file | signed_consent | Cargar el formulario de consentimiento firmado | Solo PDF, máx 2MB | yes | Se requiere un formulario de consentimiento |
Carga de documento condicional
| type | name | label | relevant |
|---|---|---|---|
| select_one yesno | has_land_title | ¿El hogar tiene un título de tierra? | |
| file | land_title_doc | Cargar una foto o escaneo del título de tierra | ${has_land_title} = 'yes' |
Mejores prácticas
- Use
acceptpara restringir los tipos de archivo; esto evita que los encuestadores carguen accidentalmente archivos incorrectos. - Incluya siempre orientación sobre tamaño y formato en la columna
hint. - Para fotos e imágenes, use el tipo
imageen su lugar; ofrece mejor compresión y manejo consistente del formato. - Para encuestas grandes con archivos adjuntos, planifique su almacenamiento de datos y ancho de banda de descarga en consecuencia.
- Pruebe el selector de archivos en el tipo de dispositivo de destino (Android vs. iOS vs. web) antes de la implementación; el acceso a unidades en la nube varía.
Consideraciones sobre el manejo de datos
- Los archivos se almacenan en su formato original; rtSurvey no los convierte ni comprime.
- Analice los archivos después de descargarlos; rtSurvey no extrae ni indexa el contenido de los archivos.
- Los archivos adjuntos grandes aumentan significativamente el tiempo necesario para descargar un conjunto de datos completo.
Limitaciones
- Las preguntas de archivo no validan el contenido del archivo; solo se aplica la verificación de extensión de archivo mediante
accepta nivel de UI. - Los archivos muy grandes (100 MB+) pueden agotar el tiempo de espera en la carga en entornos de baja conectividad.
- Los encuestadores sin conexión pueden adjuntar archivos pero no se cargarán hasta que se restaure la conectividad.
- Algunas configuraciones de dispositivos restringen el acceso a ciertas ubicaciones de almacenamiento (p. ej., políticas MDM corporativas).