关联搜索

关联搜索字段用于从其他表单中选择一条记录。字段底层保存所选记录的标识，运行时页面会按所选记录的可读标识展示。

当一条记录需要指向另一条业务记录时，可以使用关联搜索。例如订单选择一个客户、任务选择一个项目、报销选择一个成本中心。

基础配置

配置项	说明
名称	展示给用户的字段标签，必填；名称应清楚表达这个关联关系
API 名称	数据接口、脚本、公式、导入和集成使用的稳定技术名称，必填
必填	保存记录前必须选择一条关联记录
只读	展示已选择的关联记录，但不允许用户修改
停用	字段不参与常规使用
隐藏	字段会保存所选值，但不在常规表单页面展示

配置项	说明
来源表单	提供可选记录的目标表单，必填
关联数据范围	可选 Studio 脚本，用于过滤用户可以选择哪些目标记录
占位提示	用户选择记录前显示在字段中的提示文案
弹窗标题	选择记录弹窗的标题
搜索占位提示	选择记录弹窗中搜索框的提示文案
校验时机	控制什么时候执行选择校验：值变更时、失焦时或提交记录时
输入状态	给字段添加警告或错误等视觉状态
无效选择提示	所选记录无效或不可用时显示的自定义提示
颜色	设置字段展示颜色
帮助文案	展示在字段附近的辅助说明；可用于说明用户应该选择哪类关联记录

来源表单决定用户可以选择哪些记录。常规选项中只展示启用中的表单。部门、组织和成员系统表单不会作为该字段类型的普通来源，因为它们有专门的字段类型。

选择来源表单后，运行时用户会从该表单中搜索并选择记录。搜索和展示会使用目标表单的标识字段。

当这个字段只允许选择来源表单中的一部分记录时，使用 关联数据范围。

常见场景：

脚本绑定在当前来源字段上，在选择弹窗加载目标记录前执行。脚本返回 relationDataFilter 条件，条件字段使用目标表单字段 API 名称。

不要把这类过滤规则配置到目标表单页面事件里。Payload 和返回协议请查看关联数据范围。

建议	说明
使用清晰名称	字段名称建议直接使用关联对象名称，例如客户、项目
检查目标标识字段	目标表单应有清晰的标识字段，方便用户在选择弹窗中识别记录
设置有用的占位提示	例如“搜索并选择客户”，让用户知道下一步操作
设置无效选择提示	当所选记录不可用时，用业务语言告诉用户原因