数据列表页用户字段配置
这篇文档解决什么问题
用户字段显示为原始 ID
在数据列表页中,负责人、审批人等用户字段应显示姓名或人员信息。如果页面显示 ["80"]、["81"]、["77","80"] 这类原始值,通常说明该字段没有被识别为用户类型。
AI 自动修复没有生效时,可以按本文步骤检查字段含义,并手工修改 DO 配置。

为什么会出现这个问题
数据库分析阶段可能只识别到字段存储的是文本或 ID,没有识别出它对应平台用户,因此生成了 doType="TEXT"。需要确认字段的业务含义,再将它改为 doType="USER"。
操作步骤
Step 1:从业务页面进入页面配置页
先在业务页面确认你看到的问题字段确实不符合预期,例如“负责人”显示成原始值数组。然后点击页面右上角的编辑页面。

Step 2:进入数据编辑并开启编辑
进入页面配置页后,切换到数据编辑中的DO模型。
如果当前数据集还没有进入可编辑状态,点击右下角的编辑,开启字段编辑。

Step 3:找到“负责人”对应的配置字段
在DO模型或可视化 DO 属性区域,找到“负责人”实际对应的那个配置字段。
以截图为例:
- 字段编码:
assignee_id - 字段名称:
负责人ID
这一步一定要确认你改的是“负责人”真正对应的配置字段,而不是只看页面上显示了“负责人”这几个字,就去改一个名称相近的字段。
Step 4:把“负责人ID”改成员工选择器
如果这个字段确认属于业务里用来选择某个人的字段,就把 负责人ID 这个字段的类型从文本改成员工选择器。
从截图可以看到,负责人ID 当前还是文本,这就是页面上的“负责人”只显示原始值的直接原因。
如果你需要核对字段编码,这个字段对应的是 assignee_id。
在这一步里,把字段类型改成员工选择器,本质就是把这个字段按用户方式处理。
修改目标是:
- 原类型:
文本 - 修改后:
员工选择器

可以验证一下doType是否已经配置为USER
{
"name": "assignee_id",
"displayName": "负责人",
"dbType": "VARCHAR",
"dbTypeLen": 50,
"doType": "USER"
},
Step 5:保存并发布
改完后,点击页面底部或编辑区域中的保存并发布。
如果只改了字段但没有发布,线上页面不会生效。
对于使用了需求数据集的数据列表页,这一步发布后,相关页面会一起按新的字段类型生效,不只是当前看到的这一页生效。
发布完成后,可以点击右上角的访问系统,回到对应的业务页面验证结果。

页面配置页里可以先确认什么
保存并发布后,如果你还停留在页面配置页,也可以先在右侧区域确认这些变化。
这几张图用于帮助你确认配置已经按用户方式生效,但它们还不是最终对外的线上验收结果。
- 在页面配置页的表格中,“负责人ID”这一列已经按用户方式展示,这是保存并发布后的即时验证效果

- 在页面配置页中,点击
新增后,新增区域里的“负责人ID”会按用户方式展示和选择

- 在页面配置页中,点击
更新后,编辑区域里的“负责人ID”也会按用户方式展示和选择

- 在页面配置页中,点击
详情后,详情区域里的“负责人ID”会按用户方式展示

最终线上验收结果
修改成功并发布后,使用了需求数据集的数据列表页都会按用户方式更新。
建议从页面配置页点击右上角的访问系统,回到最终对外的业务页面后再做验收。
- 最终对外的业务页面中,“负责人”不再显示
["80"]这类原始值,而是显示为用户信息

如果改完仍然显示原始值,优先检查下面几项:
- 你改的是不是“负责人”真正对应的字段
assignee_id - 这个字段是否真的属于业务引用字段
- 是否已经执行
保存并发布
常见错误
错误 1:把账户表本身的字段改成员工选择器
如果这个字段属于会员表、员工表这类账户表本身,而不是业务页面里“引用某个人”的字段,就不要照本文处理。只有负责人、审批人、部门负责人这类业务引用字段,才适合按本文修改。
错误 2:把创建人、更新人也当成本文场景
创建人、更新人属于系统字段,在 schema 驱动渲染页面里通常已经按系统逻辑生成,不需要通过本文这种页面手工改法再处理一次。
错误 3:只看字段中文名,不看字段真实含义
字段名里出现“负责人”“员工”“工号”,都不能直接说明它一定适合改成员工选择器。先确认它是不是业务里用来引用某个人的字段,而不是账户表本身的字段。
错误 4:改完没有发布
这是最常见的操作遗漏。没有执行保存并发布,页面表现不会更新。
你只需要记住的判断顺序
- 这个字段是不是在业务里引用某个人
- 如果它属于账户表本身的字段,或者是创建人、更新人这类系统字段,通常不用按本文手工改
- 如果当前字段还是
文本,再改成员工选择器 - 改完后一定回到页面验证,并确认已经
保存并发布