多选关联

多选关联字段用于从其他表单中选择多条记录。字段底层保存所选记录标识列表。

当一条记录需要指向多条关联记录时，可以使用多选关联。例如项目关联多个任务、事件关联多个影响资产。

基础配置

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

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

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

常见场景：

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

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