sap-cli-skill/docs/dev/test-report.md

ADT 工具集测试报告

测试目标：验证 main.py 的 create / info / download / sync / delete 五大功能在各种场景下的正确性。

测试日期：2026-05-20 | 测试脚本：test_main.py

前置条件

• SAP 系统可连接（配置文件 config.ini 正确）
• Python 3.10+ 和 requests 库已安装
• 系统中存在至少一个 Modifiable 状态的传输请求
• 系统中存在以下已有对象用于查询测试：
  • class: ZCL_SAP_MCP_HANDLER
  • report: ZIDTR_IMPORT_BOM
  • domain: ZSAPILOT_OBJECT_TYPE
  • dataelement: ZSAPILOT_OBJECT_NAME
  • table: ZSAPILOT_OBJ

---

测试覆盖矩阵

操作（行） × 对象类型（列） 的交叉覆盖情况。 ✅ = 已测试通过 | ⬜ = 不适用 | ➖ = 未覆盖（系统限制）

操作 \ 对象类型	report	class	function	functiongroup	interface	domain	dataelement	table	tabletype
create	✅ SC1	✅ SC2	✅ SC3	✅ SC3	✅ SC4	🔒	🔒	🔒	⬜
info	✅ SC1	✅ SC2	✅ SC3	✅	✅ SC4	✅ SC9	✅ SC9	✅ SC9	✅ SC9
download	✅ SC1	✅ SC2	✅ SC3	✅ SC13	✅ SC4	🔒	🔒	🔒	⬜
sync	✅ SC1,SC5	✅ SC2	✅ SC3	✅ SC13	✅ SC4	🔒	🔒	🔒	⬜
delete	✅ SC1	✅ SC2	✅ SC3	✅ SC3	✅ SC4	🔒	🔒	🔒	⬜

图例：

• ✅ 已测试通过
• ⬜ 不适用（VIT 端点不支持源码读写和锁定操作）
• 🔒 SAP 系统限制（当前目标系统 NW 7.40 的 ADT API 不支持 DDIC 对象的源码读写和创建/删除）

DDIC 对象（🔒）说明：

