测试单如何关联用例?执行范围与结果回写

在禅道里,测试单关联用例要解决三件事:确定这一轮执行哪些用例、把执行结果记在这张测试单上、让失败项以带来源的Bug进入修复流程。关联不是把用例复制进测试单,而是引用产品用例的某个版本。

三件事经常被混在一起:范围没定清楚,测试单越建越大;执行入口选错,结果没有落到测试单;失败后直接提Bug,来源用例为空,测试报告里的数据对不上。下面按一条完整链路拆开讲。

测试单和用例是什么关系

测试单是一次测试任务的执行记录。它有明确的构建、负责人、起止时间和用例范围,回答的是"这个版本测了什么、结果如何"。用例属于产品,是长期维护的资产,可以在多个测试单里反复使用。

测试单关联用例时,引用的是用例版本,不是复制一份新用例。关联那一刻确定版本,之后用例再修改,测试单不会自动跟着变;需要重新确认更新,否则执行的仍是关联时的步骤和预期。反过来,一份用例被多个测试单引用,各测试单的执行结果互不影响,这正对应一轮测试建一张测试单的做法。

有一个来源限制需要先知道:测试单关联的是产品下的用例。公共用例库里的用例要先导入产品用例列表,才能在关联页被选中。用例本身的写法、步骤与预期结果设置,可以参考创建测试用例。

测试工程师把多张用例卡片汇入一张测试单的2.5D等距商务插画

关联之前先确认三件事

关联页只解决"选哪些"。选不到用例,往往不是操作问题,而是前置数据没准备好。动手前核对三项。

  • 构建已创建并提交测试。测试单从构建发起,构建上关联了需求,后面才能按构建关联的需求快速筛出用例。构建没准备好,范围只能靠手工勾选,容易漏。
  • 用例已在产品下可用。确认产品、模块正确,关键用例已关联研发需求。用例是否通过评审不影响关联,但会影响预期结果能否作为判定依据。
  • 人与权限到位。测试单负责人、执行人明确,执行人有权进入测试单并执行用例。人没指派,测试单会显示有范围、没人动。

三项里缺任何一项,后面都要补做一遍,范围与结果的可解释性也会打折。

测试单如何关联用例

入口在测试单列表:找到本轮测试单,点操作里的"关联用例",进入用例选择页。完整流程可参考官方文档中的提交测试单。

  1. 先用构建和需求缩范围。关联页支持按测试单所关联构建下的需求检索用例,把"这版改了什么"直接映射成用例集合。
  2. 再用套件或模块收敛。冒烟、回归这类固定组合用测试套件筛选更快;只测某个功能域时按模块勾选。
  3. 关键字定位单条。补测、验证历史问题时,用标题关键字或编号找到目标用例。
  4. 确认版本再提交。列表默认取用例的最新版本,需要复现历史问题时可以切到之前的版本。勾选完成后保存。
  5. 回到测试单的"用例"页核对。看总数、模块分布、执行人三列,确认没有漏选或多选,再批量指派给执行人。

判断关联是否成功,不看提示语,看测试单用例页:数量与预期一致、用例版本正确、每条都有执行人。三项都对,才进入执行。

测试单关联用例的五步流程信息图:构建、测试单、关联用例、筛选、指派执行

执行范围怎么定

范围不是越多越好,它要能回答一个具体问题:这个构建能不能发。由此倒推,范围由两部分组成,本次变更直接影响的用例,以及变更可能波及的相邻功能用例。

按来源选圈定方式,比按习惯全选更稳。

四种圈定方式可以组合使用,关键是每种都能说清为什么在这个范围里。

圈定方式 适用场景 主要风险
需求锚定 迭代内有明确需求变更,按构建关联需求筛用例 需求与用例未关联时会漏
套件锚定 冒烟、回归、专项测试有固定组合 套件长期不维护会带入失效用例
模块锚定 新功能集中在少数模块,按模块勾选 跨模块影响容易漏
关键字与单条补录 Bug验证、临时补测、历史问题复现 依赖个人记忆,范围难解释

需求锚定适合做主干,套件与模块做补充,关键字只用于兜底。组合之后,范围仍要能一句话解释给开发和产品。

三条边界比技巧更重要:

  • 一轮测试一张测试单。不同构建、不同轮次的执行结果需要分开看;混在一张单里,进度和结论都会失真。
  • 只关联本轮确实要执行的用例。为了"覆盖全"把全量用例塞进来,未执行项会一直挂在进度里,测试单迟迟关不掉。
  • 本轮不测但已关联的用例,执行时选"忽略"并写原因。它比直接不记录更容易解释,也保留了评估过、决定不测的证据。

