概述
引用字段用于跨对象获取一对多关系中“1 方”的字段值,并动态呈现在“多方”页面上,实现关联数据的自动展示。适用于订单明细显示产品价格、子记录引用主记录信息等场景,数据以动态链接方式实时跟随源头对象变化。
基础规格
| 属性 | 说明 |
|---|---|
| 适用场景 | 订单明细上显示产品价格 |
| 每对象上限 | 最多 20 个(可购买资源包扩展) |
| 数据同步 | 动态链接,实时跟随源头对象变化 |
核心注意事项
引用字段与默认值的区别
引用字段是动态链接的,其数据会始终跟随源头对象中字段的改变而实时同步发生变化。而默认值只在创建记录时加载一次,之后源对象值修改,默认值不会发生变化。
引用字段的计算时效性
- 不支持筛选的引用字段:在用户打开页面或查询数据时,在内存中实时关联计算并展示,数据库不持久化该值。
- 支持筛选的引用字段:由于需要在数据库底层建立索引以供查询,其值在保存数据后由后台程序在计算队列中异步计算并写入数据库。因此存在一定的同步延迟。
[!WARNING]
引用字段筛选"有值但筛选不出"问题:
在列表页数据中能看到引用字段的值,但在列表筛选时却无法搜出来。这是因为页面显示的值是进入页面时实时关联计算渲染的,而筛选是在数据库物理列中检索。如果后台计算队列尚未将新计算的值写入该引用字段对应的物理列,筛选就会失效。请批量操作后耐心等待计算队列执行完毕。
使用限制与置灰规则
- 引用字段不支持引用计算字段、统计字段和另一个引用字段。若需要关联引用,请使用计算字段的"高级模式"进行嵌套。
- 引用字段不支持作为计算字段、统计字段或默认值公式中的运算变量。
- 引用字段不支持触发前端 UI 事件。
- 如果引用字段引用了
查找关联、部门、人员、图片字段,则后台的是否支持筛选选项将强制置灰为"否",不支持作为前台列表的筛选条件。

