Skip to content

数据列表页用户字段配置

这篇文档解决什么问题

用户字段显示为原始 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

JSON
  {
    "name": "assignee_id",
    "displayName": "负责人",
    "dbType": "VARCHAR",
    "dbTypeLen": 50,
    "doType": "USER"
  },

图片展示的是QZYT-COWORK运营平台的页面,左侧为应用管理、页面研发等导航栏,右侧是RobotBase应用的页面配置页…

Step 5:保存并发布

改完后,点击页面底部或编辑区域中的保存并发布

如果只改了字段但没有发布,线上页面不会生效。

对于使用了需求数据集的数据列表页,这一步发布后,相关页面会一起按新的字段类型生效,不只是当前看到的这一页生效。

发布完成后,可以点击右上角的访问系统,回到对应的业务页面验证结果。

保存并发布

页面配置页里可以先确认什么

保存并发布后,如果你还停留在页面配置页,也可以先在右侧区域确认这些变化。

这几张图用于帮助你确认配置已经按用户方式生效,但它们还不是最终对外的线上验收结果。

  • 在页面配置页的表格中,“负责人ID”这一列已经按用户方式展示,这是保存并发布后的即时验证效果

页面配置页中表格显示用户

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

页面配置页中新增时显示用户选择效果

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

页面配置页中更新时显示用户选择效果

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

页面配置页中详情展示用户

最终线上验收结果

修改成功并发布后,使用了需求数据集的数据列表页都会按用户方式更新。

建议从页面配置页点击右上角的访问系统,回到最终对外的业务页面后再做验收。

  • 最终对外的业务页面中,“负责人”不再显示 ["80"] 这类原始值,而是显示为用户信息

列表页显示用户

如果改完仍然显示原始值,优先检查下面几项:

  • 你改的是不是“负责人”真正对应的字段 assignee_id
  • 这个字段是否真的属于业务引用字段
  • 是否已经执行保存并发布

常见错误

错误 1:把账户表本身的字段改成员工选择器

如果这个字段属于会员表、员工表这类账户表本身,而不是业务页面里“引用某个人”的字段,就不要照本文处理。只有负责人、审批人、部门负责人这类业务引用字段,才适合按本文修改。

错误 2:把创建人、更新人也当成本文场景

创建人、更新人属于系统字段,在 schema 驱动渲染页面里通常已经按系统逻辑生成,不需要通过本文这种页面手工改法再处理一次。

错误 3:只看字段中文名,不看字段真实含义

字段名里出现“负责人”“员工”“工号”,都不能直接说明它一定适合改成员工选择器。先确认它是不是业务里用来引用某个人的字段,而不是账户表本身的字段。

错误 4:改完没有发布

这是最常见的操作遗漏。没有执行保存并发布,页面表现不会更新。

你只需要记住的判断顺序

  1. 这个字段是不是在业务里引用某个人
  2. 如果它属于账户表本身的字段,或者是创建人、更新人这类系统字段,通常不用按本文手工改
  3. 如果当前字段还是文本,再改成员工选择器
  4. 改完后一定回到页面验证,并确认已经保存并发布

基于飞书知识库同步生成,内容以飞书源文档为准