评论表

评论社区版+

介绍

评论表适合保存围绕业务记录产生的讨论、反馈和批注。比如任务评论、审批意见、文章评论、客户反馈都可以用评论表保存。

评论表通常不单独作为主业务表使用。更常见的做法是:先创建评论表,再在业务表中配置关系字段,最后在业务记录的详情或弹窗中添加评论区块。

comment-collection-2025-11-01-00-39-01

适用场景

评论表适合这些业务场景:

  • 任务、需求、缺陷的协作讨论
  • 审批单、工单、合同的处理意见
  • 文章、知识库、公告的评论
  • 客户反馈、售后跟进、内部备注

使用流程

评论表通常配合业务表和评论区块使用:

  1. 创建评论表,用来保存评论内容、回复关系、创建人、创建时间等信息。
  2. 在业务表中创建关系字段,关联到评论表。比如在「任务」表中关联「任务评论」表。
  3. 在业务表的详情页或弹窗中添加评论区块。
  4. 用户在评论区块中发表评论或回复,评论数据会写入评论表,并关联到当前业务记录。
  5. 根据业务需要配置评论表权限,控制谁可以查看、创建或删除评论。

创建配置

在主数据库中点击「Create collection」,选择「Comment collection」可以创建评论表。

comment-collection-2025-11-01-00-37-10

配置说明
Collection display name数据表在界面中显示的名称,比如「任务评论」「审批意见」「文章评论」。
Collection name数据表的标识名称,用于 API、关系字段、权限、工作流等内部引用。
Inherits选择要继承的父表。只有主数据库是 PostgreSQL 时可见。
Categories数据表分类。分类只影响数据表管理界面的组织方式,不改变数据表结构。
Description数据表说明。可以写这个评论表服务于哪个业务对象、由谁维护、评论权限怎么设计。
Preset fields预设字段。创建评论表时建议保留系统字段和评论表内置字段。

内置字段

评论表创建后通常包含这些内置字段。评论区块主要依赖 contentcreatedBycreatedAt 展示评论内容、评论人和评论时间。

字段字段名说明
IDid默认主键字段,用于唯一标识一条评论记录。
评论内容content保存用户输入的评论正文,默认使用 Markdown Vditor 组件。
创建时间createdAt自动记录评论创建时间,评论区块会用它展示评论时间。
创建人createdBy自动记录发表评论的用户,评论区块会用它展示评论人。
更新时间updatedAt自动记录评论最后一次更新的时间。
更新人updatedBy自动记录最后一次更新评论的用户。
空间space启用多空间插件后可用,用于按空间隔离数据。没有启用多空间时不会出现。
注意

评论表内置字段通常由评论区块维护,不建议随意删除或改成其他业务含义。如果需要保存评论分类、处理状态等信息,可以新增业务字段。

主键字段

评论表和普通表一样需要主键字段。评论区块会通过主键定位评论记录和回复关系。

如果评论表没有主键,需要在编辑数据表时设置「Record unique key」,否则评论区块可能无法正确查看、回复或删除评论。

建立关联关系

在业务表中创建关系字段,关联到评论表

页面配置使用

评论表通常通过评论区块使用。你可以在业务表的详情页、弹窗或记录页中添加评论区块,让用户围绕当前记录发表评论。

Enable Comments Collection

配置位置用途
详情区块在业务记录详情中展示评论入口。
表单区块配合业务表编辑流程使用评论关系字段。
评论区块展示评论列表、发表评论和回复评论。

编辑配置

在数据表列表中,点击评论表右侧的「Edit」,可以修改数据表显示名称、分类、说明、简单分页模式和「Record unique key」等配置。

评论表上线后,不建议随意调整评论内容字段和回复关系字段。评论区块、权限、工作流和 API 可能会依赖这些字段。

删除数据表

在数据表列表中,点击评论表右侧的「Delete」,可以删除评论表。

删除评论表会删除评论记录、回复关系和相关 Collection 元数据。删除前先确认业务表中的关系字段、评论区块、权限、工作流和 API 是否仍然依赖它。

警告

删除评论表会让已有业务记录失去评论数据。评论通常承载协作过程和处理意见,操作前先确认是否需要备份或归档。

相关链接

  • 普通表 — 查看通用配置和区块使用方式
  • 关系字段 — 了解业务表与评论表的关联方式
  • 评论插件 — 查看评论区块和评论能力
  • 多空间 — 了解空间字段和空间隔离能力