id, title, type, feature, scope, locale, aliases, related_tools, related_pages, prerequisites, negative, last_verified
| id |
title |
type |
feature |
scope |
locale |
aliases |
related_tools |
related_pages |
prerequisites |
negative |
last_verified |
| micro-app.menu.concept |
自定义微应用菜单 |
concept |
micro-app |
admin |
zh |
| 自定义应用菜单 |
| 自定义微应用 |
| 接入第三方网页 |
| microapp_menu |
| 加个外链应用 |
| 自建应用卡片 |
|
|
|
|
| 自定义菜单不会自动同步给已离线的用户,需刷新页面 |
| 不支持把自定义菜单注入到「应用市场」或「系统设置」 |
| 自定义菜单的 URL 必须能被 DooTask 前端 iframe / 跳转打开,未对外的内网地址需自行确保连通 |
|
v1.7.90 |
自定义微应用菜单
定义
自定义微应用菜单(microapp_menu)让管理员把任意外部网页或服务以「微应用卡片」的形式接入 DooTask,无需打成插件。配置保存到系统设置项 microapp_menu,按用户身份过滤后下发到前端 microAppsMenus 状态。
关键属性
- 应用 ID:唯一标识,例如
custom-okr
- 菜单位置 location:
application — 应用中心「常用」分区
application/admin — 应用中心「管理员」分区
main/menu — 主导航栏一级菜单
- 可见范围 visible_to:
all(所有成员)/ admin(仅管理员)
- 类型 type:
iframe / iframe_blank / inline / inline_blank / external
- URL:支持
{user_token} 占位符做 SSO
- 其他选项:
keep_alive 保持激活、auto_dark_theme 跟随暗黑、immersive 沉浸式、transparent 透明背景、disable_scope_css 禁用作用域样式
配置入口
- 桌面端:左侧栏「应用」→ 右上角「⋯」→「自定义应用菜单」
- 仅
userIsAdmin = true 显示该入口
接口
- 获取:
POST api/system/microapp_menu?type=get
- 保存:
POST api/system/microapp_menu?type=save(限管理员)
与插件微应用的关系
- 插件微应用:通过应用市场安装后自动注册菜单,不可在此页编辑
- 自定义菜单:完全由管理员手填,专门用于接入未打包成插件的外部系统
相关