8.5 JSON 测试用例模板

用例较多时逐条在界面上录入效率较低。批量测试提供「模板生成 → 线下填写 → 导入」的流程:先生成带变量骨架的 JSON 模板,填写入参与预期数据后,再一次性导入为测试用例。

8.5.1 模板设置

点击工具条【模板设置】打开【JSON 模板属性设置】对话框(仅 VSCode 端可用):

alt text

  • 输入属性:决定模板中用例的入参列;预期属性:决定比对列。对象、对象集合可展开后逐层勾选字段;
  • 【生成预期属性列】:取消勾选时模板只含入参列;
  • 出参清单为空时,预期属性自动回退为入参清单,并在界面上给出提示;
  • 【添加变量/参数】:从变量集(.var)与参数文件(.ruleproject)读取候选,补充入参 / 出参清单之外的属性;
  • 【按名称 / 描述过滤】、【展开字段 / 收起字段】、【全选】、【清空】用于快速定位与批量勾选;
  • 被测文件变更后,配置中不在当前入参 / 出参清单内的属性会提示「不在此清单中」,可点击【清理无效勾选】移除;
  • 对话框底部:【确定】只保存配置,【生成模板】保存配置并按配置立即生成模板。

模板配置随 .tst 文件保存,重新打开后沿用;生成参数(勾选结果)与生成结果分离,模板骨架始终按被测文件当前的入参 / 出参清单实时生成,避免规则变更后模板与规则不一致。

8.5.2 生成模板

点击工具条【生成JSON模板】:

  • 首次生成时弹出保存对话框,默认路径为与被测文件同目录、同主名的 <规则文件>.testcases.json;
  • 生成成功后保存路径会记录到 .tst 的模板配置中,之后再次生成直接覆盖该文件,不再弹保存对话框;
  • 生成完成后横幅提示模板路径、列数与变量数;
  • 生成过程中若属性清单存在告警(如 BOM 信息缺失),会一并列出。

8.5.3 模板文件结构

{
  "version": 1,
  "target": {
    "ruleFile": "规则/评分卡示例.sca",
    "fileUuid": "0e4d4af0-b89f-49ad-8dd2-e914e5417d6d",
    "savedAt": "2026-11-09T02:30:00.000Z"
  },
  "columns": [
    {
      "path": "age",
      "scope": "input",
      "group": "客户信息",
      "label": "年龄",
      "kind": "scalar",
      "datatype": "java.lang.Integer",
      "required": true
    }
  ],
  "refSheets": [],
  "cases": [
    {
      "caseId": "1",
      "caseName": "成年客户",
      "input": { "age": 30 },
      "expected": { "resultCode": "A" }
    }
  ]
}
字段 说明
version 模板版本,当前为 1
target 模板对应的被测文件信息,导入时仅用于提示
columns / refSheets 列元数据(字段路径、类型、必填、枚举、引用表等),仅供展示与后续编辑,不参与执行
cases[].caseId 用例编号,缺省按序号生成
cases[].caseName 用例名称,导入后作为用例名称,缺省为 tst<序号>
cases[].input 输入数据,必须是 JSON 对象;为空对象的用例会被跳过
cases[].expected 预期结果,必须是 JSON 对象;缺省时该用例只有输入数据

模板同样可以用脚本或工具直接生成,只要满足上述 cases 结构即可导入。

8.5.4 导入测试用例

点击工具条【导入测试用例】:

  1. 选择 .json 模板文件(其他扩展名不支持),单个文件不超过 5MB;
  2. 文件内容上传服务端,由 /api/batchtest/importTemplate 解析并返回用例列表;
  3. 解析结果会覆盖当前测试文件中的用例列表(不是追加),导入后文件标记为已修改,需要保存;
  4. 横幅提示导入条数、来源文件名,以及解析过程中的告警(如某条用例输入为空被跳过)。

注意事项:

  • 导入只处理 cases 数据,columns / refSheets 不参与执行;
  • 若模板中未填写预期结果,导入后用例只有输入数据,执行时会被跳过(见 8.4.3);
  • 模板解析在服务端完成,浏览器端同样可以使用导入功能;
  • 读取文件失败、格式不合法或没有可用用例时,会在横幅给出具体原因。

results matching ""

    No results matching ""