5.4 KiB
5.4 KiB
导出功能说明
功能概述
系统提供了量表导出和报告导出功能，支持单个或批量导出数据。
1. 量表导出功能
功能位置
- 页面路径：心理测评管理 > 量表管理
- 按钮位置：量表列表页面顶部工具栏
功能说明
1.1 导出格式
- 格式：JSON格式
- 文件扩展名：
.json - 编码：UTF-8
1.2 导出内容
导出的JSON文件包含量表的完整数据，包括：
- 量表基本信息：量表编码、名称、类型、版本、描述等
- 因子列表：所有因子及其配置信息
- 因子计分规则：每个因子的计分规则，包含题目序号映射
- 题目列表：所有题目及其配置信息
- 选项列表：每个题目的所有选项
- 解释配置：因子解释和总体解释配置（包含factorCode用于导入时映射）
- 预警规则：预警规则配置（包含factorCode用于导入时映射）
1.3 使用方法
方式一：批量导出（推荐）
- 在量表列表页面，勾选需要导出的量表（可多选）
- 点击"导出"按钮
- 系统会导出所有选中的量表，生成一个JSON文件
方式二：导出所有量表
- 不勾选任何量表
- 点击"导出"按钮
- 系统会导出当前查询条件下的所有量表
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 使用方法
方式一：批量导出（推荐）
- 在报告列表页面，勾选需要导出的报告（可多选）
- 点击"导出"按钮
- 系统会导出所有选中的报告，生成一个Excel文件
方式二：按条件导出
- 使用搜索条件筛选报告
- 不勾选任何报告
- 点击"导出"按钮
- 系统会导出所有符合查询条件的报告
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量表
- 进入"量表管理"页面
- 找到"症状自评量表SCL-90"
- 勾选该量表
- 点击"导出"按钮
- 下载生成的JSON文件
示例2：导出所有已生成的报告
- 进入"测评报告"页面
- 在"生成状态"筛选中选择"已生成"
- 点击"搜索"按钮
- 不勾选任何报告（或全选）
- 点击"导出"按钮
- 下载生成的Excel文件
6. 常见问题
Q1: 导出失败怎么办？
A: 请检查：
- 是否有导出权限
- 网络连接是否正常
- 浏览器是否支持文件下载
- 查看浏览器控制台错误信息
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格式）
- ✅ 支持单个和批量导出
- ✅ 支持按查询条件导出