SuperAPI AI 工具集

smartview-development

编程与开发

查看项目

更新于 10-16 04:39

技能介绍

Smart View 技能面向 TOTVS Protheus 平台,用于构建自定义 Smart View 业务对象,也就是所谓的 Integrated Provider。其核心是一个 TLPP 类,该类继承自 totvs.framework.treports.integratedprovider.IntegratedProvider,并声明 @totvsFrameworkTReportsIntegratedProvider 注解,同时实现 new()、getSchema() 与 getData() 三个方法。

主要能力与契约方面,技能文档覆盖了 schema 契约:通过 addProperty 定义列、列类型与日期处理;参数契约:使用 addParameter、setPergunte,以及通过 setCustomURL 实现高级搜索,并说明 combo 所需的那个自定义 REST 端点;getData 内部的查询编写模式;callTReports 菜单源;以及完整的 .trp 资源发布流程,使该对象能在 Protheus 菜单中被访问到。

使用方式上,当用户从零创建新的 Smart View 报表或数据视图、把已有的 TReport、FWMSPrinter、TMSPrinter 或 FWMSExcel 报表迁移为 Smart View 业务对象、配置带高级搜索或 combo 值的参数,或者排查对象为何不出现在工具中、为何返回零行、为何资源导入失败时,可以启用该技能。

参考文件按场景划分:reference.md 始终可读,涵盖 Smart View 与 Smart X 的区别、环境前提、最小契约、注解、REST 路由、对象标识与端到端示例;patterns-schema.md 用于定义列;patterns-parameters.md 用于定义参数;patterns-getdata.md 用于编写查询与填充行;patterns-migration-reports.md 用于报表迁移;deploy-trp.md 用于发布;troubleshooting.md 用于诊断错误。

限制方面,该技能不覆盖 Smart X(见 smartx-development)、Smart View 对象的自动化测试(见 advpr-test-automation,其中包含 UTSchemaSmartView/UTGetDataSmartView),也不覆盖所读表的 SX 字典脚本(见 sx-configuration)。参考文件使用巴西葡萄牙语撰写。