• info 可用（使用 Accept: */* 头），已在 SC9 验证
• create/download/sync/delete 不可用 — 经实际探测，SAP NetWeaver 7.40 的 ADT 框架对 DDIC 对象（domain/dataelement/table）不提供源码读写端点（返回 404/406）
• 在 SAP S/4HANA 或更高版本 NetWeaver 系统上，这些操作可能可用
• 代码层面已实现完整支持（URI 映射、创建模板、argparse choices 均已配置），仅受目标系统 API 限制

tabletype（⬜）说明：

• info 已可用 — 通过 VIT 端点（/sap/bc/adt/vit/wb/object_type/ttypda/object_name/{name}）查询元数据，已在 SC9 验证
• download/sync/delete 不可用 — VIT 端点为只读元数据接口，不提供源码读写和锁定操作
• create 不可用 — 无可用的集合端点用于创建新对象

---

场景测试详情

场景组 happy — 正向完整流程

核心流程：创建 → 查询 → 下载 → 修改 → 同步激活 → 验证修改 → 删除 → 验证不存在

场景 1: 正向完整流程 — report

编号	步骤	操作	验证条件	结果
SC1-1	创建 report	create --name ZTEST_SC1_RPT_xxx --type report	rc == 0	✅
SC1-2	查询验证	info --name ZTEST_SC1_RPT_xxx --type report	rc == 0 且名称匹配	✅
SC1-3	下载源码	download --name ZTEST_SC1_RPT_xxx --type report	rc == 0 且文件存在	✅
SC1-4	修改后同步激活	修改源码 → sync	语法检查通过 + 激活成功	✅
SC1-5	验证修改持久化	再次 download	源码包含修改标记	✅
SC1-6	删除对象	delete --name ZTEST_SC1_RPT_xxx	删除成功	✅
SC1-7	验证已不存在	info	rc != 0	✅

场景 2: 正向完整流程 — class

编号	步骤	操作	验证条件	结果
SC2-1	创建 class	create --name ZTEST_SC2_CLS_xxx --type class	rc == 0	✅
SC2-2	查询验证	info --name ZTEST_SC2_CLS_xxx --type class	rc == 0 且名称匹配	✅
SC2-3	下载源码	download --name ZTEST_SC2_CLS_xxx --type class	rc == 0 且文件存在	✅
SC2-4	修改后同步激活	修改源码 → sync	语法检查通过 + 激活成功	✅
SC2-5	验证修改持久化	再次 download	源码包含修改标记	✅
SC2-6	删除对象	delete --name ZTEST_SC2_CLS_xxx	删除成功	✅
SC2-7	验证已不存在	info	rc != 0	✅

场景 3: 正向完整流程 — function + functiongroup

编号	步骤	操作	验证条件	结果
SC3-1	创建函数组	create --name ZTEST_SC3_FG_xxx --type functiongroup	rc == 0	✅
SC3-2	info 验证函数组存在	info --name ZTEST_SC3_FG_xxx --type functiongroup	rc == 0 且名称匹配	✅
SC3-3	创建函数	create --name ZTEST_SC3_FG_xxx/ZTEST_SC3_FM_xxx --type function	rc == 0	✅
SC3-4	info 验证函数存在	info	rc == 0 且名称匹配	✅
SC3-5	下载函数源码	download	rc == 0 且文件存在	✅
SC3-6	首次修改 → 同步激活	修改源码 → sync	语法检查通过 + 激活成功	✅
SC3-7	再次下载验证修改持久化	download	rc == 0 且文件包含修改标记	✅
SC3-7b	验证修改内容已持久化	读取下载文件	包含 "SC3 TEST MARKER"	✅
SC3-8	二次修改 → 同步激活	替换标记 → sync	语法检查通过 + 激活成功	✅
SC3-9	info 验证函数仍存在	info --name ... --type function	rc == 0 且名称匹配	✅
SC3-10	info 验证函数组仍存在	info --name ... --type functiongroup	rc == 0 且名称匹配	✅
SC3-11	删除函数	delete 函数模块	删除成功	✅
SC3-12	info 验证函数组在函数删除后仍存在	info --name ... --type functiongroup	rc == 0（函数组独立于函数）	✅
SC3-13	删除函数组	delete 函数组	删除成功	✅
SC3-14	info 验证函数组已不存在	info	rc != 0	✅

场景 4: 正向完整流程 — interface

编号	步骤	操作	验证条件	结果
SC4-1	创建 interface	create --name ZTEST_SC4_INT_xxx --type interface	rc == 0	✅
SC4-2	查询验证	info --name ZTEST_SC4_INT_xxx --type interface	rc == 0 且名称匹配	✅
SC4-3	下载源码	download --name ZTEST_SC4_INT_xxx --type interface	rc == 0 且文件存在	✅
SC4-4	修改后同步激活	修改源码 → sync	语法检查通过 + 激活成功	✅
SC4-5	验证修改持久化	再次 download	源码包含修改标记	✅
SC4-6	删除对象	delete --name ZTEST_SC4_INT_xxx	删除成功	✅
SC4-7	验证已不存在	info	rc != 0	✅

---

场景组 error — 逆向错误处理

场景 5: 逆向 — 语法错误

编号	步骤	操作	验证条件	结果
SC5-1	创建 report	create	rc == 0	✅
SC5-2	下载源码	download	rc == 0 且文件存在	✅
SC5-3	注入无效语法 → 同步	添加 INVALID_SYNTAX_HERE. → sync	rc != 0 且包含错误信息	✅
SC5-4	恢复源码 → 重新同步	还原源码 → sync	rc == 0 + 激活成功	✅
SC5-5	清理删除	delete	删除成功	✅

场景 6: 逆向 — 对象不存在

编号	步骤	操作	验证条件	结果
SC6-1	查询不存在的 class	info --name Z_NOT_EXIST_99999 --type class	rc != 0 且包含"不存在"	✅
SC6-2	下载不存在的 report	download --name Z_NOT_EXIST_99999	rc != 0	✅
SC6-3	删除不存在的 report	delete --name Z_NOT_EXIST_99999	rc != 0	✅

场景 7: 逆向 — 重复创建

编号	步骤	操作	验证条件	结果
SC7-1	首次创建	create --name ZTEST_SC7_RPT_xxx	rc == 0	✅
SC7-2	重复创建 → 报错	再次 create 同名对象	rc != 0	✅
SC7-3	清理删除	delete	删除成功	✅

---

场景组 edge — 边界场景

场景 8: 边界 — 同步自动创建

编号	步骤	操作	验证条件	结果
SC8-1	准备本地源码	创建 .abap 文件	文件存在	✅
SC8-2	sync 自动创建	sync 不存在的对象	rc == 0（自动创建）	✅
SC8-3	info 验证存在	info	rc == 0 且名称匹配	✅
SC8-4	清理删除	delete	删除成功	✅

场景 9: 边界 — DDIC 对象查询

编号	步骤	操作	验证条件	结果
SC9-1	info domain	info --name ZSAPILOT_OBJECT_TYPE --type domain	rc == 0 且名称匹配	✅
SC9-2	info dataelement	info --name ZSAPILOT_OBJECT_NAME --type dataelement	rc == 0	✅
SC9-3	info table	info --name ZSAPILOT_OBJ --type table	rc == 0	✅
SC9-4	info tabletype	info --name ZSAPILOT_OBJECT_TT --type tabletype	rc == 0 且名称匹配	✅

场景 10: 边界 — 删除安全确认

编号	步骤	操作	验证条件	结果
SC10-1	创建 report	create	rc == 0	✅
SC10-2	delete 输入 no → 取消	delete stdin="no"	输出包含"已取消"	✅
SC10-3	info 验证仍存在	info	rc == 0 且名称匹配	✅
SC10-4	delete 输入 yes → 成功	delete stdin="yes"	删除成功	✅
SC10-5	info 验证已不存在	info	rc != 0	✅

场景 13: 边界 — functiongroup 不支持源码操作

编号	步骤	操作	验证条件	结果
SC13-1	download functiongroup → 报错	download --name ZIDT_MCP_TOOL --type functiongroup	rc != 0 且包含"不支持"	✅
SC13-2	sync functiongroup → 报错	sync --name ZIDT_MCP_TOOL --type functiongroup	rc != 0 且包含"不支持"	✅

---

场景组 existing — 已有对象操作

场景 11: 已有对象查询

编号	步骤	操作	验证条件	结果
SC11-1	info 已有 class	info --name ZCL_SAP_MCP_HANDLER --type class	rc == 0 且名称匹配	✅
SC11-2	下载已有 class	download --name ZCL_SAP_MCP_HANDLER	rc == 0 且文件存在	✅
SC11-3	同步无修改 → 成功	sync（源码未修改）	语法检查通过 + 激活成功	✅

---

场景组 config — 配置与环境

场景 12: 配置与环境

编号	步骤	操作	验证条件	结果
SC12-1	默认配置运行	download（使用 config.ini）	rc == 0	✅
SC12-2	无效 SAP_HOST	设置 SAP_HOST=http://invalid:9999	rc != 0	✅

---

测试统计

按场景组统计

场景组	场景数	步骤总数	✅ 通过	❌ 失败	通过率
happy（正向完整流程）	4	36	36	0	100%
error（逆向错误处理）	3	11	11	0	100%
edge（边界场景）	4	14	14	0	100%
existing（已有对象）	1	3	3	0	100%
config（配置环境）	1	2	2	0	100%
合计	13	66	66	0	100%

失败项分析

本次测试全部通过，无失败项。

测试过程中发现并修复的问题

#	问题	修复内容
1	下载文件含 \r\r\n 双重回车	保存前统一换行符 source.replace("\r\n", "\n")
2	lock() 未传 corrNr 导致写入冲突	lock() 增加 corr_nr 参数
3	activate() 误判 inactiveObjects 为成功	新增 Content-Type 检测，正确处理 inactiveCtsObjects 响应
4	activate() 使用 preauditRequested=true 导致激活失败	移除该参数
5	_headers() 硬编码 Accept-Language: EN	移除硬编码，使用 SAP 系统登录语言
6	cmd_sync 交互式等待用户输入	改为非交互式，报错直接退出
7	cmd_sync 缺少语法检查步骤	新增 syntax_check() 方法，激活前先做语法检查
8	cmd_sync 对象不存在时直接退出	改为自动创建空对象后继续同步流程
9	create 缺少 interface 默认模板	新增 interface 模板到 DEFAULT_TEMPLATES
10	parse_object_name 对 functiongroup 崩溃（src_uri 为 None）	增加 if config["src_uri_template"] else None
11	cmd_info 缺少名称校验	新增查询结果名称与请求名称的对比校验
12	cmd_info function 名称校验失败	用 split("/")[-1] 取实际对象名进行校验
13	DDIC 对象 info 查询 Accept 头不正确	改用 */* Accept 头