引用字段

概述

引用字段用于跨对象获取一对多关系中“1 方”的字段值,并动态呈现在“多方”页面上,实现关联数据的自动展示。适用于订单明细显示产品价格、子记录引用主记录信息等场景,数据以动态链接方式实时跟随源头对象变化。


基础规格

属性 说明
适用场景 订单明细上显示产品价格
每对象上限 最多 20 个(可购买资源包扩展)
数据同步 动态链接,实时跟随源头对象变化

核心注意事项

引用字段与默认值的区别

引用字段是动态链接的,其数据会始终跟随源头对象中字段的改变而实时同步发生变化。而默认值只在创建记录时加载一次,之后源对象值修改,默认值不会发生变化。

引用字段的计算时效性

  • 不支持筛选的引用字段:在用户打开页面或查询数据时,在内存中实时关联计算并展示,数据库不持久化该值。
  • 支持筛选的引用字段:由于需要在数据库底层建立索引以供查询,其值在保存数据后由后台程序在计算队列中异步计算并写入数据库。因此存在一定的同步延迟。

[!WARNING]
引用字段筛选"有值但筛选不出"问题
在列表页数据中能看到引用字段的值,但在列表筛选时却无法搜出来。这是因为页面显示的值是进入页面时实时关联计算渲染的,而筛选是在数据库物理列中检索。如果后台计算队列尚未将新计算的值写入该引用字段对应的物理列,筛选就会失效。请批量操作后耐心等待计算队列执行完毕。

使用限制与置灰规则

  • 引用字段不支持引用计算字段、统计字段和另一个引用字段。若需要关联引用,请使用计算字段的"高级模式"进行嵌套。
  • 引用字段不支持作为计算字段、统计字段或默认值公式中的运算变量。
  • 引用字段不支持触发前端 UI 事件
  • 如果引用字段引用了查找关联部门人员图片 字段,则后台的是否支持筛选选项将强制置灰为"否",不支持作为前台列表的筛选条件。

引用字段筛选置灰

引用字段不支持选择计算字段

相关主题

2026-08-12
0 0