2.2 KiB
Raw Permalink Blame History

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
加个外链应用
自建应用卡片
application
需要系统管理员权限
自定义菜单不会自动同步给已离线的用户,需刷新页面
不支持把自定义菜单注入到「应用市场」或「系统设置」
自定义菜单的 URL 必须能被 DooTask 前端 iframe / 跳转打开,未对外的内网地址需自行确保连通
v1.7.90

自定义微应用菜单

定义

自定义微应用菜单microapp_menu让管理员把任意外部网页或服务以「微应用卡片」的形式接入 DooTask无需打成插件。配置保存到系统设置项 microapp_menu,按用户身份过滤后下发到前端 microAppsMenus 状态。

关键属性

  • 应用 ID:唯一标识,例如 custom-okr
  • 菜单位置 location
    • application — 应用中心「常用」分区
    • application/admin — 应用中心「管理员」分区
    • main/menu — 主导航栏一级菜单
  • 可见范围 visible_toall(所有成员)/ admin(仅管理员)
  • 类型 typeiframe / 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(限管理员)

与插件微应用的关系

  • 插件微应用:通过应用市场安装后自动注册菜单,不可在此页编辑
  • 自定义菜单:完全由管理员手填,专门用于接入未打包成插件的外部系统

相关