关于 advpr-test-automation
为 TOTVS Protheus 业务规则回归测试提供 ADVPR 编写与运行指南。帮助开发者按例程类型选择测试模式、组织 TestSuite,并为无界面执行准备代码。
主要功能
- 01FWTestHelper 断言
- 02TestSuite 组织
- 03界面与无界面执行
- 04各类例程测试模式
- 05无界面执行准备
适用场景
- 01创建或调试 ADVPR 脚本
- 02设置 TestSuite
- 03诊断无界面执行超时
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ thalysjuvenal/ advpl-specialist --skill advpr-test-automation安装后在 Claude Code 中输入/advpr-test-automation确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
api-fwtesthelper.mdbest-practices.mdgps-de-testes.mdpatterns-execauto.mdpatterns-mvc.mdpatterns-processing.mdpatterns-reports.mdpatterns-routine-prep.mdpatterns-smartlink.mdpatterns-smartview.mdpatterns-totvs-message.mdpatterns-webservice.mdreference.md详细介绍
ADVPR — Protheus 自动化测试
此技能介绍如何使用 ADVPR(基于 ADVPL 的内部测试机器人)编写和运行 TOTVS Protheus 业务规则回归自动化测试。内容包括 FWTestHelper 断言 API、如何在 TestSuite(GPS de Testes)中注册和组织测试用例、如何通过 UI(FWMyTestRunner)或无头模式(FwExecSuite)运行测试套件,以及针对 MVC、ExecAuto/MSExecAuto、报表、处理例程、Web 服务(REST/SOAP/Portal)、SmartLink、Smart View 和 TOTVS Message(单消息)流程等例程模式的脚本编写指南。内容还涵盖“例程准备”——调整旧版代码,使其能在官方无头执行期间无屏幕运行——以及 ADVPR 脚本编写的一般最佳实践。
当用户希望创建或调试 ADVPR 测试脚本、设置 TestSuite、诊断无头执行期间的 TimeOut 或意外屏幕故障,或需要了解某种例程类型适用哪种 ADVPR 模式时,请启用此技能。此技能不涵盖手动或基于界面的 QA、ADVPR 之外孤立 ADVPL 函数的单元测试,也不涵盖与测试自动化无关的运行时或编译错误的一般调试(请参阅 advpl-debugging)。
所引用的文件以巴西葡萄牙语编写。
| 参考文件 | 阅读时机 |
|---|---|
| reference.md | 始终阅读——ADVPR 概念、补丁前提、FWMyTestRunner 与 FwExecSuite 无头执行方式、TimeOut 原因 |
| api-fwtesthelper.md | 编写断言或预期时——完整的 FWTestHelper 方法参考 |
| best-practices.md | 审查或编写 ADVPR 脚本时——推荐的脚本编写规范 |
| gps-de-testes.md | 创建或组织 TestSuite 及其测试用例(GPS de Testes)时 |
| patterns-execauto.md | 自动化通过 ExecAuto/MSExecAuto 暴露的例程时 |
| patterns-mvc.md | 自动化 MVC(ModelDef/ViewDef)例程时 |
| patterns-processing.md | 自动化批处理或处理例程时 |
| patterns-reports.md | 自动化报表(TOTVS Report、R3、FWMSPrinter、Smart View)时 |
| patterns-routine-prep.md | 调整例程,使其在官方无头执行期间绕过屏幕或警报时 |
| patterns-smartlink.md | 自动化通过 SmartLink 集成的例程时 |
| patterns-smartview.md | 自动化基于 Smart View 的例程时(如需构建 Smart View 业务对象而非测试对象,请参阅 smartview-development) |
| patterns-totvs-message.md | 自动化使用单消息(TOTVS Message)模式的例程时 |
| patterns-webservice.md | 自动化 REST、SOAP 或 Portal Protheus Web 服务端点时 |
评论
支持 Markdown