公共用例集更新频率衡量的是统计期内公共用例集发生有效资产变更的次数,按用例条目级变更事件计数,执行记录不进入分子。要得到可复算的结果,需要同时定清三件事:哪些动作算更新、时间窗口如何归属、对象范围包含哪些用例与集合关系。本文给出一套可直接落地的口径和计算示例。
要点总览(TL;DR)
- 公共用例集更新频率统计的是统计期内公共用例资产发生有效变更的事件数,按用例条目级变更事件计数,执行记录和访问量不进入分子。
- 计入更新的动作限定为修订、补充、清理三类;执行、查看、评论、仅调整排序或标签等非实质变更不计入,新增用例数量作为规模指标单独统计。
- 时间窗口以变更事件的提交时间或生效时间二选一作为归属依据并全周期统一,常用自然月或滚动30天,同一用例多次变更按事件计还是按条目去重需事先约定。
- 对象范围限定为纳入公共用例集管理且处于生效状态的用例条目及其集合归属关系,个人草稿、私有用例、仅被引用未修改的用例排除在外。
- 公式为更新频率 = 统计期内有效变更事件数 ÷ 统计期长度,单位为次/月或次/30天;排除执行次数应在取数阶段按事件类型过滤完成,而非在报表层做减法。
这个指标到底在统计什么
公共用例集更新频率的定义是:在给定统计期内,纳入公共用例集管理的用例资产发生有效变更的事件数量,除以统计期长度。它回答的问题是“这套公共资产有没有被持续维护”,而不是“这套资产被用了多少次”。
评估目标有两个。第一,判断公共用例集是否与业务变化保持同步,例如需求调整后相关公共用例是否随之修订。第二,判断维护动作是否持续发生,避免公共用例集长期停留在建库时的状态。这个指标适合按集合、按季度或按月观察趋势,也适合在资产评审前作为背景数据。
它与执行次数、访问量的区别在于数据来源和行为性质。执行次数来自测试计划的执行记录,访问量来自页面或详情查看日志,二者反映使用热度;更新频率来自用例条目的修订、补充、清理记录,反映资产本身的变更。两类数据在系统里通常落在不同的表或不同的对象上,统计时应从取数层分开,而不是先合并再筛选。
哪些动作计入更新:修订、补充与清理
计入更新的动作限定为三类,每类都以“用例条目级变更事件”为计数单位。一次操作同时改动多个字段,按一个事件计;一次操作涉及多条用例,按实际条目数分别计。
| 动作类型 | 具体情形 | 计数单位 | 边界说明 |
|---|---|---|---|
| 修订 | 已有公共用例条目的步骤、预期结果、前置条件、优先级等实质字段变更 | 条目×变更事件 | 同一字段反复改动按事件分别计,是否合并需事先约定 |
| 补充 | 向公共用例集新增用例条目,或为已有条目新增集合归属关系 | 新增条目数或新增归属关系数 | 新增条目数量作为规模指标单独统计,不重复计入频率分子 |
| 清理 | 归档、下线、合并或删除公共用例条目 | 条目×清理事件 | 合并时被合并方计清理,保留方如同时修订则另计修订 |
不计入的动作包括:用例执行、查看详情、评论、仅调整排序、仅修改标签或非实质描述。这些动作要么属于使用行为,要么不改变用例的可执行内容。把执行记录混入分子是最常见的口径错误,表现为更新频率随测试旺季明显上升,而资产内容实际没有变化。
时间窗口怎么定:按事件时间还是按周期
时间窗口的归属依据有两个可选:变更事件的提交时间,或变更生效时间。二者选其一,并在所有统计周期内保持一致。选择提交时间适合关注维护动作发生节奏的团队;选择生效时间适合关注资产实际状态变化的团队。混用两种时间会导致同一事件在不同月份被重复计入或漏计。
窗口类型常用自然月和滚动30天。自然月便于与月度报告对齐,各月天数不同,比较时需注意2月与31天月份的差异。滚动30天消除了月长差异,适合观察连续趋势,但每次统计的起止日期都在移动,跨期对比时要固定取数日期。
窗口边界需要明确三条规则。同一用例在同一窗口内多次变更,可以按事件逐次计,也可以按条目去重计一次,两种方式都可行,但必须事先约定并在后续周期沿用。变更发生在窗口最后一天临近零点的,以系统记录的时间戳为准,不做事后调整。窗口内没有任何变更事件时,结果记为0次/月,并注明“本期无有效变更”,不用空值或横线代替,以免与数据缺失混淆。
对象范围怎么划:从用例条目到集合归属
统计对象分为三个层级:公共用例条目、条目与集合的归属关系、集合本身。频率指标的分子主要来自前两层,集合层级用于分组汇总。
| 对象 | 是否纳入 | 说明 |
|---|---|---|
| 标记为公共资产且处于生效状态的用例条目 | 纳入 | 指标的主要计数对象 |
| 公共用例条目的集合归属关系变更 | 纳入 | 新增归属计入补充,移除归属计入清理 |
| 个人草稿、私有用例 | 排除 | 未进入公共资产管理范围 |
| 仅被测试计划引用而未修改的用例 | 排除 | 引用属于使用行为,不构成资产变更 |
| 已归档或下线的条目后续被查看 | 排除 | 查看不计入,归档动作本身已计入清理 |
集合拆分与合并时,对象归属按变更后的状态处理。集合拆分为两个时,原集合中的条目归属关系发生变更,按补充和清理事件分别记录;集合合并时,被并入集合的条目归属变化计入清理与补充,条目内容未改动的部分不额外计修订。这样处理可以避免拆分合并被误读为大量内容更新。
计算步骤与公式
公式为:更新频率 = 统计期内有效变更事件数 ÷ 统计期长度,单位为次/月或次/30天。分子和分母的取数规则如下。
- 确定统计窗口的起止时间和归属依据(提交时间或生效时间),写入统计说明。
- 从变更记录中按动作类型过滤,只保留修订、补充、清理三类事件。
- 按对象范围过滤,剔除个人草稿、私有用例和仅引用未修改的记录。
- 按约定规则去重:按事件计则保留每条记录,按条目去重则同一用例同一窗口只保留一条。
- 分母取窗口长度。自然月按1计,单位为次/月;滚动30天按30天折算,单位为次/30天。
- 按集合维度统计时,分母仍取窗口长度,不除以集合内用例数;若需要人均或每百条用例的密度指标,应另设公式并单独命名。
取数环节建议把变更记录、执行记录、访问日志分开导出,在数据层完成过滤后再合并。ONES 测试管理支持编写测试用例、组织用例库,用例库中所有用例属性都支持筛选,可用于按公共资产标记和状态圈定对象范围;用例模块的树状结构和拖拽排序便于按集合组织条目。需要说明的是,公共用例集更新频率的具体取数依赖团队在系统中的实际配置,变更历史的查询与导出能力需结合现有环境核验后再确定统计方式。
一个可复算的例子
假设某公共用例集在3月内产生以下记录:修订事件18次,涉及12条用例;新增条目6条,新增集合归属关系4条;归档3条,合并2条。同期该集合关联的测试计划执行记录为240次,用例详情查看为95次。
第一步,过滤动作类型。有效变更事件为修订18次、补充10次(6条新增加4条归属)、清理5次(3条归档加2条合并),合计33次。执行记录240次和查看95次不进入分子。
第二步,选择去重规则。若按事件计,分子为33;若按条目去重,修订部分12条、补充部分10条、清理部分5条,合计27。两种结果都需在报告中注明规则。
第三步,计算频率。按事件计且窗口为自然月:33 ÷ 1 = 33次/月。若同一数据放在滚动30天窗口内,假设该30天覆盖3月2日至3月31日,恰好包含全部33次事件,则结果为33次/30天;若窗口跨月导致部分事件落在窗口外,分子相应减少,频率随之变化。
对比可以看到,如果把执行次数混入分子,结果会变成(33+240)÷1=273次/月,指标含义完全失真。这个例子也说明,排除执行次数应在取数阶段完成,而不是在报表层做减法。
结果怎么读:解读与限制
较高的更新频率可能来自业务需求变化带来的正常修订,也可能来自反复返工或口径不清导致的重复改动。解读时应结合变更原因字段或变更说明抽样查看,区分“同步业务”和“修补错误”两类情况。频率上升本身不构成质量改善的证据。
较低的更新频率不等于资产无用。部分公共用例集对应稳定业务,内容长期有效,引用次数可能很高。判断时应结合引用情况、执行覆盖和缺陷发现情况一起看,避免仅凭频率高低做结论。
这个指标不能替代用例质量与覆盖度评估。更新频率只反映变更事件的数量,不反映变更是否正确、用例是否覆盖关键场景。建议把它作为资产维护活跃度的观察项,与评审通过率、引用率等指标并列使用。
数据缺失或口径变更时,应在新周期开始时记录变更内容,并在趋势图上标注断点,不把新旧口径的数据直接连成一条曲线。历史数据无法按新口径重算的,保留原口径结果并注明,保证后续对比有据可查。
常见问题
公共用例集更新频率和用例执行次数能放在同一张趋势图里看吗?
可以并列展示,但两条曲线要分别标注数据来源和口径,不能相加或相互替代。更新频率来自用例条目的修订、补充、清理记录,执行次数来自测试计划的执行记录,二者反映的是资产维护活跃度和使用热度两类不同信息。放在同一张图里时,建议用双轴或分栏呈现,并在图注中写明各自的时间窗口和归属依据,避免读者把执行高峰误读为资产更新高峰。
同一用例在一个月内被改了五次,应该计五次还是一次?
两种计法都成立,取决于你关注的是维护动作的频次还是被维护条目的数量。按事件计保留每条变更记录,适合观察维护节奏;按条目去重则同一用例同一窗口只保留一条,适合观察有多少条资产被触及。关键是事先约定并在后续周期沿用,报告中注明所用规则。如果中途切换规则,趋势图上应标注断点,不把新旧口径的数据直接连成一条曲线。
集合拆分或合并时,条目没有改内容,更新频率会突然升高吗?
会有变化,但可以通过归属处理规则控制幅度。集合拆分时,原集合中条目的归属关系发生变更,按补充和清理事件分别记录;集合合并时,被并入集合的条目归属变化计入清理与补充,条目内容未改动的部分不额外计修订。这样处理能反映资产组织结构的变化,同时避免把拆分合并误读为大量内容更新。如果团队认为结构调整不属于内容维护,也可以在统计说明中把纯归属变更单列,不计入更新频率分子。
窗口内一条变更都没有,报表里应该写0还是留空?
建议写0次/月,并注明“本期无有效变更”。留空或画横线容易被读成数据缺失或取数失败,与真实的零变更混淆。如果是因为统计口径调整或数据源切换导致无法取数,则应单独标注为数据不可用,不与零变更混为一谈。分母为零的情况在按集合维度统计时可能出现,例如窗口内集合被整体下线,此时应说明该集合已不在统计范围内,而不是输出一个无意义的比值。
在ONES里统计这个指标,需要提前确认哪些取数条件?
ONES 测试管理支持编写测试用例、组织用例库,用例库中所有用例属性都支持筛选,可用于按公共资产标记和状态圈定对象范围;用例模块的树状结构和拖拽排序便于按集合组织条目。统计前需要确认三件事:公共用例集在系统中如何标记以区分私有用例,用例条目的变更历史是否可查询并按时间过滤,归档、合并、删除等清理动作是否留有操作记录。这些条件依赖团队的实际配置,建议先用一个小集合试算一个月的数据,核对分子与人工抽查结果一致后再推广到全量统计。


















