SuperAPI AI 工具集

frappe-impl-workspace

前端与建站

查看项目

更新于 10-15 22:17

技能介绍

用途:该技能面向在 Frappe v14/v15/v16 中创建与定制 Workspace 页面的工作流。Workspace 是 Frappe Desk 中基于块的仪表盘与导航页面,采用 12 列网格布局。公开 Workspace 对所有有权限用户可见,编辑需 Workspace Manager 角色;私有 Workspace 位于 My Workspaces 下,任意 Desk 用户均可创建。

主要能力:涵盖 Workspace DocType 的关键字段,如 label、title、module、parent_page、icon、type、sequence_id、content、for_user、roles、app、indicator_color;以及 6 个子表:charts、shortcuts、links、quick_lists、number_cards、custom_blocks。组件类型包括 header、chart、number_card、shortcut、card、quick_list、custom_block、text、spacer、onboarding,col 取值须为 1-12 且同行块之和不超过 12。

使用方式:可通过 Workspace Builder UI 拖拽创建,或用 frappe.new_doc 编程方式创建并设置 content JSON。设置 content JSON 时必须同步添加对应的子表行,不可手动编辑 JSON 而不更新子表。组件依赖的 Number Card、Dashboard Chart 等文档需先创建;Shortcut 是 Workspace 的子表条目而非独立文档。权限分三层:模块访问(主)、可选的角色限制、以及编辑公开 Workspace 所需的 Workspace Manager 角色。

适用场景:模块自定义仪表盘、个人仪表盘、侧边栏导航链接,以及通过自定义应用分发 Workspace。自定义应用分发时需将 Number Cards、Dashboard Charts、Custom HTML Blocks 通过 hooks.py fixtures 一并发布,仅 Workspace JSON 不足。

限制:暂未提供具体收费与价格信息;版本差异以资料所列 v14/v15/v16 为准,v15 新增 type、app、indicator_color 等字段,v16 新增欢迎页头配置与名称自动去重;升级后须测试渲染。