Skip to content

如何配置查找关联字段

查找关联字段用于在两个独立的对象之间建立松散的引用关系。管理员可以通过配置可选择数据范围、条件过滤以及默认值映射,实现业务数据的高效穿透与校验。

概述

查找关联字段通常在多对一关系的 多方 进行配置。例如,在“订单”对象上创建查找关联字段指向“客户”对象。对于查找关联字段,系统支持单选与多选,同时支持对前台用户可选的数据范围进行严格过滤(如三角过滤、四角过滤等)。


第一步:创建查找关联字段

  1. 前往 企业管理 > 对象管理 > 预设/自定义对象管理,进入目标对象(如“订单”对象)。
  2. 字段和关系 页面,点击 新增字段
  3. 字段类型选择 查找关联查找关联(多选)
  4. 关联对象 下拉框中,选择需要引用的目标对象(如“客户”)。
  5. 填写字段名称和 API 名称。

第二步:配置可选择数据范围

用于限制前台用户在新建或编辑页面录入时,该字段可选的数据集合。

配置可选择数据范围

  1. 全部:前台用户可以检索并选择目标关联对象下的所有数据。

  2. 根据条件:管理员可以基于规则进一步收窄可选范围。过滤条件支持以下两种配置方式:

    条件选择方式

    • 基于字段过滤:配置条件满足如 关联对象.字段 = 本对象.字段

      • 支持字段类型:文本类、数值类、单选/多选/布尔值、人员(及多选)、部门(及多选)、查找关联(及多选)、国家省市区、定位、统计字段、可筛选的计算/引用字段。
      • 不支持字段类型:不可筛选的计算/引用字段、复合组件(支付、签到、日期范围的父容器)、长文本、富文本、图片、附件、关联业务数据。
    • 基于自定义函数过滤

      • 一个关联配置仅允许添加 1 个 自定义函数。
      • 函数的返回值必须是一个 数据集合 (List)
      • 每次调用最多返回 500 条 数据。超出限制时,系统仅展示前 500 条。

      基于自定义函数过滤


第三步:掌握多角关联过滤条件 (三角、四角、五角)

在配置“根据条件”过滤时,管理员可以通过逻辑环路配置高级过滤:

1. 三角过滤 (Triangle Filter)

  • 概念:在对象 A 的“关联 B”字段上设置过滤条件:B.C = A.C

    三角过滤示意

  • 前台填写逻辑:由于 B 受限于 C,用户在新建/编辑数据时,必须先填写字段 C,才能填写字段 B

    先填写C再选择B

  • 相关列表新建与回填

    • 在 B 的详情页下的相关列表中点击新建 A 时,系统会自动回填 A 的关联 B 字段,且只读。
    • 如果 B 数据上的关联 C 有值,新建 A 时会同步自动回填其关联 C,且只读。
    • 如果 B 数据上的关联 C 为空,新建 A 时其关联 C 允许重新选择。如果重新选择 C,系统会清空已有的关联 B 值,但该字段仍保持只读。

    详情页关联回填

    Web端清空只读

TIP

多层三角过滤导致必填失效的问题排查: 在备货单详情(商机预测详情)下新建记录时,带入的必填客户字段会被三角联动强制设为只读。当重新选择客户时,会触发 lookup 级联清除,导致布局规则的必填限制失效。

  • 解决方案:需在备货单的“商机预测”字段上显式添加过滤条件 客户名称 = 备货单.客户名称,保证在详情下新建时,客户数据能自动带入而无需手动触发重选。

2. 四角过滤与五角过滤

  • 四角过滤:在三角的基础上,跨越四个对象进行闭环过滤。

    四角过滤

  • 五角过滤:跨越五个对象进行深度过滤。

    • 配置限制:五角过滤最末端的对象 E,其主属性必须为 文本 类型,不支持自增编码 字段。

    五角过滤

  • 组合与排他性限制

    • 一个过滤条件中只允许存在 1 个 四角/五角过滤分支。
    • 三角、四角、五角过滤条件不可以同时在一个筛选分组中混合使用,也不允许存在于不同的分组中。
    • 多个三角过滤条件之间可以进行“与/或”组合。

第四步:配置默认值

查找关联字段支持使用默认值。例如“回款”关联“订单”和“客户”:

  1. 订单关联客户,回款关联订单。
  2. 在回款的“客户”字段上设置默认值,来源字段指向 订单.客户
  3. 在新建回款选择订单后,系统自动将订单中的客户信息带入到回款的客户字段中,免除重复录入。

关联默认值


相关主题