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。