mirror of
https://github.com/kuaifan/dootask.git
synced 2026-07-31 10:25:59 +00:00
64 lines
2.8 KiB
Markdown
64 lines
2.8 KiB
Markdown
---
|
||
id: approve.export.howto
|
||
title: 导出审批数据
|
||
type: howto
|
||
feature: approve
|
||
scope: admin
|
||
locale: zh
|
||
aliases:
|
||
- 导出审批
|
||
- 审批数据导出
|
||
- 下载审批 Excel
|
||
- 审批报表
|
||
- 请假记录导出
|
||
- 审批怎么导出
|
||
related_tools: []
|
||
related_pages: [application]
|
||
prerequisites:
|
||
- 应用市场已安装 approve 插件
|
||
- 当前用户是系统管理员（普通成员看不到「导出」按钮）
|
||
negative:
|
||
- 单次导出**最多 35 天**，超过会报「日期范围限制最大35天」需分段导出
|
||
- 必须选择"流程分类"（即流程模板名），不支持一次导全部模板
|
||
- 导出文件为 zip 包内含一个 xlsx，**不支持** CSV / JSON 直接下载
|
||
- 没有数据时会推送「没有任何数据」提示，不会生成空文件
|
||
last_verified: v1.7.90
|
||
---
|
||
|
||
# 导出审批数据
|
||
|
||
## 入口
|
||
- 桌面端：左侧栏「应用」→「审批中心」→ 右上角「导出审批数据」按钮（仅管理员可见）
|
||
- 移动端：审批中心右上角图标条同名按钮（同样仅管理员）
|
||
|
||
## 接口
|
||
前端调 `api/approve/export`（POST）→ 控制器方法 `export`：
|
||
- 必传 `proc_def_name`（流程模板名）+ `date`（`[start, end]` 两个日期）
|
||
- 可选 `state`（0 全部 / 1 审批中 / 2 通过 / 3 拒绝 / 4 撤回）+ `is_finished`
|
||
- 服务端用 Swoole 协程异步生成，不阻塞请求；接口立即返回 `success`
|
||
|
||
## 操作步骤
|
||
1. 弹窗中选择「流程分类」（下拉，来自已发布的流程模板列表）
|
||
2. 选「状态」（默认全部）
|
||
3. 选「日期范围」（开始 + 结束，≤ 35 天）
|
||
4. 点「确定」→ 立即关闭弹窗
|
||
5. 主程序系统机器人在私聊推送「正在导出审批数据，请稍等...」
|
||
6. 协程异步处理完成后，机器人推送一条带下载链接的 `file_download` 模板消息
|
||
|
||
## 导出列（24 列）
|
||
申请编号、标题、申请状态、发起时间、完成时间、发起人工号、发起人 User ID、发起人姓名、发起人部门、发起人部门 ID、部门负责人、历史审批人、历史办理人、审批记录、当前处理人、审批节点、审批人数、审批耗时、假期类型、开始时间、结束时间、时长、请假事由、请假单位。
|
||
|
||
## 文件命名与位置
|
||
- 临时存放：`storage/app/temp/approve/export/<年月>/审批记录_<时间戳>.zip`
|
||
- 链接形式：`api/approve/down?key=<加密 key>`（带签名，过期失效）
|
||
|
||
## 常见报错
|
||
- `日期选择错误`：日期未选或格式错；用日期选择器选
|
||
- `日期范围限制最大35天`：缩短范围分段导出
|
||
- `没有任何数据`：所选模板 + 状态 + 日期范围内无审批单
|
||
- `系统机器人不存在`：联系超级管理员检查机器人初始化（极少见）
|
||
|
||
## 相关
|
||
- 模板列表来源：[[approve.template.concept]]
|
||
- 单条记录删除：[[approve.delete.howto]]
|