用途
ADVPR（Advanced Protheus Robot）是 TOTVS Protheus 内部基于 ADVPL 的测试机器人。本技能用于为 Protheus 例程编写和运行自动化业务规则回归测试，帮助用户创建或调试 ADVPR 测试脚本、搭建 TestSuite、诊断无界面执行中的 TimeOut 或意外屏幕失败，并判断某类例程应使用哪种 ADVPR 模式。
主要能力
- 使用 FWTestHelper 断言 API 编写断言与期望。
- 在 TestSuite（GPS de Testes）中注册与组织测试用例。
- 以带界面（FWMyTestRunner）或无界面（headless，FwExecSuite）方式运行测试套件。
- 针对不同例程模式提供脚本编写指导：MVC、ExecAuto/MSExecAuto、报表、处理例程、Webservice（REST/SOAP/Portal）、SmartLink、Smart View、TOTVS Message（单消息）。
- 例程准备：调整遗留代码，使其在官方无界面执行时无需屏幕即可运行。
- ADVPR 脚本编写通用最佳实践。
使用方式
技能包含以下参考文件，按需读取：
- 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 Webservice 端点。
参考文件以巴西葡萄牙语撰写。
适用场景
当用户希望创建或调试 ADVPR 测试脚本、搭建 TestSuite、诊断无界面执行中的 TimeOut 或意外屏幕失败，或需要判断某类例程应使用哪种 ADVPR 模式时，激活本技能。
限制
本技能不涵盖：手动/界面驱动的 QA；ADVPR 之外的独立 ADVPL 函数单元测试；与测试自动化无关的运行时/编译错误调试（参见 advpl-debugging）。