办公桌

Frappe 框架自带一个功能丰富的管理界面,称为 Desk。它会读取 DocType 的元数据,
并自动为你的 DocType 构建列表视图、表单视图、报表视图等。
Desk 供类型为“系统用户”的用户使用。

在本节中,我们将讨论 Desk 提供了哪些视图以及如何配置它们。

  • 工作区
  • 快捷导航栏
  • 列表视图
  • 表单视图
  • 表格视图
  • 报表生成器
  • 树形视图
  • 日历视图
  • 甘特图视图
  • 看板视图
  • Desk 主题

工作区

登录后,你会看到 Desk,它带有一个固定的侧边栏,其中包含基于应用模块的一些标准项目。
每个侧边栏项目都链接到一个称为工作区的页面。

关于工作区 →

快捷导航栏

快捷导航栏可帮助你在系统中任意导航、创建新记录、搜索文档,
甚至执行数学运算。


使用快捷导航栏导航待办事项

列表视图

除子表和单文档类型外,所有 DocType 都会生成列表视图。

列表视图功能丰富,其中一些功能包括:

  1. 筛选
  2. 排序
  3. 分页
  4. 按标签筛选
  5. 切换到报表、日历、甘特图、看板等视图

了解更多关于列表 API 的信息。

表单视图

表单视图用于以表单布局查看记录。此视图包含很多功能,
但其主要目的是查看和编辑记录。
文档可以分配给其他用户或与其共享,并且可以包含任意附件和标签,
所有这些都可以在表单侧边栏中看到。


表单视图

当您滚动到表单底部时,会看到表单时间线。
表单时间线按时间倒序显示邮件、评论、编辑和其他事件。


表单时间线

了解更多关于表单 API 的信息。

表格视图

表格视图在表单视图中用作表格,用于插入多条记录。
用户可以在表单中配置表格视图的列。

报表生成器

报表生成器是一个通用工具,用于从 DocType 自定义和构建表格数据。
你可以选择要显示的列、要应用的筛选器、排序顺序,并通过为报表命名来保存此配置。
你还可以显示子表数据,并根据子记录筛选文档。
你还可以对某一列应用分组依据,并使用计数、求和和平均值等聚合方法。


报表生成器功能

树形视图

Frappe 还支持使用嵌套集模型存储树形结构记录。
如果某个 DocType 被配置为树形结构,则可以在树形视图中查看它。


树形视图

日历视图

可以为包含开始日期和结束日期的 DocType 配置日历视图。


日历视图

配置文件应命名为 {doctype}_calendar.js,并且应位于
doctype 目录中。

以下是 Event DocType 的日历视图配置示例,必须设置在 event_calendar.js 文件中。

frappe.views.calendar['Event'] = {
 field_map: {
 start: 'starts_on',
 end: 'ends_on',
 id: 'name',
 allDay: 'all_day',
 title: 'subject',
 status: 'event_type',
 color: 'color'
 },
 style_map: {
 Public: 'success',
 Private: 'info'
 },
 order_by: 'ends_on',
 get_events_method: 'frappe.desk.doctype.event.event.get_events'
}

甘特图视图

甘特图视图使用与日历相同的配置文件,因此每个具有日历视图的 DocType 也具有甘特图视图。

如果需要为 Event DocType 的甘特图视图覆盖某些设置(例如 order_by 字段),可以在 event_calendar.js 文件中设置配置,内容如下。

frappe.views.calendar['Event'] = {
 field_map: {
 start: 'starts_on',
 end: 'ends_on',
 id: 'name',
 allDay: 'all_day',
 title: 'subject',
 status: 'event_type',
 color: 'color'
 },
 gantt: { // The values set here will override the values set in the object just for Gantt View
 order_by: 'starts_on',
 }
 style_map: {
 Public: 'success',
 Private: 'info'
 },
 order_by: 'starts_on',
 get_events_method: 'frappe.desk.doctype.event.event.get_events'
}


甘特图视图

看板视图

可以为任何具有带选项的选择字段的 DocType 创建看板视图。
这些选项将成为看板板的列名。

深色主题

Frappe 框架对深色主题提供了一流支持。要切换主题,请点击屏幕右上角的头像,然后点击“切换主题”。点击“切换主题”后,你将看到以下弹窗,可以轻松在可用主题之间切换。要切换到深色主题,请选择“Timeless Night”。

注意:你也可以按 CTRL + SHIFT + G 打开此弹窗。