数据导入字段怎么设计？映射、校验与纠错

数据导入页面先给用户一个可检查的字段映射，再处理错误。把供应商表格导入采购台账时，建议按“选择文件→确认列对应关系→导入→处理异常”推进；列名不匹配时指出具体列和示例值。借助Pixso 的页面布局与组件能力，可以把这条路径画成可评审原型，先验证信息是否足够再交付开发。

先建立字段映射契约

映射页同时展示源列名、目标字段、示例值和必填状态。默认匹配只能作为建议，不能替用户确认含义相近但单位不同的列。例如“金额”要明确币种，“日期”要说明时区或格式。保留一个未映射区，让用户知道还有哪些列尚未处理。

准备一份小样本：供应商编号 0001、0037，账期分别是“月结 30 天”和“30”，同一币种列的两行分别写“人民币”和“CNY”。页面不能因为两个值都像文字就认为正确。编号按文本预览，账期需要明确目标是天数，币种用可读名称与代码配对。若把带前导零的编号读成数字，预览中就要暴露变化，而不是入库后才发现。

同一个目标字段通常只接一列。用户第二次选择相同目标时，指出已有映射并让其替换；空列和备注列可以选择“不导入”。只有主键、业务必填和格式都具备时，才允许继续。必填限制要写在字段旁，不能只靠禁用按钮让人猜原因。

错误要定位到列和行

整批只显示“导入失败”会迫使用户重新猜原因。把错误分为格式错误、必填缺失和重复记录，并在列标题、行号和单元格之间保持同一标记。错误摘要显示“20 行有问题”，点击后滚到第一处；仍要保留下载错误清单或逐行修正的路径。

例如原文件第 37 行的结算币种写成“元”，错误清单保留原始行号、原值、目标字段和“请选择 CNY 或其他支持币种”。即使用户按错误类型排序，行号也不能变成新的表格序号，否则回到文件中会找错位置。日期“03/04”有多种解释，不能自动猜成 3 月 4 日再用绿色提示掩盖风险。

少量错误适合在线改值，几十行相同格式错误更适合下载清单后统一修正。这两条路径要回到同一个批次，保留已经确认的映射。GOV.UK 的文件上传规范也区分文件类型、大小、空文件等具体错误；数据内容错误发生在上传之后，应在对应步骤解释。

部分成功要说清边界

如果 980 行中 960 行有效，页面应明确已写入的范围、未写入的范围和下一步。不要把部分成功画成全绿，也不要让用户再次上传整份文件而丢失已完成结果。重新导入前提示重复策略：覆盖、跳过或生成新记录，由业务规则决定并在界面中明示。

本例把 980 行划成 960 行已导入和 20 行未导入，两组必须互斥，数量相加能回到总数。如果有 5 行因编号已存在而跳过，则结果改为“955 行已导入、5 行跳过、20 行有误”。不要在成功数量里再次算入跳过项。点击每个数量都应能看到相应明细。

如果业务要求整批一致，例如一张不可拆分的结算凭证，选择整批回滚更合适；此时应显示“未写入任何记录”，保留错误清单供修正。整批与部分导入的取舍要在确认页公开，不能由用户从最后的结果倒推。

重试前做三项检查

1. 筛选错误清单，确认每一行对应的目标字段。
2. 修正格式后保留原始列，避免复制粘贴改变值。
3. 再次导入后核对新增、跳过和失败数量。

重试文件如果包含已经成功的 960 行，需要沿用批次和唯一编号检查，不能因为文件名变了就全部新增。用户改了映射后再重试，也要重新运行格式校验；旧的“通过”状态不自动继承。界面至少准备“已确认未写入，可以重试”和“正在确认写入结果，请稍后查看”两种反馈，避免让提交超时变成重复数据。

在 Pixso 中排列映射页、部分成功页和修正页，逐一标出原始行号和批次编号；评审时从第 37 行错误走到再次导入结果，确认每次返回都保留了必要信息。文件上传与网络重试的完整路径，可继续参考文件上传失败的处理方法。