用途:在 TIA Portal V21 中操作 Siemens.Engineering.TestSuite API,覆盖 Application Test、Style Guide、System Test 三类测试的导入、作用域更新与执行。三类测试运行环境不同,不能共享安全假设。
主要能力:通过 project.GetService<TestSuiteService>() 获取 ApplicationTestGroup、StyleGuideGroup、SystemTestGroup;各组为单数属性,须按精确名称与预期作用域解析测试集、用例与规则集,禁止使用 .First() 或 [0]。执行器由组服务获取,如 ApplicationTestGroup.GetService<TestCaseExecutor>()、StyleGuideGroup.GetService<RuleSetExecutor>()、SystemTestGroup.GetService<SystemTestCaseExecutor>()。每次 Run(...) 返回 TestResults,需按 references/test-results.md 的递归结果门控判定,仅返回对象不代表通过。
参考文件按任务加载,不要一次全部载入:application-test.md(Application Test 集/用例、PLCSIM 执行模式、导入、作用域与执行)、style-guide.md(规则集、导入、作用域更新与执行)、system-test.md(System Test 用例、OPC UA 端点/接口、导入、作用域与执行)、test-results.md(递归结果/消息解释与通过/失败门控)。
使用方式与限制:V21 引入 Edit Test Suite 数据用户权限,导入、删除或更改测试集/用例/规则集/作用域前必须拥有该权限。导入的测试/规则文件视为不可信输入,保存前须验证文件、来源、目标对象、加载选项与最终身份。ImportOptions.Override 与作用域替换具破坏性,需明确项目写入授权及受影响对象清单。Application Test 经 PLCSIM 执行,需明确模拟器执行授权并区分系统管理与外部管理实例。System Test 使用 OPC UA,可能指向实际控制器或生产端点,需明确实时操作授权、确切 OPC UA 端点/接口、凭据与安全预期及已批准用例,不得默认其为仿真。Style Guide 执行为静态,但导入与作用域变更仍会修改项目。未请求时不要保存项目;顶层与嵌套结果状态、计数与消息全部通过门控前不得声称成功。已安装 V21 程序集/XML 可证明 API 名称、签名、类型与枚举成员;项目权限、PLCSIM 可用性/身份、OPC UA 可达性/安全性、测试副作用与实际结果需经授权运行时测试验证。其余平台、收费或价格信息暂未提供。