-
什么是 Tag
Tag 是一种标记机制，用于标识测试用例的分类或特性。通过为测试用例添加不同的标签，可以灵活地控制测试用例的执行范围。例如，可以使用 regression 标签标记回归测试用例，使用 smoke 标签标记冒烟测试用例，使用 admin 标签标记与管理员功能相关的测试用例。-
标签命名规范
标签应简洁明了，通常与测试用例的功能模块或测试场景相关。
示例标签：
- regression：回归测试。
- smoke：冒烟测试。
- admin：管理员相关测试。
- oah：OAH 相关测试。
- api：接口测试。
-
在测试用例表中配置Tag
在测试用例表中， 有一个字段Tag， 用于配置Tag信息。可以多个Tag，用逗号“，”分隔。
假设你有一个测试用例文件
test_api_dz_tenant.xlsx，并且你只想运行带有 oah 标签的测试用例， 以下测试用例会被筛选出来| TestCaseID | LFCaseID | ScenarioDescription | Step | Description | Module | Action | Tag | Params | ParamsSetID | Priority |
| TC_OAH_API_Tenant_Base_Config_Edit | API_编辑租户基础配置 | 1 | 设置变量 | data_process | data_process | regression, api,oah | oah_body | p1 | ||
| 2 | get sign | oah_api | generate_sign | oah_sign | ||||||
| 3 | basicConfig edit | oah_api | send_request | oah_request | p1 | |||||
| 4 | validate 200 | value_validation | validate_data | { "field_name": "status_code", "actual_value": "@response.json:data.code", "operator": "equal", "expect_value": "200" } |
||||||
| 5 | validate msg | value_validation | validate_data | { "field_name": "msg", "actual_value": "@response.json:data.msg", "operator": "equal", "expect_value": "操作成功" } |
-
使用 Tag过滤测试用例
在运行测试时，可以通过
--tag-filter 参数指定一个或多个标签，只执行带有这些标签的测试用例。命令行参数说明：
--testcase-path：指定测试用例文件的路径。--tag-filter：指定标签过滤器，仅运行带有指定标签的测试用例。--env-config：指定环境配置，例如qa、prod等。
示例：
- **执行所有带有 `regression` 标签的测试用例**：
python tests/main.py --testcase-path tests/excelcases/administrator/test_admin_dz_tenant.xlsx --tag-filter regression --env-config qa- **执行所有带有 `admin` 和`smoke` 标签的测试用例**：
python tests/main.py --testcase-path tests/excelcases/administrator/test_admin_dz_tenant.xlsx --tag-filter "admin and smoke" --env-config qa- **执行所有带有 `admin` 或者`smoke` 标签的测试用例**：
python tests/main.py --testcase-path tests/excelcases/administrator/test_admin_dz_tenant.xlsx --tag-filter "admin or smoke" --env-config qa