tielei60 Informat Expression
用于把自然语言规则转换成 Informat / 织信平台可执行的 UEL 表达式。
先读顺序
按这个顺序读取：
references/expression-rules.mdreferences/expression-boundaries.mdreferences/expression-sdk.mdreferences/expression-examples.md
如果需要完整函数定义、User.*/Date.* 边缘能力或 DSL 细节，再查：
../../sources/informat.expression.md
如果用户要求示例资产、存档位置或“展示一个示例”，优先查：
../../examples/generated_expressions/
适用场景
优先用于这些请求：
- 审批条件
- 流转条件
- 实例名称表达式
- 自动完成条件
- 字段公式
- 表单、仪表盘、API 返回值中的表达式
- 类似“请给我一个
${...}规则”的请求 - 需要判断“这件事该用表达式还是脚本”
如果用户需要的是脚本代码、自动化 JavaScript、平台脚本逻辑，改用 informat-script。
强约束
- 表达式必须使用
${}包裹。 ${}外的内容是普通字符串，不会被执行。- 字符串拼接不要使用
+，只能使用String.concat(...)。 - 数组字面量禁止使用，改用
Array.of(...)。 - 禁止输出 JavaScript 风格的
.map(...)、.filter(...)、.reduce(...)、箭头函数和对象字面量推导。 - 可以使用来源文档明确存在的 DSL 函数，例如
Array.map(list, key)、Array.filter(list, key, value)、Array.join(...)。 - 只能使用来源资料里已知的表达式对象和函数。
- 除法要考虑除数为
0会抛异常。 - 保留关键字不能误用为普通标识符。
Date.datePart(..., 'month')中 1 月对应0，day_of_week中星期日对应0。
两条硬规则
1. 字符串拼接
错误：
${ 'A' + 'B' }
${ name + '-' + code }
正确：
${ String.concat('A', 'B') }
${ String.concat(name, '-', code) }
2. 数组构造
错误：
${ ['a', 'b'] }
${ Array.first(User.usersWithRole(['researcher'])) }
正确：
${ Array.of('a', 'b') }
${ Array.first(User.usersWithRole(Array.of('researcher'))) }
输出方式
默认按这个顺序输出：
- 最终表达式
- 必要时补一句适用说明或 DSL 替代写法
- 用户要求示例资产或存档位置时，补充相关文件路径
- 若无法实现，单独列出原因，并建议改用脚本
如果用户要求多个候选表达式，就给多个合法版本，并说明差异。
示例资产
当用户要求查看、引用或说明示例资产时，使用 examples/generated_expressions/YYYY-MM/ 下的文件：
- 字符串拼接 / 审批编号：
examples/generated_expressions/2026-03/string_concat_example.txt - 0 基月份判断：
examples/generated_expressions/2026-03/date_month_zero_base.txt User.usersWithRole与Array.of：examples/generated_expressions/2026-03/array_of_user_role.txt- JS 风格
.map(...)反例：examples/generated_expressions/2026-03/js_style_error.txt
如果日期或月份目录变化，先用当前仓库里的 examples/generated_expressions/ 实际文件为准。
什么时候不要继续硬写表达式
遇到下面这些情况，优先停止并说明边界，再建议改用脚本：
- 需要复杂流程控制、复杂副作用或多步编排
- 需要 JavaScript 风格的循环、箭头函数、
.map/.filter/.reduce - 需要调用来源资料中不存在的函数
- 需要数组字面量或对象字面量来完成核心逻辑
- 无法确认某个对象或函数是否真实存在
自检清单
输出前检查：
- 是否完整使用了
${} - 是否误用了 JavaScript 语法
- 是否把字符串拼接写成了
+ - 是否把数组写成了字面量
- 是否把 JS
.map/.filter错当成了表达式 DSL - 是否误用了 JS 高阶函数或箭头函数
- 是否存在除数为 0 的风险
- 是否正确处理了月份与星期的 0 基取值
- 是否在不能实现时明确说明了限制