数据源字段

数据源字段（DataSource）用于从候选数据列表中选择数据，是最常用的关联型字段。

概述

数据源字段通过数据源获取候选项，可用于自定义选项集（如状态、级别）或关联其他对象的数据。它支持下拉、树形、单选按钮/复选框、级联四种渲染模式，并具备选择模式、展示模式、标签配色、连接符等丰富的展示配置，同时支持 Lookup 关联与字段监听联动。

配置项

配置项	说明
名称	字段显示名称，必填
编码	字段唯一编码，必填，创建后不可修改
描述	字段用途说明
数据源	候选数据的来源，必填
选择模式	单选或多选
渲染模式	下拉、树形、单选按钮/复选框、级联
表单项布局	单选按钮/复选框模式下的水平/垂直排列
显示模式	列表中以文本或标签展示
标签颜色规则	标签展示时的配色方案
连接符	多选且文本展示时，多值之间的连接文本
输入框前缀	输入框左侧前缀文本
输入框后缀	输入框右侧后缀文本
Lookup	按数据 Id 关联其他对象
字段监听	监听其他字段变化并刷新数据源

数据源

数据源字段必须选择一个数据源，可选系统内置数据源或自定义数据源。详见系统内置数据源。

选择模式与渲染模式

选择模式	值	说明
单选	0	只能选择一项
多选	1	可选择多项，多值以逗号分隔存储

渲染模式	值	说明
下拉选择器	0	标准下拉选择，多选时支持多标签输入
树形选择器	1	树形结构展示
单选按钮/复选框	2	以单选/复选形式平铺展示
级联选择器	3	多级联动选择，自动为多选

多选一旦启用不可改回单选；级联选择器自动为多选。

展示与标签

显示模式：文本（0）或标签（1）。
标签颜色规则：默认色（0）或随机色（1），仅标签模式生效。
连接符：仅当多选 + 文本展示时生效，用于拼接多个选项的显示文本（如「、」）。

Lookup 与字段监听

Lookup：开启后选择一个目标对象，列表与详情可直接展示该对象的字段；一旦开启不可撤销、不可更换关联对象。
字段监听：被监听字段值变化时刷新当前字段数据源，常用于省市联动等场景。

下一步

字段配置详解 - 渲染模式、Lookup、字段监听详解
系统内置数据源 - 可直接引用的内置数据源
人员选择字段 / 组织选择字段 - 其他选择类字段
字段配置总览 - 返回字段类型清单

属性明细

以下内容面向技术实现与 AI 检索。

数据源字段属性表

属性名	类型	含义	取值/存储值
`FieldType`	int	字段类型	`DataSource = 35`
`DataSourceSelect`	string	数据源标识	必填
`SelectMode`	`SelectModeEnum`	选择模式	`Single=0` / `Multiple=1`
`SelectRenderMode`	`SelectRenderModeEnum`	渲染模式	`Select=0` / `TreeSelect=1` / `RadioButtonOrCheckBox=2` / `Cascader=3`
`Properties.Layout`	string	表单项布局	`vertical`（默认）/ `horizontal`
`Properties.SelectDisplayMode`	`SelectDisplayModeEnum`	显示模式	`Text=0` / `Tag=1`
`Properties.SelectTagColorRule`	`SelectTagColorRuleEnum`	标签颜色规则	`Default=0` / `RandomColor=1`
`Properties.Connector`	string	连接符	仅多选 + 文本展示，最长 10 字符
`Properties.Prefix` / `Properties.Suffix`	string	输入框前后缀	可空
`LookupByDataId`	bool	是否开启 Lookup	开启后不可撤销
`LookupMetaObjectId`	string	Lookup 目标对象 Id	开启 Lookup 时必选
`LookupMetaObjectCode`	string	Lookup 目标对象编码	由目标对象推导
`OpenFieldMonitor`	bool	是否开启字段监听	默认 `false`
`MonitorFields`	string	监听的字段编码	逗号分隔

连接符生效条件

条件	是否生效
字段类型为 `DataSource`	必需
选择模式为多选（`SelectMode = 1`）	必需
显示模式为文本（`SelectDisplayMode = 0`）	必需
显示模式为标签	不生效

存储示例

字段定义：

{
  "Code": "level",
  "Name": "级别",
  "FieldType": 35,
  "DataSourceSelect": "<数据源Id>",
  "SelectMode": 1,
  "SelectRenderMode": 2,
  "Properties": {
    "Layout": "horizontal",
    "SelectDisplayMode": 0,
    "Connector": "、"
  }
}

对象数据中的存储值（多选以逗号分隔，展示时按连接符拼接）：

{
  "Fields": {
    "level": { "Code": "level", "Text": "高、中", "Value": "high,medium" }
  }
}

概述​

配置项​

数据源​

选择模式与渲染模式​

展示与标签​

Lookup 与字段监听​

下一步​

属性明细​

数据源字段属性表​

连接符生效条件​

存储示例​

概述

配置项

数据源