.action.ts 后端脚本文件

.action.ts 是推荐使用的后端脚本源码形式。它使用 TypeScript 语法编写，系统会编译为 Rhino 可执行的 JavaScript，并在服务器 JVM 环境中运行。

后端脚本常用于程序流脚本、自定义接口、数据加工脚本、系统事件监听、项目或应用级钩子逻辑。与前端 .ts 不同，.action.ts 面向服务器端执行，可以使用后端脚本 API，但不能依赖浏览器 DOM、Window、页面组件实例等前端对象。

常见位置

位置	说明
/sysdata/settings/hooks.action.ts	系统级后端钩子脚本。
/{project}/settings/hooks.action.ts	项目级后端钩子脚本。
/{project}/app/{app}.app/hooks.action.ts	应用级后端钩子脚本。
/{project}/app/{app}.app/API/*.action.ts	应用 API 目录下的后端脚本。
*.tbl.action.ts	与数据模型关联的后端脚本。

编辑注意事项

1. 优先维护 .action.ts，不要同时手工改同名 .action 编译产物。
2. 后端脚本运行在服务器端，多线程并发场景下不要依赖全局变量保存请求状态。
3. 需要返回页面、JSON、文件或调用程序流时，先确认调用方对返回值结构的要求。
4. 后端脚本无法按浏览器方式断点调试，通常通过日志和测试环境验证。

相关参考

• 脚本开发
• 脚本文件的组织
• types/api/succ.dw.d.ts
• types/api/succ.afl.d.ts