批量导入功能如何验收错误反馈
批量导入功能看似简单,验收时却常因错误反馈不清而反复返工:导入失败只提示“数据有误”,却不说明哪一行、哪个字段、什么原因;部分成功时又分不清哪些已入库。这类争议多源于合同中未约定错误反馈的颗粒度和判定规则。如果项目包含批量导入,签约前应把模板版本、字段校验、预览、行级错误、重复处理和整批/部分成功的区分写进验收条款,并要求保留来源编号,以便逐条核对。
模板版本与字段校验:先固定输入规则
验收前应确认导入模板的版本号和字段清单。合同中可约定:模板文件作为附件,标注版本和日期,字段名称、顺序、必填/选填、数据类型、长度限制逐项列明。导入时若模板版本与约定不符,系统应给出明确提示,而不是静默忽略。
字段校验规则要可核对:必填字段为空、数字字段含非数字字符、日期格式不符、枚举值不在允许范围等,每种情况应返回对应的行号和字段名。验收时可准备一份包含各类错误的测试文件,逐行核对反馈是否准确,避免只测“正常数据能导入”。
预览与行级错误:让问题定位到行和字段
导入前是否提供预览,应在合同中明确。若提供预览,预览内容应包含解析后的行数据、校验结果和预计处理方式(新增、更新或跳过)。预览不是正式导入,但可作为验收对象:用同一份文件对比预览结果与实际导入结果是否一致。
行级错误反馈至少应包含:来源文件中的行号或来源编号、字段名称、错误原因。来源编号指导入文件中用于标识记录的不重复值(如产品编码、客户编号),保留它便于与原始表格逐条对照。验收时可抽查若干错误行,确认反馈中的来源编号能在原文件中找到对应记录。
重复处理与部分成功:区分整批失败和部分成功
重复数据的判定依据应在合同中写明:以哪个字段或字段组合作为区分标识,重复时是跳过、更新还是报错。不同选择对应不同的验收用例。例如约定“按产品编码判重,重复则跳过并记录”,验收时需准备含重复编码的文件,核对跳过记录是否完整、原有数据是否未被误改。
整批失败与部分成功的边界要写清:什么情况下整批回滚(如模板版本错误、必填列缺失),什么情况下允许部分成功(如个别行字段校验不通过,其余行正常入库)。若允许部分成功,应提供成功行数、失败行数及失败明细,失败明细保留来源编号。验收时可分别构造整批失败和部分成功的文件,核对系统行为与约定一致。
验收用例与核对方法:可复现的记录字段
建议在合同附件中列出一组导入验收用例,每个用例记录:用例编号、测试文件说明(含错误类型)、预期结果(整批失败或部分成功)、预期错误反馈内容(行号/来源编号、字段、原因)、实际结果、核对结论。双方按同一份用例执行,减少口头解释。
核对时重点关注:错误反馈是否指向正确的行和字段;来源编号是否保留且可追溯;部分成功时成功与失败记录是否可分别导出或查看;重复处理是否符合约定。若发现反馈缺失或错误,应记录为验收遗留项,注明修复后需复测的用例编号,而不是笼统标注“导入有问题”。
