Subida de archivos

El tipo de pregunta de subida de archivos de NueForm permite a los encuestados adjuntar archivos a sus envíos de formularios. Esta guía cubre cómo configurar la subida de archivos, configurar restricciones y acceder a los archivos subidos.

Configurar una pregunta de subida de archivos

1. Abre tu formulario en el constructor de NueForm.
2. Haz clic en el botón + para agregar una nueva pregunta.
3. Selecciona Subida de archivos de la lista de tipos de preguntas.
4. Configura el título de la pregunta (por ejemplo, "Sube tu currículum" o "Adjunta documentos de respaldo").
5. Establece la pregunta como obligatoria si se debe proporcionar un archivo.

Tipos de archivo soportados

NueForm acepta una amplia variedad de tipos de archivo. Por defecto, se aceptan todos los tipos de archivo comunes. Puedes restringir los tipos aceptados en las propiedades de la pregunta.

Tipos de archivo comunes

Límites de tamaño de archivo

El tamaño máximo de archivo por subida depende de tu plan de NueForm:

Cuotas de almacenamiento

Cada cuenta de NueForm tiene una cuota de almacenamiento total que cubre todos los archivos subidos en todos los formularios. Esto incluye:

• Archivos subidos por encuestados a través de preguntas de subida de archivos.
• Archivos multimedia subidos por ti en el constructor de formularios (imágenes, videos para multimedia de preguntas).

Verificar tu uso de almacenamiento

Tu uso actual de almacenamiento se rastrea en la configuración de tu cuenta. NueForm almacena el total de bytes consumidos en todas tus subidas.

Qué sucede cuando alcanzas el límite

Cuando se alcanza tu cuota de almacenamiento:

• Las nuevas subidas de archivos de los encuestados fallarán con un mensaje de error.
• Los envíos de formularios que incluyan subidas de archivos serán rechazados.
• Otros tipos de preguntas (texto, selección, valoración, etc.) no se ven afectados.
• Puedes liberar espacio eliminando respuestas antiguas con archivos adjuntos.

Cómo funciona el almacenamiento de archivos

NueForm almacena los archivos subidos en Vercel Blob Storage:

1. Cuando un encuestado selecciona un archivo, se sube directamente al almacenamiento de NueForm.
2. A cada archivo se le asigna un nombre de archivo único basado en UUID (por ejemplo, a1b2c3d4.pdf) para prevenir conflictos de nombres.
3. El nombre de archivo original se preserva en los metadatos junto al archivo almacenado.
4. La URL del archivo se almacena como el valor de respuesta en la respuesta.

El registro del archivo almacenado incluye:

Acceso a archivos subidos

En el panel de respuestas

Al ver una respuesta en el panel de NueForm, las respuestas de subida de archivos muestran:

• El nombre de archivo original.
• Un enlace de descarga para acceder al archivo.
• El tamaño del archivo.

A través de la API

Cuando recuperas una respuesta a través de la API de Respuestas, las respuestas de subida de archivos contienen la URL de almacenamiento del archivo:

{
  "questionId": "507f1f77bcf86cd799439033",
  "value": "https://storage.nueform.com/uploads/a1b2c3d4.pdf"
}

Puedes descargar el archivo realizando una solicitud GET a esta URL.

A través de webhooks

Los payloads de webhooks incluyen la URL del archivo como valor de respuesta:

{
  "event": "form.submitted",
  "formId": "...",
  "responseId": "...",
  "answers": [
    {
      "questionId": "507f1f77bcf86cd799439033",
      "value": "https://storage.nueform.com/uploads/a1b2c3d4.pdf"
    }
  ]
}

Consulta Payloads de webhooks para la referencia completa del payload.

En exportaciones CSV

Cuando exportas respuestas como CSV, las respuestas de subida de archivos aparecen como URLs en las celdas del CSV. Puedes hacer clic en estas URLs para descargar los archivos.

Configuración de propiedades de subida de archivos

En el panel de propiedades de la pregunta, puedes configurar:

Subida de múltiples archivos

Si necesitas que los encuestados suban múltiples archivos, agrega múltiples preguntas de subida de archivos a tu formulario. Cada pregunta acepta un archivo, manteniendo el envío estructurado y organizado.

Por ejemplo:

• Pregunta 1: "Sube tu currículum (PDF)"
• Pregunta 2: "Sube tu carta de presentación (PDF)"
• Pregunta 3: "Sube tu portafolio (PDF o ZIP)"

Mejores prácticas

1. Sé específico sobre qué subir. Usa el título y la descripción de la pregunta para indicar a los encuestados exactamente qué archivo necesitas, en qué formato. Por ejemplo: "Sube tu currículum como PDF (máx. 10 MB)."

2. Establece preguntas como obligatorias cuando sea apropiado. Si el archivo es esencial (por ejemplo, un currículum para solicitud de empleo), marca la pregunta como obligatoria. Si es opcional (por ejemplo, documentos de respaldo adicionales), déjala como opcional.

3. Monitorea el uso de almacenamiento. Revisa tu cuota de almacenamiento periódicamente, especialmente si tus formularios reciben un alto volumen de envíos. Actualiza tu plan si te estás acercando al límite.

4. Procesa los archivos con prontitud. Si usas webhooks para recibir URLs de archivos, descarga y procesa los archivos en tu sistema. No dependas únicamente del almacenamiento de NueForm para el archivado a largo plazo de archivos.

5. Considera las instrucciones de nomenclatura de archivos. Pide a los encuestados que nombren sus archivos de forma descriptiva antes de subirlos (por ejemplo, "Nombre-Apellido-Curriculum.pdf"), ya que NueForm preserva los nombres de archivo originales en los metadatos.

Solución de problemas

Relacionado

• Tipos de preguntas: Multimedia --- Descripción general de los tipos de preguntas relacionados con multimedia
• Payloads de webhooks --- Cómo aparecen las URLs de archivos en los datos del webhook
• Referencia de API: Respuestas --- Acceso a archivos subidos a través de la API