字段更新
字段更新是 RB 较为常用且最强大的触发器之一，其应用场景可简单描述为通过 A 字段值更新 B 字段值、或通过 A B C ... 字段值更新 D 字段值。例如，可根据订单总金额、已付金额计算未付金额；再例如，多个订单会引用同一个客户，可以通过此触发器在客户更新时同步更新其下所有订单的（字段）值。
字段更新支持（从源实体字段）字段赋值，或使用固定值、计算公式等丰富的更新方式。
配置触发器
1. 目标实体
更新哪个实体（记录）。源实体与目标实体通过 引用字段 关联，只有存在关联关系的实体才能被选择。
带有
(N)标识的表示会影响到多条记录。例如订单中“购买客户”字段引用客户（即1客户:N订单），因此在以客户为源实体时会更新多条订单（若有）。
通过字段匹配 ~~v3.8
如果源实体与目标实体之间没有关联关系，可以“通过字段匹配”。例如实体 A 中有物料编号、供应商编号，实体 B 中也有物料编号、供应商编号，即使实体 A、B 之间没有引用字段关联，B 也可以作为目标实体使用。
其关联逻辑为：A 实体（记录）触发时，会通过自身的物料编号、供应商编号到 B 实体中查找一样的记录进行更新处理（如找到多条则会更新多条）。
2. 更新规则
根据业务需要设置“更新方式”、“源字段”（或 计算公式），系统会将结果自动填写到“目标字段”中。设置完成后点击 [添加]，一个触发器可添加多个更新规则。
3. 自动设置目标字段为只读
将“目标字段”设置无只读模式（即用户不能填写）。
4. 允许强制更新
如果目标实体启用了 审批流程，目标记录可能处于审批只读状态，如不启用此选项可能无法完成更新且不会提示错误。
5. 源字段为空时置空目标字段 ~~v3.3
默认情况下源字段为空时（或源记录被删除时）系统会忽略执行更新，这将导致先前更新的值无法还原到空，启用此选项可避免此问题出现，您可根据需要启用此选项。
6. 禁用级联执行
禁用 级联执行。如您无法确定是否需要禁用，请不要禁用。
计算公式
计算公式可以实现复杂的字段值计算，甚至支持各种逻辑判断来计算字段值。
公式编辑器
公式编辑器仅支持数字、日期类型字段，如果是其他类型的字段，会自动切换到“高级计算公式”编辑器。请注意计算公式所返回的结果需要与“目标字段”类型匹配，例如目标字段为数字则计算结果也应为数字，否则可能导致触发器执行失败。
使用日期函数
系统提供了多个针对日期处理的函数，使用函数时请注意保证其语法正确性。
DATEDIFF
- 作用：比较两个日期（时间），得出差值（数字类型）
- 语法：
DATEDIFF($DATE1, $DATE2, [H|D|M|Y|I])$DATE1与$DATE2表示日期，可以是日期字段，也可以是具体的日期值，如2021-01-01[H|D|M|Y|I]表示差值单位（可选，默认为D）。H表示小时，D表示天，M表示月，Y表示年，I表示分钟
- 示例：
DATEDIFF({riqi1}, {riqi2})DATEDIFF({riqi1}, {riqi2}, "M")
自 V3.6 支持简易写法，如
$DATE1 - $DATE2得出差值（天数）。或直接通过大于、小于比较两个日期得到布尔值用于if判断，如$DATE1 > $DATE2$DATE1 < $DATE2
DATEADD
- 作用：将日期（时间）加，得出新日期
- 语法：
DATEADD($DATE, $NUMBER, [H|D|M|Y|I])$DATE表示日期，可以是日期字段，也可以是具体的日期值，如2021-01-01$NUMBER表示数字，可以是数字字段，也可以是具体的数字值，如30[H|D|M|Y|I]表示数字单位（可选，默认为D）。H表示小时，D表示天，M表示月，Y表示年，I表示分钟
- 示例：
DATEADD({riqi1}, {shuzi2}, "D")DATEADD({riqi1}, 5, "D")
自 V3.6 支持简易写法，如
$DATE + $NUMBER得出新日期（加天数）
DATESUB
- 作用：将日期（时间）减，得出新值日期
- 语法：
DATESUB($DATE, $NUMBER, [H|D|M|Y|I])$DATE表示日期，可以是日期字段，也可以是具体的日期值，如2021-01-01$NUMBER表示数字，可以是数字字段，也可以是具体的数字值，如30[H|D|M|Y|I]表示数字单位（可选，默认为D）。H表示小时，D表示天，M表示月，Y表示年，I表示分钟
- 示例：
DATESUB({riqi1}, {shuzi2}, "D")DATESUB({riqi1}, 5, "M")
自 V3.6 支持简易写法，如
$DATE - $NUMBER得出新日期（减天数）
DATEPICKAT ~~v3.5
- 作用：获取日期（时间）中的指定部分，得出新值（数字）
- 语法：
DATEPICKAT($DATE, [Y|Q|M|D|H|I|W])$DATE表示日期，可以是日期字段，也可以是具体的日期值，如2021-01-012023-01-01 10:01:02[Y|Q|M|D|H|I]表示获取单位（可选，默认为D）。Y表示年，Q表示季度，M表示月，D表示日，H表示小时，I表示分钟，W表示周几（V3.6）
- 示例：
DATEPICKAT({riqi1})DATEPICKAT({riqi1}, "Q")
高级计算公式
高级计算公式要求您具备一定的编程基础，否则可能无法顺利进行
计算公式底层使用 Aviator 实现，因此您可以编写任何符合 Aviator Script 语法的代码来实现业务需求（上节中介绍的日期函数也可在高级计算公式中使用）。在开始使用高级计算公式前我们强烈建议您阅读 Aviator 文档，尤其是 函数库列表 章节，高阶使用还会涉及 if 条件、for 循环 等。
同公式编辑器一样，高级计算公式中的字段变量也需要通过 {} 包裹，在公式执行时系统会自动替换实际的字段值。
更多可用函数
TEXT
- 作用：转换 ID（字段）值为文本。其中 ID 可以是 引用、多引用（V3.6）、下拉列表、分类 字段（值）
- 语法：
TEXT($ID, [$DEFAULT])$ID表示 ID，可以是 ID 字段，也可以是具体的 ID 值，例如837-018c2f7fa58e03f8$DEFAULT当无法找到文本时使用的默认值（可选）
- 示例：
TEXT({id})TEXT({id}, '没有值')
ID
- 作用：转换文本（字段）值为 ID。其中文本可以是业务实体的 自动编号 或 名称字段（值），如匹配到多个仅返回第一个
- 语法：
ID($TEXT, $ENTITY)$TEXT表示文本，可以是文本字段，也可以是具体的文本值，例如锐昉科技$ENTITY实体内部标识，表示在哪个实体中查找
- 示例：
ID({no}, 'SalesOrder')
CURRENTUSER
- 作用：获取当前登录用户（ID）
- 语法：
CURRENTUSER() - 示例：
CURRENTUSER()
CURRENTBIZUNIT
- 作用：获取当前登录用户的所在部门（ID）
- 语法：
CURRENTBIZUNIT() - 示例：
CURRENTBIZUNIT()
CURRENTDATE
- 作用：获取当前日期（时间）
- 语法：
CURRENTDATE() - 示例：
CURRENTDATE()
CHINESEYUAN
- 作用：转换数字（字段）为中文大写形式
- 语法：
CHINESEYUAN($NUMBER)$NUMBER数字，可以是数字字段，也可以是具体的数字值，例如9800
- 示例：
CHINESEYUAN({jine})CHINESEYUAN(123)
LOCATIONDISTANCE
- 作用：计算两个 位置（字段）的直线距离（米）
- 语法：
LOCATIONDISTANCE($LOC1, $LOC2)$LOC1表示起始坐标，可以是位置字段，也可以是具体的坐标值，例如123.1234567,321.12345678$LOC1表示结束坐标，可以是位置字段，也可以是具体的坐标值，例如123.1234567,321.12345678
- 示例：
LOCATIONDISTANCE({qiyundi}, {mudidi})LOCATIONDISTANCE({qiyundi}, {mudidi}) / 1000
REQUEST
- 作用：请求给定 URL 以获取结果
- 语法：
REQUEST($URL, [$DEFAULT])$URL有效的请求地址，系统将从该地址获取结果$DEFAULT当无法获取结果时使用的默认值（可选）
- 示例：
REQUEST('http://xx/api/x?id=' + {id}, '')
ISNULL ~~v3.5
- 作用：判断是否为空值（适用所有类型的字段）
- 语法：
ISNULL($VALUE)$VALUE要判断的值，可以是字段，也可以是具体的值
- 示例：
ISNULL({ziduan1})ISNULL(0)
此外 RB 还内置了一个字符处理工具集 StringUtils 用于常用文字处理，例如将字母转换为全大写 StringUtils. upperCase($TEXT)，关于此工具集所提供的方法请 参见文档。
上述部分函数仅商业版可用；请注意函数名区分大小写；字段请使用
{}包裹，字符（串）使用引号包裹，数字无需包裹
字段变量值说明
为保持最大兼容性，系统对字段变量值进行了一些处理。在编写公式前请务必阅读以下说明：
- 数字（小数、整数）、布尔字段会保持值类型，其他字段变量值均处理为字符串（包括日期等）
- 若字段变量值为空，对于数字（小数、整数）字段将处理为数字
0，对于非数字字段将处理为空字符串''。因此对于字段值的空值判断应为if {ziduan} == ''或if {ziduan} == 0，而非if {ziduan} == nil。我们推荐您使用 ISNULL 函数判断空值较为方便 - 引用型字段（下拉列表、分类、引用）处理为
ID（20 位 Hash 字符串），如需获取文本可使用 TEXT 函数进行转换。 - 多选型字段（标签、多选）会处理为文本值（多值使用
,分隔，如AAA, BBB） - 多引用字段较为特殊，如果目标字段也是多引用，则输出为
ID字符串（,分隔），否则输出为文本（,分隔）
返回值说明
公式计算出的值需要符合字段在数据库中定义的存储类型，系统不会对值类型进行转换，需您自行处理。在编写高级表达式前，您应清楚并理解各类型字段值的含义。
- 对于格式文本类字段（包括电话、邮箱、链接等），系统不会进行格式验证，请自行保证格式正确
- 对于引用型字段（包括下拉列表、分类、引用），需要保证值为有效的
ID（20 位 Hash 字符串） - 对于多引用字段，需要保证值为
ID数组 - 对于图片、附件字段，需要保证值为
JSON数组（如['rb/aaa','rb/bbb']） - 对于多选、状态字段，需要保证值为整数数字（多个选型值相加）
! 请确保返回值正确，否则可能导致系统出现错误，请谨慎进行
对于分类、下拉列表、多选字段，您可以通过 OpenAPI 获取其对应返回值（ID 或数字）
示例
注意下列示例中使用
{}包裹的均为字段内部标识
将两个字段值拼接
{ziduan1} + "和" + {ziduan2}
获取两个日期之间的的小时数
DATEDIFF({date1}, {date2}, "H")
计算订单天数
DATEDIFF({date}, CURRENTDATE())
常见问题
如何选择合适的源实体？
源实体：数据从哪里来；目标实体：到哪里去。
是否支持实时计算？
不支持，触发器仅在保存时由后台进行计算。若您需要实时计算，可以考虑使用表单计算公式（或配合使用），目前 小数、日期、日期时间 均支持表单计算公式。