【教程】第八章:知识库——学海无涯
8.1 欢迎来到新的一章
在本章中,我们将深入学习如何构建一个知识库。这将是一个综合性的模块,帮助我们管理和组织文档、任务和信息。通过设计和创建一个树形结构的文档表,我们将实现对文档的状态、附件和关联任务的高效管理。
8.2 数据库设计初探
8.2.1 基础设计与文档表的创建
首先,我们从一个简单的数据库设计开始,为知识库构建一个“文档表”来记录所有文档的信息。文档表包括以下关键字段:
标题 (Title):这是文档的名称,使用单行文本格式。
内容 (Content):文档的详细内容,使用支持 Markdown 的多行文本格式。
文档状态 (Status):用于标记文档的当前状态,包括草稿、已发布、已归档和已删除四个选项。
附件 (Attachment):可添加文件和图片等附件,丰富文档内容。
关联任务 (Related Task):这是一个多对一关系字段,用于将文档与某个任务关联,方便任务管理中的文档引用。
我们也将随着功能扩展,在文档管理系统中逐步添加其他字段。
8.2.2 树形结构的构建与目录管理
树结构表(由树表插件提供),树形结构,其中每个数据项都可以有一个或多个子项,而这些子项又可以有自己的子项。
为确保文档的组织和层次,我们的文档表选择树结构表,这样便于实现父子关系的分类管理。创建树结构表时,系统自动生成以下字段:
父记录 ID:用于记录当前文档的上级文档。
父记录:多对一字段,帮助我们实现父子关联关系。
子记录:一对多字段,便于查看某个文档下的所有子文档。
这几个字段用来维护一张树结构表的目录层级,所以不建议修改。
同时我们需要创建与任务表的关联关系(多对一),带上反向关联,方便我们需要时,在任务关联弹窗内创建文档列表。
8.3 创建文档管理页面
8.3.1 新建文档管理菜单
在系统的主菜单中,添加一个新的页面——“文档管理”,并选择合适的图标。然后,为我们的文档表创建一个表格区块。在表格区块中添加基本的增、删、改、查操作,并录入几条测试数据来测试数据表的设计是否正常。
练习
尝试在文档管理页面添加一个名为“文档 1”的父文档。
为“文档 1”添加一个子文档,命名为“第一章”。
8.3.2 转换为树表格视图
我知道你可能疑惑,为什么不是目录树结构?
默认情况下,表格区块会显示为普通表格视图,我们来手动开启:
点击表格区块右上角 > 树表格。
你会发现勾选的一瞬间,树表格下方多了“展开全部”的开关。
同时刚才创建的 “第一章” 消失了。
点击树表格下方的激活“展开全部”选项。
此时,我们会看到文档的父子结构显示得更加直观,可以轻松查看并展开所有层级文档。
我们顺手追加 “添加子记录” 操作。
树表转换成功!
8.3.3 “添加子记录” 配置
我们绘制一下添加需要的基本内容。注意这个时候如果我们勾选了父记录字段,会发现默认是 “只读(不可编辑)” 状态,因为我们默认是在当前文档下创建的。
任务数据太多的话,你可能会觉得分配关联任务特别麻烦,我们可以给任务筛选设置一个默认值,就让它等于父记录关联的任务吧。
默认值可能没有即时生效,我们关闭再点击看看,已经自动填充啦~
8.4 配置表单模板与任务关联
8.4.1 创建表格和表单模板
为了便于后续管理,我们将文档的表格、创建和编辑表单保存为模板,以便在其他页面复用。
8.4.2 文档表格区块复制展示
在任务表的查看弹窗中,添加一个新的标签页——“文档”。在该标签页中,添加表单区块 > 其他记录 > 文档表 >“复制模板”> 点击将我们之前创建的文档表单模板引入。(切记选择 复制模板)
这种方式便于所有文档列表的创建。
8.4.3 任务关联改造
由于我们是复制的外部表格模板,并没有和任务表关联。你会发现展示出了全部的文档数据,肯定不是我们预期的效果。
这种情况比较常见,如果我们没有创建对应关系字段,又需要展示关联数据的话,就需要对二者做手动关联。(切记我们采用复制模板,不要选择引用模板,不然我们做的所有更改会同步到其他表格区块!)
数据展示关联
我们点击表格区块右上角,“设置数据范围”为:
【任务/ID】= 【当前弹窗记录/ID】
成功,目前表格内留下来的文档都会是我们任务所绑定的。
添加表单区块关联。
进入添加区块:
对于关联任务表字段,设置默认值 >【上级弹窗记录】。
上级弹窗 属于我们所在任务数据的“查看”操作中,会直接绑定对应的任务数据。
我们设置只读(阅读模式),代表在当前弹窗内,只能绑定当前任务。
搞定!现在新增、展示都会是所在任务关联的文档啦。
细心的你可以补充一下 “编辑”、“添加子任务”里面的关联筛选。
为了让树结构更加清晰明显,操作列更整齐美观点,我们把标题挪至第一列。
8.5 文档管理中的筛选与搜索
8.5.1 添加筛选区块
我们顺便给文档表增加筛选功能吧。
在文档管理页面添加一个筛选区块。
选择筛选中的表单,拖到最上面。
勾选标题、状态、任务表字段等作为筛选条件。
添加“筛选”和“重置”操作。
这个表单就是我们的搜索框,方便在输入关键词后快速查找相关文档。
8.5.2 连接数据区块
这个时候你会发现点击之后没效果,我们还需要最后一步:具备搜索功能的区块之间互相连接。
我们点击区块右上角配置 > 连接数据区块。
点击开启需要被连接的区块,测试搜索。
通过点击筛选区块的右上角配置按钮,将筛选区块与文档表的主数据区块连接。这样,每次在筛选区块中设置条件后,表格区块会根据条件自动更新结果。
8.6 知识库权限设置
为确保文档安全和管理规范,可以根据角色为文档库分配权限。不同角色的用户可以根据权限配置,对文档进行查看、编辑或删除操作。
不过我们接下来会改造文档表,加上新闻、任务公告的功能,权限可以放开一点哦。
8.7 小结与下一步
在本章中,我们创建了一个基本的知识库,包括文档表、树形结构和与任务的关联展示。通过为文档添加筛选区块和模板复用,我们实现了高效的文档管理。
接下来,我们将进入下一章,学习如何搭建一个包含数据分析图表,重要信息展示的个人仪表盘!
继续探索,尽情发挥你的创造力!如果遇到问题,不要忘了随时可以查阅 NocoBase 官方文档 或加入 NocoBase 社区 进行讨论。
评论