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。

固定编写顺序