yqcloud-script

Installation
SKILL.md

YQCloud JS 脚本编写

先判断脚本所在位置,再按对应契约写代码。

先识别脚本契约

  • 字段脚本、OR 字段脚本、过滤脚本、值集联动脚本、序号脚本:必须 return。
  • 普通字段返回标量值;引用字段返回对象;列表过滤通常返回逗号拼接字符串。
  • 业务规则、动作脚本:优先使用 $SetValue(key, value) 回写当前单据;仅在当前引擎明确要求时再 return。
  • 列表预筛选先确认是不是 SQL/MyBatis 数据源逻辑。复杂查询写在后端 SQL,JS 只负责把页面值透传出去。

只用当前环境能跑的 API

  • 通用函数:$GetValue、$SetValue、$GetCurrentTime、$GetCurrentPerson、$GetCurrentPersonId。
  • 后端限定函数:$Print、$Invoke、$GetBusinessObject、$SearchBusinessObject、$RestExchange、$InvokeInterface。
  • 案例里出现了 $GetCurrentAttribute,但它不在你提供的 API 清单里。只有在当前项目已有同类脚本明确使用它时再复用;默认优先 $GetValue。

固定编写顺序

Installs
3
First Seen
Mar 13, 2026