Protheus Reference 是 TOTVS Protheus 生态的快速查询参考指南,主要帮助开发者在使用 ADVPL 及相关技术栈时核实各类参考信息。
用途
该技能适用于需要确认原生函数行为、验证 SX3 中的自定义字段、检查 REST 端点约定,或确认某个函数是否被列入受限/仅内部使用清单的场景。其中,受限函数检查始终优先执行,会在推荐任何函数之前先进行。
主要能力
覆盖范围包括:跨类别(String、Date/Time、Array、Database、Interface、Network、JsonObject、ExecAuto 等)的原生函数语法、参数与返回值;SX 数据字典(从 SX1 Perguntas 到 SXB/SIX)结构;REST API 模式(FWRest 注解与旧版 WsRestFul);以及 MV_* 系统参数。
参考文件与读取时机
- reference.md:始终读取,包含函数类别索引、数据字典概览、REST API 模式摘要,以及本地优先/TDN 的查询策略。
- native-functions.md:查询某个原生函数的精确语法、参数和返回值时读取。
- sx-dictionary.md:理解 SX1-SX9/SIX 表结构及数据字典的编程式用法时读取。
- sx3-common-fields.md:在代码中引用字段前,验证某个自定义或标准字段是否存在于表上时读取。
- restricted-functions.md:在推荐函数前,检查该函数/类是否为仅内部使用或被禁止编译时读取。
- rest-api-reference.md:构建或记录 REST 端点(FWRest 注解或旧版 WsRestFul)时读取。
使用方式
查询策略为本地优先:先在本地参考文件中查找,未找到时回退到分层 TDN 在线搜索,依次尝试 WebFetch API、Playwright API JSON、Playwright HTML,通过 tdn-lookup 技能完成。
适用场景与限制
该技能专注于参考信息的快速查阅。它不涵盖表格/字段被使用的业务过程背景(参见 protheus-business),不负责编写查询这些表的 SQL(参见 embedded-sql),也不生成引用这些函数的文档(参见 documentation-patterns)。