文件上传

NueForm 的文件上传问题类型允许填写者在提交表单时附加文件。本指南介绍如何设置文件上传、配置限制以及访问上传的文件。

设置文件上传问题

1. 在 NueForm 构建器中打开您的表单。
2. 点击 + 按钮添加新问题。
3. 从问题类型列表中选择 文件上传。
4. 配置问题标题（例如"上传您的简历"或"附加支持文件"）。
5. 如果必须提供文件，将问题设为必填。

支持的文件类型

NueForm 接受多种文件类型。默认情况下接受所有常见文件类型。您可以在问题属性中限制接受的类型。

常见文件类型

文件大小限制

每次上传的最大文件大小取决于您的 NueForm 套餐：

存储配额

每个 NueForm 账户都有一个总存储配额，涵盖所有表单中上传的所有文件。这包括：

• 填写者通过文件上传问题上传的文件。
• 您在表单构建器中上传的媒体文件（图片、问题媒体视频）。

查看存储使用情况

您当前的存储使用情况可在账户设置中查看。NueForm 跟踪您所有上传的总字节数。

达到限制时会发生什么

当存储配额已满时：

• 填写者的新文件上传将失败并显示错误消息。
• 包含文件上传的表单提交将被拒绝。
• 其他问题类型（文本、选择、评分等）不受影响。
• 您可以通过删除包含文件附件的旧响应来释放空间。

文件存储的工作原理

NueForm 将上传的文件存储在 Vercel Blob Storage 中：

1. 当填写者选择文件时，文件会直接上传到 NueForm 的存储。
2. 每个文件被分配一个基于 UUID 的唯一文件名（例如 a1b2c3d4.pdf）以避免命名冲突。
3. 原始文件名保留在元数据中与存储文件一起保存。
4. 文件的 URL 作为答案值存储在响应中。

存储的文件记录包含：

访问上传的文件

在响应仪表板中

在 NueForm 仪表板中查看响应时，文件上传答案会显示：

• 原始文件名。
• 访问文件的下载链接。
• 文件大小。

通过 API

通过响应 API检索响应时，文件上传答案包含文件的存储 URL：

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

您可以通过向此 URL 发送 GET 请求来下载文件。

通过 Webhooks

Webhook 载荷中将文件 URL 作为答案值包含：

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

参阅 Webhook 载荷了解完整的载荷参考。

在 CSV 导出中

将响应导出为 CSV 时，文件上传答案在 CSV 单元格中显示为 URL。您可以点击这些 URL 下载文件。

配置文件上传属性

在问题属性面板中，您可以配置：

多文件上传

如果需要填写者上传多个文件，请在表单中添加多个文件上传问题。每个问题接受一个文件，使提交保持结构化和有序。

例如：

• 问题 1："上传您的简历（PDF）"
• 问题 2："上传您的求职信（PDF）"
• 问题 3："上传您的作品集（PDF 或 ZIP）"

最佳实践

1. 明确说明要上传的内容。 使用问题标题和描述准确告知填写者需要什么文件、什么格式。例如："请上传您的简历，PDF 格式（最大 10 MB）。"

2. 适当设置必填。 如果文件是必需的（例如求职简历），将问题标记为必填。如果是可选的（例如额外支持文件），则保持可选。

3. 监控存储使用情况。 定期检查存储配额，特别是提交量大的表单。如接近限制，请升级套餐。

4. 及时处理文件。 如果使用 Webhooks 接收文件 URL，请在您端下载并处理文件。不要仅依赖 NueForm 的存储进行长期文件归档。

5. 在说明中提及文件命名。 要求填写者在上传前为文件使用描述性名称（例如"姓名-简历.pdf"），因为 NueForm 会在元数据中保留原始文件名。

故障排除

相关文档

• 问题类型：媒体 --- 媒体相关问题类型概述
• Webhook 载荷 --- 文件 URL 在 Webhook 数据中的呈现方式
• API 参考：响应 --- 通过 API 访问上传的文件