范围定完,在提测时和开发、产品对一次需求清单。测试单的范围与提测说明对得上,后面讨论能不能发才有共同依据。

执行范围决策树信息图:按需求关联、按套件关联、按模块或关键字补充

执行结果怎么回写

执行入口决定结果记在哪。推荐在测试单的"用例"页逐条执行,或勾选后批量执行,这样结果归属这张测试单,测试单状态、进度和统计才会更新。禅道21.4版本起,测试单中执行用例后会自动更新测试单状态。在产品的用例列表里单独执行,更新的是用例自身的执行记录,不会替你推进测试单。

每次执行要记录四类信息:

  • 执行结果。通过、失败、阻塞、忽略。失败表示实际结果与预期不符;阻塞表示环境、数据或依赖导致无法判定;忽略表示本轮明确不执行。
  • 步骤结果与实际结果。用例按步骤记录时,逐步标记并写下实际现象,后面复现和转Bug都靠它。
  • 结果备注与附件。日志、截图、请求响应放在这里,比留在聊天记录里更耐久。
  • 失败项的Bug。结果失败时可以直接转Bug,勾选失败步骤后重现步骤会自动带入;也可以在提Bug页面选择来源用例。这个关联决定了测试报告里的数据是否完整。

一次执行的结果会写到四个地方,各有用途。

去向 记录内容 用途
测试单 本轮状态、执行进度、通过失败统计 判断这个构建能不能发
用例 最近执行结果、执行次数、历史记录 看这条用例长期是否稳定
Bug 来源用例、失败步骤、复现信息 修复与回归时追溯原始场景
测试报告 范围、轮次、关联用例、遗留Bug 对外说明测试结论与风险

这四个去向不是重复记录,而是同一份结果在不同决策场景下的视图。回写完整时,测试报告不需要人工再拼数据;回写缺失时,报告里的Bug数、通过率就会对不上。

多轮测试要新建测试单。同一批用例在不同测试单里的执行结果相互独立,用例侧则保留每次执行的记录,既能看单轮结论,也能看一条用例跨版本的表现。执行界面的细节见执行用例。

测试团队查看测试结果汇总与报告的2.5D等距商务插画

常见问题

同一条用例能关联到多个测试单吗?

可以。各测试单的结果独立记录,用例侧累计执行次数与执行历史。回归、验收分别建单,比在一张单里反复执行更清楚。

关联错了怎么撤销?

在测试单的用例页取消关联即可。已经产生的执行记录不会随之消失,重新关联前先确认是否需要保留原结果。

测试报告里的Bug数为什么是0?

通常是Bug没有关联来源用例,或统计口径没对上。提Bug时选择来源用例,事后也可以在Bug详情里补充关联,再看报告。

执行结果能批量导入吗?

禅道不支持用CSV导入执行结果,批量场景可以通过接口写入。使用前先确认字段、权限和执行人归属,避免结果落到错误的测试单。

收尾:一轮测试的检查清单

把流程压成一张检查表,每次提测照着走一遍。

  • 关联前:构建已提交测试,需求与用例已建立关联。
  • 关联后:用例数量、版本、执行人三项与预期一致。
  • 执行中:在测试单内执行,失败项带步骤转Bug。
  • 关闭前:没有遗留的未执行用例,忽略项都有原因。
  • 出报告:测试单关联报告,遗留Bug与风险写清楚。

据51Testing《2025年软件测试行业现状调查报告》,禅道在常用测试管理工具中连续11年位列第一。工具被广泛使用,流程差异反而更值得对齐:关联决定范围,执行决定数据,回写决定这份测试结论能不能被追溯。

参考资料

  • 51Testing软件测试网,《2025年软件测试行业现状调查报告》,https://www.51testing.com/
  • 禅道官方文档,提交测试单,https://www.zentao.net/book/zentaopms/1490.html
  • 禅道官方文档,执行用例,https://www.zentao.net/book/zentaopms/896.html
  • 禅道官方文档,创建测试用例,https://www.zentao.net/book/zentaopms/108.html

文章标题 :测试单如何关联用例?执行范围与结果回写 ,发布者 :项目管理研究院

项目集管理标准第一版中文版:版本与书目信息核对
上一篇 2026年11月17日 10:18
测试报告怎么编写:结论、数据与风险提示的写作顺序
下一篇 2026年11月17日 10:34

相关推荐