人员选择字段

人员选择字段（UserSelect）用于从系统人员数据中选择员工，支持单选/多选与多种渲染模式。

概述

人员选择字段以文本形式存储所选人员的 Id 或标识，展示时自动解析为人员名称。系统为人员选择字段内置了人员数据源，无需手动配置数据来源；同时可与「按数据 Id Lookup」配合，在列表或详情中直接展示关联的人员信息对象字段。

配置项

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

选择模式

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

多选一旦启用，不可再改回单选。

渲染模式

渲染模式	值	说明
下拉选择器	0	标准下拉选择
树形选择器	1	按组织层级树形展示
单选按钮/复选框	2	以单选/复选形式平铺展示
级联选择器	3	多级联动选择，自动为多选

表单项布局

仅当渲染模式为单选按钮/复选框时显示「表单项布局」，可选垂直（默认）或水平。

展示与标签

显示模式：文本（0）或标签（1）。标签模式在列表/详情中以 Tag 展示。
标签颜色规则：默认色（0）或随机色（1），仅标签模式生效。

Lookup 与字段监听

Lookup：开启后固定关联系统「人员信息」对象，列表与详情可直接展示该人员的扩展字段。一旦开启不可撤销、不可更换关联对象。
字段监听：选择要监听的字段后，被监听字段值变化时会触发当前字段数据源刷新。

下一步

字段配置详解 - 渲染模式、Lookup、字段监听详解
组织选择字段 - 组织架构选择
数据源字段 - 从候选数据列表中选择
字段配置总览 - 返回字段类型清单

属性明细

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

人员选择字段属性表

属性名	类型	含义	取值/存储值
`FieldType`	int	字段类型	`UserSelect = 30`
`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.Prefix` / `Properties.Suffix`	string	输入框前后缀	可空
`LookupByDataId`	bool	是否开启 Lookup	开启后不可撤销
`LookupMetaObjectId`	string	Lookup 对象 Id	固定为人员信息对象
`LookupMetaObjectCode`	string	Lookup 对象编码	固定为人员信息对象编码
`OpenFieldMonitor`	bool	是否开启字段监听	默认 `false`
`MonitorFields`	string	监听的字段编码	逗号分隔

选择模式与渲染模式枚举值

枚举	值	含义
`SelectModeEnum.Single`	0	单选
`SelectModeEnum.Multiple`	1	多选
`SelectRenderModeEnum.Select`	0	下拉选择器
`SelectRenderModeEnum.TreeSelect`	1	树形选择器
`SelectRenderModeEnum.RadioButtonOrCheckBox`	2	单选按钮/复选框
`SelectRenderModeEnum.Cascader`	3	级联选择器（多选）

存储示例

字段定义：

{
  "Code": "owner",
  "Name": "负责人",
  "FieldType": 30,
  "DataSourceSelect": "<默认人员数据源Id>",
  "SelectMode": 0,
  "SelectRenderMode": 0,
  "Properties": {
    "SelectDisplayMode": 1,
    "SelectTagColorRule": 0
  }
}

对象数据中的存储值（多选以逗号分隔）：

{
  "Fields": {
    "owner": { "Code": "owner", "Text": "张三", "Value": "u-1001" },
    "participants": { "Code": "participants", "Text": "张三,李四", "Value": "u-1001,u-1002" }
  }
}

概述​

配置项​

选择模式​

渲染模式​

展示与标签​

Lookup 与字段监听​

下一步​

属性明细​

人员选择字段属性表​

选择模式与渲染模式枚举值​

存储示例​

概述

配置项