8.5 JSON 测试用例模板
用例较多时逐条在界面上录入效率较低。批量测试提供「模板生成 → 线下填写 → 导入」的流程:先生成带变量骨架的 JSON 模板,填写入参与预期数据后,再一次性导入为测试用例。
8.5.1 模板设置
点击工具条【模板设置】打开【JSON 模板属性设置】对话框(仅 VSCode 端可用):

- 输入属性:决定模板中用例的入参列;预期属性:决定比对列。对象、对象集合可展开后逐层勾选字段;
- 【生成预期属性列】:取消勾选时模板只含入参列;
- 出参清单为空时,预期属性自动回退为入参清单,并在界面上给出提示;
- 【添加变量/参数】:从变量集(
.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 导入测试用例
点击工具条【导入测试用例】:
- 选择
.json模板文件(其他扩展名不支持),单个文件不超过 5MB; - 文件内容上传服务端,由
/api/batchtest/importTemplate解析并返回用例列表; - 解析结果会覆盖当前测试文件中的用例列表(不是追加),导入后文件标记为已修改,需要保存;
- 横幅提示导入条数、来源文件名,以及解析过程中的告警(如某条用例输入为空被跳过)。
注意事项:
- 导入只处理
cases数据,columns/refSheets不参与执行; - 若模板中未填写预期结果,导入后用例只有输入数据,执行时会被跳过(见 8.4.3);
- 模板解析在服务端完成,浏览器端同样可以使用导入功能;
- 读取文件失败、格式不合法或没有可用用例时,会在横幅给出具体原因。