yida-business-rule

yida-business-rule — 业务关联规则高级函数

适用边界

业务关联规则是宜搭表单设置里的旧式/低频跨表联动能力。用户明确提到以下意图时使用本技能：

• "业务关联规则"、"表单事件里的公式执行"
• "高级函数"、"INSERT"、"UPDATE"、"DELETE"、"UPSERT"
• "要在表单设置里配 upsert/update/delete/insert"
• 明确不想用集成自动化，而要用公式函数做跨表增删改

默认建议：

配置入口

在表单设计器里进入：

表单设置 → 表单事件 → 公式执行 → 添加业务关联规则

业务关联规则弹窗包含三个事件输入框：

点击事件输入框会打开「公式执行」编辑器。配置完成后必须依次确认：公式弹窗 → 业务关联规则弹窗 → 保存表单。

关键原则：必须插入令牌

业务关联公式不是普通字段公式。普通字段公式引用字段用 #{fieldId}；业务关联规则引用目标表、目标字段、当前表字段时，必须在公式编辑器左侧列表点击插入令牌。

不要直接手敲中文表单名或字段名。实际验证中，手敲下面这种文本会报非法标识符：

UPSERT(Upsert目标,EQ(Upsert目标.键,"x"),"",Upsert目标.键,"x")

正确方式是在编辑器中输入函数名、括号、逗号、字符串常量，然后点击左侧字段列表插入 Upsert目标、Upsert目标.键 等令牌。最终输入框看起来可能和手敲文本相似，但内部结构不同。

高级函数签名

子条件 用于定位目标表某条数据下的子表单明细。不操作子表单时必须写 ""，不能省略。

UPSERT 模板

普通主表字段 upsert：

UPSERT(目标表, EQ(目标表.业务键, 当前表业务键), "", 目标表.业务键, 当前表业务键, 目标表.目标字段, 当前表来源字段)

库存类示例：

UPSERT(存货表, EQ(存货表.商品名, 商品名), "", 存货表.商品名, 商品名, 存货表.存货量, 存货表.存货量 + 进货量)

固定值探测示例：

UPSERT(Upsert目标, EQ(Upsert目标.键, "_openyida_upsert_probe"), "", Upsert目标.键, "_openyida_upsert_probe", Upsert目标.备注, "configured from form settings")

以上示例中的表单名和字段名只是可读展示。真实配置时，所有表单和字段引用都要从左侧列表点击插入令牌。

条件规则

• 主条件、子条件 必须由逻辑函数构造，常见为 EQ()、AND()、OR()。
• 除 AND()、OR() 外，逻辑函数第一个参数必须是目标表组件，例如 EQ(存货表.商品名, 商品名)。
• 不要把当前表字段写在 EQ() 第一个参数，也不要在第一个参数里嵌套其他函数。
• 更新普通组件时，目标列 必须是目标表普通组件。
• 更新子表单明细时，目标列 必须是对应明细下的组件。
• 同一个高级函数里不要同时更新普通组件和明细组件；需要拆成多条规则或多个函数。

浏览器配置步骤

1. 确认触发表单和目标表单都在同一应用内。
2. 用 openyida get-schema <appType> <formUuid> 查清目标字段和来源字段，避免点错。
3. 打开触发表单设计器，进入 表单设置 → 表单事件 → 公式执行 → 添加业务关联规则。
4. 点击要配置的事件输入框，例如 单据编辑。
5. 在公式编辑器中只手动输入函数名、括号、逗号、字符串常量。
6. 目标表、目标列、来源字段全部从左侧列表点击插入令牌。
7. 每插入一个令牌后暂停并校验公式显示，避免 CodeMirror 光标错位。
8. 点击公式弹窗「确定」。如果能回到业务关联规则弹窗，说明公式通过编辑器校验。
9. 点击业务关联规则弹窗「确定」，最后点击表单设计器「保存」并确认保存成功。

用量限制

常见错误

参考

• 宜搭帮助中心：表单业务规则
• 宜搭帮助中心：INSERT / UPDATE / UPSERT / DELETE 业务关联公式