# 导出功能说明

## 功能概述

系统提供了量表导出和报告导出功能，支持单个或批量导出数据。

## 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格式）
- ✅ 支持单个和批量导出
- ✅ 支持按查询条件导出