测试用例导入导出如何检查字段和层级映射

测试用例导入导出前,字段和层级要分两条线并行核对:字段线看值是否落进正确的字段、类型和枚举是否匹配;层级线看目录、模块、用例、步骤的父子关系与顺序是否还原。做法是先建对照基线,再逐项检查字段和层级,然后用小样本试导入并回读比对,全部通过后再批量执行。下文按这一顺序给出可直接套用的检查表、判定标准和角色分工。



要点总览(TL;DR)


  • 检查字段和层级映射要分两条线并行:字段线核对值是否落进正确字段、类型与枚举是否匹配;层级线核对目录、模块、用例、步骤的父子关系与顺序是否还原。
  • 先建两份基线清单:字段对照表逐项写清源字段、目标字段、类型、必填、枚举与长度;层级对照表写清层级表达方式、挂载位置、步骤归属与排序规则。
  • 字段检查重点处理同义字段错配、类型转换、必填缺失、枚举静默落空和长文本截断;层级检查重点处理重名挂错、孤立节点、顺序丢失和深度超限。
  • 用覆盖各层级与各字段类型的少量样本试导入,以目标库实际存储值逐条回读比对,差异全部可解释后再批量执行。
  • 批量放行需满足四项:字段对照表无未处理项、层级异常已清零或登记、试导入回读通过、回滚备份方案就绪。


先建立字段与层级的对照基线


检查映射的第一步是把“源文件长什么样”和“目标库要求什么”同时摊在桌面上,形成两份可逐行勾选的清单。没有基线,后面的核对只能凭印象,容易漏项。基线建立由测试资产负责人牵头,执行人整理源文件,两人共同确认口径。


字段对照表建议包含以下列,逐字段填写:


源字段名 源类型/示例值 目标字段名 目标类型 是否必填 枚举/取值范围 长度限制 对应结论
用例标题 文本,如“登录-密码错误” 用例名称 文本 是 — 200字符 直接对应
优先级 文本,高/中/低 优先级 枚举 是 P0/P1/P2/P3 — 需值映射
模块路径 文本,“登录/异常场景” 所属目录 层级引用 是 — — 转层级处理

层级对照表则描述结构规则,至少写清四件事:目录与模块是否同一概念、用例挂在哪个层级下、步骤是用例的子项还是独立表、同级节点按什么排序。同时标注源文件中表达层级的方式——是用路径列(如“A/B/C”)、父子ID列,还是靠缩进和空行暗示。


两份清单完成后,把所有无法一一对应的项单独列出,例如源文件有“自动化脚本路径”而目标库无此字段、源文件层级有四级而目标库只支持三级。这些待处理项是后续章节的输入,不能留到批量导入时再临时决定。



字段映射的逐项检查步骤


字段检查的目标是确认每个源值都能落到正确位置且不改变含义。按下面五项逐条过,每项在检查记录里写下结论和待修正项。


字段名与别名对应


先处理同义字段错配,这是最常见的问题。“用例名称”“标题”“摘要”可能指向同一字段,“预期结果”和“期望结果”也可能是同一个。检查方法是拿源表头逐个在目标字段清单里找唯一对应项,找不到或有多个候选的,由测试资产负责人裁定,不允许执行人自行猜测。裁定结果写回字段对照表。


类型转换核对


逐字段确认源值与目标类型的兼容性:文本转数字要确认无单位、无千分位;日期要统一格式并确认时区口径;布尔值要确认源文件用的是什么表达(是/否、Y/N、1/0);多选字段要确认分隔符,逗号、分号、竖线在目标库中是否被识别。类型不兼容的字段要么在导入前清洗源文件,要么在导入工具中配置转换规则,二者选其一并记录。


必填字段缺失处理


把目标库的必填字段列出来,逐条检查源文件是否每行都有值。缺失时只有两种合规处理:从源系统补齐,或按事先约定的默认值填充并登记。默认值策略要写进检查记录,例如“优先级缺失统一填P2”,避免同一批数据出现多种填法。必填字段用默认值填充后,回读时要能识别出哪些是原始值、哪些是补的。


枚举值与状态字段对照


枚举错配不会报错,只会静默落成空值或默认项,因此要单独建一张取值对照表。例如源文件“高/中/低”对应目标库“P0/P1/P2”,源文件“通过/失败/阻塞”对应目标库的状态枚举。检查时把源文件中出现过的所有枚举值去重列出,逐个给出目标值,没有对应项的明确处理方式(映射到某一项或标记为待定)。


