跳到主要内容
FormFlow

从 CSV 或 Excel 导出文件导入过往提交

所有者可以通过 CSV 或 Excel 导出文件,把在别处收集的提交导入表单。将各列与表单字段对应,指定日期列,这些行就会带着原始日期、以已读且已处理的状态进入表单,不计入套餐的用量,也不触发通知和集成。

本文由机器翻译。 阅读英文原文

A dark plate titled 'Import past Submissions from a CSV or Excel export', listing that each row keeps its original date, arrives already read and handled, never counts towards your plan, and sends no notifications or integrations.

迁移到 FormFlow 的团队,通常会把历史数据留在另一个表单服务的导出文件里。所有者可以通过 CSV 或 Excel 文件把这些行导入表单,让旧的线索与新线索放在一起。导入功能随版本 v1.81.0 推出;用来把每一列对应到字段的列对应功能,则随 v1.83.0 推出。

导入的提交是什么

  • 它保留最初发送时的日期,该日期取自你指定的列。

  • 它进来时就已经是已读且已处理的状态。

  • 它可以像其他提交一样被搜索和导出。

  • 它从不计入你的套餐用量,不发送通知,也不会到达任何集成。它不会被投递或通过电子邮件发送到任何地方。

  • 无法向它发送回复。旧导出文件中的人从来不是通过 FormFlow 收集的,因此 FormFlow 拒绝向他们发信。

开始之前

  • 你必须是团队的所有者。其他角色看不到这个操作。

  • 表单不能是评分表单,也不能是只接纳名册成员的表单。导入的行既没有分数也没有席位,因此这些表单上会隐藏该操作。

  • 文件是 .xlsx 工作簿或 .csv 文件,最大 2 MB。第一行必须是列标题,且任意两个标题不能相同。末尾的空列会被忽略。

  • 必须有一列保存每一行的原始日期。对话框默认这一列叫 submitted_at,你可以更改。

  • 一个表单最多可以累计容纳 5,000 条导入的提交,单次上传写入的数量也不会超过这个数。

导入文件

  1. 打开表单的编辑页面,选择“导入过往提交”。

  2. 在“提交记录电子表格”下选择你的文件。FormFlow 会立即读取它的标题;如果读取不了,你会看到“导入失败”以及“无法读取该文件,或其中两列的表头相同。请重新导出后再试。”

  3. 在“将列与字段对应”下,文件中的每一列都显示为“文件中的列”,旁边是“导入到”的选项。表头与字段名完全一致的列已经选好。对于其余的列,请选择表单的字段,或选择“不导入此列”。

  4. 在“日期列”中,输入保存每一行原始日期的那一列的表头。

  5. 提交对话框。通知会告诉你导入了多少条提交,以及哪些内容被排除在外。

两列不能填入同一个字段。文件字段完全不能对应任何列,因为附件无法放进电子表格的单元格里。这种对应只对本次上传有效;下一次上传会重新从表头开始。

日期如何解析

  • 日期必须明确写出年、月、日,例如 2026-03-05 或 05 Mar 2026。开头的星期几会被忽略。“昨天”这样的词语以及单独的年份都不被接受。

  • 没有时区的日期按 UTC 解析,因此同一个文件每次导入得到的时刻都相同。

  • 日期列中真正的 Excel 日期单元格会被直接当作日期使用。

  • 日期在未来的行不会被添加。

  • 早于表单保留期的行不会被添加,因此导入无法找回表单本来就已经删除的内容。参见v1.18:决定表单保留提交多久。

阅读导入摘要

通知会显示“已导入 12 条提交”,并可能附加下列任一说明:

  • N 行已导入或在文件中重复。

  • N 行被排除在外——此表单已达到导入上限。

  • 未导入的列:你排除的标题,或与任何字段都不匹配的标题(最多列出十个)。

  • 未添加的行:行号,最多十个,按电子表格中的方式计数,表头是第 1 行。出现以下情况时,该行会被拒绝:日期无法解析、日期在未来或早于保留期、所有已对应的单元格都为空,或包含不是 UTF-8 的文本。最后一种情况通常由 Windows-1252 编码的导出文件引起;请重新以 UTF-8 导出。

有些问题会让整个导入中止,并且不写入任何内容:文件无法读取、标题重复、缺少日期列(“该工作表缺少所需的 submitted_at 列。”),以及列对应与表单的字段不再匹配(“导入被拒绝”)。

再次上传同一个文件

第二次上传不会添加任何内容。FormFlow 通过一行中的每个单元格(按表头)连同它的日期来识别这一行,因此无论采用哪种对应、无论列的顺序如何,同一行都只会导入一次。这也意味着,所有单元格和日期都完全相同的两行会被算作一行。如果你确实有完全相同的行,请查看摘要中“在文件中重复”的行数。

需要了解的限制

  • 文件在同一个请求中读取,之后无论发生什么都会被删除。FormFlow 不会保留它。

  • 单元格的值会作为文本进入你选择的字段。字段列中仅含日期的 Excel 单元格会变成它的日期;其他日期单元格则保留时间。

  • 只有所有者可以导入,而且只能导入到没有评分、也没有名册的表单中。

如需把提交(包括导入的提交)再导出来,参见只导出你需要的列和提交。如需先根据电子表格生成表单的问题,再导入它们的答案,参见根据问题电子表格创建表单。

把你的第一个表单指向 FormFlow。

无需搭建后端,无需托管前端。

免费开始