183 lines
5.4 KiB
Markdown
183 lines
5.4 KiB
Markdown
|
# 导出功能说明
|
|||
|
|
|
|||
|
|
## 功能概述
|
|||
|
|
|
|||
|
|
系统提供了量表导出和报告导出功能，支持单个或批量导出数据。
|
|||
|
|
|
|||
|
|
## 1. 量表导出功能
|
|||
|
|
|
|||
|
|
### 功能位置
|
|||
|
|
- **页面路径**：心理测评管理 > 量表管理
|
|||
|
|
- **按钮位置**：量表列表页面顶部工具栏
|
|||
|
|
|
|||
|
|
### 功能说明
|
|||
|
|
|
|||
|
|
#### 1.1 导出格式
|
|||
|
|
- **格式**：JSON格式
|
|||
|
|
- **文件扩展名**：`.json`
|
|||
|
|
- **编码**：UTF-8
|
|||
|
|
|
|||
|
|
#### 1.2 导出内容
|
|||
|
|
导出的JSON文件包含量表的完整数据，包括：
|
|||
|
|
- **量表基本信息**：量表编码、名称、类型、版本、描述等
|
|||
|
|
- **因子列表**：所有因子及其配置信息
|
|||
|
|
- **因子计分规则**：每个因子的计分规则，包含题目序号映射
|
|||
|
|
- **题目列表**：所有题目及其配置信息
|
|||
|
|
- **选项列表**：每个题目的所有选项
|
|||
|
|
- **解释配置**：因子解释和总体解释配置（包含factorCode用于导入时映射）
|
|||
|
|
- **预警规则**：预警规则配置（包含factorCode用于导入时映射）
|
|||
|
|
|
|||
|
|
#### 1.3 使用方法
|
|||
|
|
|
|||
|
|
**方式一：批量导出（推荐）**
|
|||
|
|
1. 在量表列表页面，勾选需要导出的量表（可多选）
|
|||
|
|
2. 点击"导出"按钮
|
|||
|
|
3. 系统会导出所有选中的量表，生成一个JSON文件
|
|||
|
|
|
|||
|
|
**方式二：导出所有量表**
|
|||
|
|
1. 不勾选任何量表
|
|||
|
|
2. 点击"导出"按钮
|
|||
|
|
3. 系统会导出当前查询条件下的所有量表
|
|||
|
|
|
|||
|
|
#### 1.4 导出文件命名规则
|
|||
|
|
- **单个量表导出**：`{量表名称}_{时间戳}.json`
|
|||
|
|
- **批量导出**：`量表批量导出_{时间戳}.json`
|
|||
|
|
|
|||
|
|
#### 1.5 注意事项
|
|||
|
|
- 导出的JSON文件可以直接用于导入功能
|
|||
|
|
- 导出的数据包含完整的量表配置，可用于备份和迁移
|
|||
|
|
- 导出的factorCode信息可以确保导入时正确映射因子
|
|||
|
|
|
|||
|
|
## 2. 报告导出功能
|
|||
|
|
|
|||
|
|
### 功能位置
|
|||
|
|
- **页面路径**：心理测评管理 > 测评报告
|
|||
|
|
- **按钮位置**：报告列表页面顶部工具栏
|
|||
|
|
|
|||
|
|
### 功能说明
|
|||
|
|
|
|||
|
|
#### 2.1 导出格式
|
|||
|
|
- **格式**：Excel格式（.xlsx）
|
|||
|
|
- **文件扩展名**：`.xlsx`
|
|||
|
|
- **编码**：UTF-8
|
|||
|
|
|
|||
|
|
#### 2.2 导出内容
|
|||
|
|
导出的Excel文件包含报告的以下信息：
|
|||
|
|
- **报告ID**：报告的唯一标识
|
|||
|
|
- **测评ID**：关联的测评记录ID
|
|||
|
|
- **报告标题**：报告的标题
|
|||
|
|
- **报告类型**：标准报告/详细报告/简要报告
|
|||
|
|
- **报告摘要**：报告的摘要信息
|
|||
|
|
- **报告内容**：报告正文内容（HTML标签已转换为纯文本）
|
|||
|
|
- **生成状态**：已生成/未生成
|
|||
|
|
- **生成时间**：报告生成的时间
|
|||
|
|
- **创建时间**：报告创建的时间
|
|||
|
|
|
|||
|
|
#### 2.3 使用方法
|
|||
|
|
|
|||
|
|
**方式一：批量导出（推荐）**
|
|||
|
|
1. 在报告列表页面，勾选需要导出的报告（可多选）
|
|||
|
|
2. 点击"导出"按钮
|
|||
|
|
3. 系统会导出所有选中的报告，生成一个Excel文件
|
|||
|
|
|
|||
|
|
**方式二：按条件导出**
|
|||
|
|
1. 使用搜索条件筛选报告
|
|||
|
|
2. 不勾选任何报告
|
|||
|
|
3. 点击"导出"按钮
|
|||
|
|
4. 系统会导出所有符合查询条件的报告
|
|||
|
|
|
|||
|
|
#### 2.4 导出文件命名规则
|
|||
|
|
- 默认文件名：`报告导出_{时间戳}.xlsx`
|
|||
|
|
|
|||
|
|
#### 2.5 注意事项
|
|||
|
|
- Excel文件中的报告内容已去除HTML标签，转换为纯文本
|
|||
|
|
- 报告内容较长时，Excel单元格会自动换行显示
|
|||
|
|
- 可以方便地进行数据分析和统计
|
|||
|
|
|
|||
|
|
## 3. 权限要求
|
|||
|
|
|
|||
|
|
### 量表导出权限
|
|||
|
|
- **权限代码**：`psychology:scale:export`
|
|||
|
|
- **权限名称**：量表导出
|
|||
|
|
- **默认角色**：管理员
|
|||
|
|
|
|||
|
|
### 报告导出权限
|
|||
|
|
- **权限代码**：`psychology:report:export`
|
|||
|
|
- **权限名称**：报告导出
|
|||
|
|
- **默认角色**：管理员
|
|||
|
|
|
|||
|
|
## 4. 技术实现
|
|||
|
|
|
|||
|
|
### 4.1 后端实现
|
|||
|
|
|
|||
|
|
#### 量表导出
|
|||
|
|
- **Controller**：`PsyScaleController.exportScales()`
|
|||
|
|
- **Service**：`PsyScaleService.exportScales()`
|
|||
|
|
- **返回格式**：JSON文件下载
|
|||
|
|
|
|||
|
|
#### 报告导出
|
|||
|
|
- **Controller**：`PsyAssessmentReportController.exportReports()`
|
|||
|
|
- **Service**：使用`ExcelUtil`工具类
|
|||
|
|
- **返回格式**：Excel文件下载
|
|||
|
|
|
|||
|
|
### 4.2 前端实现
|
|||
|
|
|
|||
|
|
#### 量表导出
|
|||
|
|
- **API方法**：`exportScale(scaleIds)`
|
|||
|
|
- **文件类型**：`application/json`
|
|||
|
|
- **下载方式**：Blob对象下载
|
|||
|
|
|
|||
|
|
#### 报告导出
|
|||
|
|
- **API方法**：`exportReport(reportIds, queryParams)`
|
|||
|
|
- **文件类型**：`application/vnd.openxmlformats-officedocument.spreadsheetml.sheet`
|
|||
|
|
- **下载方式**：Blob对象下载
|
|||
|
|
|
|||
|
|
## 5. 使用示例
|
|||
|
|
|
|||
|
|
### 示例1：导出SCL-90量表
|
|||
|
|
|
|||
|
|
1. 进入"量表管理"页面
|
|||
|
|
2. 找到"症状自评量表SCL-90"
|
|||
|
|
3. 勾选该量表
|
|||
|
|
4. 点击"导出"按钮
|
|||
|
|
5. 下载生成的JSON文件
|
|||
|
|
|
|||
|
|
### 示例2：导出所有已生成的报告
|
|||
|
|
|
|||
|
|
1. 进入"测评报告"页面
|
|||
|
|
2. 在"生成状态"筛选中选择"已生成"
|
|||
|
|
3. 点击"搜索"按钮
|
|||
|
|
4. 不勾选任何报告（或全选）
|
|||
|
|
5. 点击"导出"按钮
|
|||
|
|
6. 下载生成的Excel文件
|
|||
|
|
|
|||
|
|
## 6. 常见问题
|
|||
|
|
|
|||
|
|
### Q1: 导出失败怎么办？
|
|||
|
|
**A**: 请检查：
|
|||
|
|
1. 是否有导出权限
|
|||
|
|
2. 网络连接是否正常
|
|||
|
|
3. 浏览器是否支持文件下载
|
|||
|
|
4. 查看浏览器控制台错误信息
|
|||
|
|
|
|||
|
|
### Q2: 导出的JSON文件可以导入吗？
|
|||
|
|
**A**: 可以。导出的JSON文件完全符合导入格式要求，可以直接用于导入功能。
|
|||
|
|
|
|||
|
|
### Q3: 导出的Excel文件如何打开？
|
|||
|
|
**A**: 可以使用Microsoft Excel、WPS Office、Google Sheets等软件打开。
|
|||
|
|
|
|||
|
|
### Q4: 可以导出其他格式吗？
|
|||
|
|
**A**: 目前支持：
|
|||
|
|
- 量表导出：JSON格式
|
|||
|
|
- 报告导出：Excel格式
|
|||
|
|
- 未来可能会支持更多格式（如PDF、CSV等）
|
|||
|
|
|
|||
|
|
## 7. 更新日志
|
|||
|
|
|
|||
|
|
### 2024-01-XX
|
|||
|
|
- ✅ 新增量表导出功能（JSON格式）
|
|||
|
|
- ✅ 新增报告导出功能（Excel格式）
|
|||
|
|
- ✅ 支持单个和批量导出
|
|||
|
|
- ✅ 支持按查询条件导出
|
|||
|
|
|