超长文本与特殊字符


步骤描述、前置条件这类长文本要检查长度上限,超出部分是被截断还是导入失败,需在试导入中确认。换行符在目标库中是否保留、制表符和引号是否需要转义、中文标点是否正常,都属于这一项。建议在源文件中先筛出长度接近上限的记录,单独标记。



层级映射的还原检查步骤


层级检查回答的是“父子关系有没有挂对、顺序有没有乱”。字段对了但层级错了,用例会出现在错误的模块下,检索和复用都会受影响,因此这一章与字段检查同等重要。


确认层级的表达方式与唯一标识


先判断源文件用哪种方式表达层级。路径列方式下,每一行自带完整路径,还原时按分隔符拆分逐级建目录;父子ID方式下,每行有自身ID和父ID,需要先校验父ID是否都存在、有无循环引用。无论哪种方式,都要确认每个节点有稳定唯一标识,同名节点靠ID区分,不能只靠名称。


同级重名与跨级重名


两个模块都叫“登录”但分属不同父目录时,仅按名称匹配会把用例挂错位置。检查方法是统计每个层级下名称的重复情况,重复的节点在对照表中标注完整路径加以区分。跨级重名(如一级目录“支付”和三级目录“支付”)同样要按完整路径核对。


顺序号与节点完整性


用例内步骤的顺序直接影响执行,检查源文件是否有步骤序号列,导入后序号是否保留、有无重排。同时识别两类异常节点:空层级(路径中出现连续分隔符或空名称)和孤立节点(父ID指向不存在的记录)。孤立节点不能静默丢弃,要列入异常清单,由负责人决定挂到根目录还是补齐父级。


层级深度超出限制


目标库对目录深度通常有上限。源文件层级更深时,处理方式有两种:把超出部分合并到最末一级,或将末段并入用例名称。选定一种后要在对照表中写明规则,并抽查若干条确认合并后仍可辨识。深度问题属于结构性差异,应在试导入前解决,不能依赖导入工具自动截断。



小样本试导入与回读校验


静态对照能发现大部分问题,但类型转换、截断、默认值填充这些行为只有实际导入后才看得清楚。试导入的作用就是用最小代价暴露这些问题。


样本选取要覆盖三类情况:每个层级至少一条(含最深一级)、每种字段类型至少一条、每个已识别的异常项至少一条。样本量不必大,十几到几十条即可,但覆盖面要全。


试导入后逐条回读,把源值和目标值并排比对,重点记录四类差异:值丢失(导入后为空)、值错位(落到了别的字段)、值被截断(长文本尾部缺失)、值被默认值替换(原始值被覆盖)。回读时不要只看导入工具的提示信息,要以目标库中实际存储的内容为准。


通过标准是:所有样本的字段值与层级关系一致,或存在的差异已逐条解释并确认可接受。差异可解释指有明确原因且不影响后续使用,例如某字段目标库不存储、已在对照表中登记。存在无法解释的差异时,回到字段或层级检查步骤修正,再重新试导入。



角色分工与交付物


检查工作涉及口径裁定、实际操作和独立复核,三类职责分开,避免执行人自己核对自己。


角色 主要职责 产出物
测试资产负责人 确定字段与层级口径,裁定同义字段、枚举映射、深度合并等争议项 字段对照表、层级对照表的最终版本
执行人 整理源文件、清洗数据、执行试导入与回读 字段映射检查记录、层级异常节点清单、试导入比对结果表
复核人 独立回读比对,确认差异均已解释,签字放行 复核意见与确认记录

小团队可以由两人分担,但复核动作要独立完成。交付物统一归档在测试资产库的同一位置,便于批量导入时追溯。


在ONES测试管理模块中,用例库的目录结构与自定义字段配置可以直接作为目标库口径的来源:负责人从字段配置和目录树导出目标清单,执行人按清单整理源文件,试导入后的用例在库中逐条查看所属目录与字段值,复核人依据同一份清单核对。这样对照表、检查记录与实际库结构保持同一口径,减少口头确认带来的偏差。



示例:一次模块层级与字段的核对过程


以下为演示情景,用于说明核对动作如何落地。


