mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 18:35:56 +00:00
53 lines
2.2 KiB
Markdown
53 lines
2.2 KiB
Markdown
---
|
||
id: data-export.concept
|
||
title: 数据导出概览
|
||
type: concept
|
||
feature: data-export
|
||
scope: admin
|
||
locale: zh
|
||
aliases:
|
||
- 数据导出是什么
|
||
- 导出 Excel
|
||
- 导出报表
|
||
- 后台能导出哪些数据
|
||
- 管理员导出
|
||
related_tools: []
|
||
related_pages: [application]
|
||
prerequisites:
|
||
- 需要系统管理员权限（userIsAdmin）
|
||
negative:
|
||
- 导出文件不直接下载到浏览器，而是由系统机器人发到管理员的私聊
|
||
- 不支持普通成员自助导出，全部入口仅管理员可见
|
||
- 不支持导出原始 JSON / 数据库表，只导出预设字段的 Excel
|
||
last_verified: 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]]。
|