引用

通过引用字段建立各个实体之前的关联关系,例如订单中的所属客户等。

系统中许多功能都需要实体存在关联关系才能进行,例如相关项的新建、显示,或是触发器中的目标实体等。通过建立有效的关联关系,是实现业务需求的良好开端。

配置说明

1. 引用实体

添加字段时所指定使用的关联实体(此项不可更改,如需更改可新加字段)。

引用了哪个实体就会成为被引用实体的“相关项”,例如订单的“购买客户”字段引用了客户实体,则订单即为客户的相关项

2. 父级级联字段

即与选择的字段产生级联关系。配置后父级级联字段与当前字段在选择数据时将受到相互制约,即只能选择有级联关系的数据。同时,当前字段也自动具备类似“表单回填”的效果(自动回填父级级联字段值)。

? 如配置了“父级级联字段”,注意两个字段(本字段和父级级联字段)需要同时布局到表单页面,否则可能无法正确达到级联效果。同时注意父级级联字段非强校验(即仅供前端选择之用)

3. 附加过滤条件

在选择字段(值)时会自动过滤不符合条件的数据。

4. 启用快速新建

录入数据时通过快速新建添加引用实体记录。

快速新建目前仅支持 PC 网页版,手机版暂不支持 V3.3 版本已支持

5. 默认值

新建记录时的默认值,如字段未被布局在表单中,保存时系统会自动填写。

6. 启用扫码

启用后可通过扫码录入数据。系统将通过扫码结果匹配对应的引用记录字段填写,匹配方式为引用记录的名称字段或自动编号字段,如匹配多条记录将自动使用第一个。

通过配合表单回填(详见下文)功能可实现多字段自动填写。

扫码功能仅可在手机版企业微信、钉钉,或在 手机版 APP 中使用,在 企业微信钉钉 中使用需要正确配置集成

7. 表单回填

详见下文。

高级主题

表单回填

当在 表单页面 选择引用字段(值)时,系统将按照设置好的规则自动回填页面上其他字段的值,以此减少重复录入。同时,对于回填值用户还可以进行手动修改。

例如在“订单”中存在一个“相关客户”引用字段,在选择客户时希望将相关客户的“电话”自动回填到订单的“电话”中,此时可以在订单的“相关客户”字段中配置表单回填规则。

  1. 从引用实体的哪个字段获取值
  2. 填写到当前实体的哪个字段
  3. 何时填写
  4. 如果字段有值是否强制填写
  5. 启用后无法录入只能通过回填填写(启用此选项建议同时启用“使用后端回填”)
  6. 若不启用则回填只发生在 表单页面,而启用后将在后端进行回填(会覆盖用户填写的值),请根据实际需要启用

? 目标字段需要与源字段在类型上保持兼容,例如“电话”类型的字段无法回填到“数字”类型的字段,对于不兼容的目标字段不会显示

点连接

在涉及到字段查询的配置中(如 报表模板、OpenAPI、触发器计算公式等),引用字段可以通过 . 连接来使用其他实体的字段。例如 createdBy.email 表示创建人的邮箱(其中 createdBy 是一个引用“用户”实体的字段),或者更复杂一些 createdBy.deptId.principalId 表示创建人的所在部门的负责人。系统可支持无级连接。

常见问题

点击放大镜时打开的搜索页显示列是否可以配置?

暂不支持配置。此显示列与 列表页面 的列显示一致,即他们是共用的。

父级级联字段适用场景?

例如有“运输公司”与“车辆”实体,其中车辆通过引用字段“所属公司”与运输公司建立关联,可以看出运输公司与车辆构成了父子级关系(一家运输公司下有多辆车辆)。如果在其他实体中使用两个引用字段分别引用上述两个实体,则可以在引用车辆的字段中选择引用运输公司的字段作为父级字段。

具体使用时,假设 A 运输公司下有 A1 A2 A3 三辆车,当父级字段选择运输公司 A 时,本字段仅可选择 A1 A2 A3 三辆车,无法选择其他的。

若还是无法更好的理解,您可以将父级级联字段的作用想象成“省市”数据,当我们选择“省”之后,市只能选择“省”内的,而非全国所有“市”。

该文档内容对您是否有帮助?没有
您也可以通过 社区群组 向我们反馈问题
Updated 2024-08-22
目录