某批用例从表格文件导入测试库,源文件含“模块路径”“用例标题”“优先级”“步骤描述”四列,模块路径形如“订单/下单/优惠券”。目标库目录为三级,优先级枚举为P0至P3,步骤描述上限500字符。


对照后发现三处差异:源文件优先级写作“高/中/低”,需映射为P1/P2/P3;有两条记录的模块路径为“订单/下单/优惠券/叠加规则”,深度为四级,超出目标库限制;一条步骤描述长620字符,超出上限。


修正方式:优先级按对照表批量替换;四级路径按事先约定合并为“订单/下单/优惠券”,原末级名称写入用例标签;超长步骤描述拆分为步骤描述与备注两段。修正后选取覆盖三个层级、四种优先级的12条样本试导入,回读确认目录归属正确、优先级全部落位、拆分后的文本完整,差异清零后放行批量导入。



完成检查与批量执行条件


批量执行前逐项核对下面的放行清单,全部满足才可开始,任何一项未完成都先处理再放行。


  • 字段对照表无未处理项:每个源字段都有唯一目标字段或明确的丢弃/合并结论,枚举映射表完整。
  • 层级异常节点已清零或已登记:孤立节点、空层级、重名节点均有处理结果,深度超限的记录已按规则合并。
  • 试导入回读全部通过:样本覆盖各层级与各字段类型,差异均已解释并记录。
  • 回滚或备份方案已就绪:批量导入前对目标库现有用例做导出备份,明确失败时的恢复方式与责任人。

清单由执行人自检、复核人确认,两项签字完成后进入批量执行。批量导入后建议再抽取少量记录回读一次,确认批量处理与试导入行为一致。



常见问题


源文件里没有步骤序号列,导入后步骤顺序怎么保证?


先确认目标库对步骤顺序的存储方式:若按行序保存,导入前在源文件中按预期执行顺序排列行,并保持同一用例的步骤连续、不与其他用例交错;若目标库有显式序号字段,则在源文件中补一列序号再导入。无论哪种方式,试导入时都要抽取含多步骤的用例回读,确认顺序与源文件一致。源文件本身顺序混乱时,应先由用例作者确认正确顺序,不能依赖导入工具自动排序。


同一批数据里既有路径列又有父子ID列,以哪个为准?


两列同时存在时,先判断两者是否一致:逐行比对路径拆分结果与父子ID推导出的层级,一致的部分正常处理,不一致的行单独列出。由测试资产负责人确定以哪一列为准,通常以能完整还原父子关系、且唯一标识稳定的一列为准,另一列作为校验参考。确定后把规则写进层级对照表,避免执行人逐行临时判断。不一致的行在修正前不进入批量导入。


目标库的必填字段在源文件中大面积缺失,还能导入吗?


可以导入,前提是先确定合规的填充策略并登记。两种处理方式:从源系统或其他记录中补齐真实值;或按事先约定的默认值填充,并在检查记录中写明字段、默认值和适用行范围。大面积缺失时建议先小批量试导入,回读确认默认值落位正确、且能与原始值区分。若某必填字段的默认值会影响后续执行判断(如优先级、用例类型),应由测试资产负责人确认后再使用,不能由执行人自行设定。


批量导入后发现个别用例挂错目录,如何补救?


先依据试导入比对结果表和层级对照表定位错挂范围:是重名节点导致的批量错挂,还是个别孤立节点的处理偏差。范围明确后,在目标库中按完整路径逐条调整所属目录,并回读确认。若错挂量大,优先使用批量导入前的备份恢复到导入前状态,修正层级规则后重新导入,避免逐条手工调整引入新的不一致。补救完成后,把该问题补入层级对照表的待处理项记录,供后续批次复用。


导出再导入到另一个用例库时,检查重点和首次导入有什么不同?


导出再导入时,源文件结构通常已经带有目标系统的字段痕迹,字段名错配的概率降低,但两类问题会更突出:一是导出时被扁平化的层级(如路径被合并进名称列),需要在导入前重新拆分为层级列;二是导出文件中包含系统生成的只读字段(如创建人、创建时间、内部ID),这些字段在目标库中不可写,需在对照表中标记为丢弃。检查顺序不变,仍按建基线、对字段、对层级、试导入执行,只是字段对照表要额外增加一列“是否可写”。