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
data-export.concept 数据导出概览 concept data-export admin zh
数据导出是什么
导出 Excel
导出报表
后台能导出哪些数据
管理员导出
application
需要系统管理员权限userIsAdmin
导出文件不直接下载到浏览器,而是由系统机器人发到管理员的私聊
不支持普通成员自助导出,全部入口仅管理员可见
不支持导出原始 JSON / 数据库表,只导出预设字段的 Excel
v1.7.90

数据导出概览

定义

数据导出是 DooTask 内置的管理员功能,把系统数据按预设字段整理成 Excel 文件,通过系统机器人(system-msg)异步发到管理员的私聊。需要系统管理员(userIsAdmin)才能触发。

支持的导出类型

后台「数据导出」菜单实际提供 4 类导出,分别对应不同的 API

名称 API 说明
任务统计 api/project/task/export 按成员 + 时间段导出任务,含负责人/工时/状态
超期任务 api/project/task/exportoverdue 全系统未完成且已超期的任务
审批数据 api/approve/export 按流程分类 + 状态 + 时间段导出审批单
签到数据 api/system/checkin/export 按成员 + 日期段 + 时间段导出签到记录

关键属性

  • 异步生成:触发后立即返回,文件由 Swoole 协程后台生成(go(...)),完成后才发消息
  • 下载链接限时:消息中的下载链接(api/.../down)使用 Down::cache_decode() 解码,链接过期文件失效
  • 机器人通知:所有导出完成消息发送方都是 system-msg 系统机器人
  • 范围限制:每种导出都有自己的成员数 / 日期范围上限(通常单次 ≤ 35 天、≤ 50 个成员),具体在每个子类型的提示文案里说明

不支持

  • 不支持导出工作报告、用户列表、项目列表(产品里未开放对应入口)
  • 不支持自定义字段选择,导出列固定
  • 不支持定时 / 周期性自动导出

入口

管理员侧入口和操作步骤见 data-export.entry.menu-map