400 lines
14 KiB
Markdown
400 lines
14 KiB
Markdown
# 新量表导入完整操作指南
|
||
|
||
## 📋 概述
|
||
|
||
本文档详细说明如何将一个新的心理量表完整导入到系统中，包括所有必要的配置步骤。
|
||
|
||
## 🎯 导入流程概览
|
||
|
||
```
|
||
1. 创建量表基本信息
|
||
↓
|
||
2. 添加题目（题目管理）
|
||
↓
|
||
3. 为每个题目添加选项（选项管理）
|
||
↓
|
||
4. 添加因子（因子管理）
|
||
↓
|
||
5. 配置因子计分规则（计分规则管理）
|
||
↓
|
||
6. 配置结果解释（解释配置）
|
||
↓
|
||
7. 配置预警规则（可选，预警规则配置）
|
||
↓
|
||
8. 启用量表并测试
|
||
```
|
||
|
||
---
|
||
|
||
## 📝 详细操作步骤
|
||
|
||
### 步骤1：创建量表基本信息
|
||
|
||
**路径**：`心理测评管理` → `量表管理`
|
||
|
||
**操作步骤**：
|
||
1. 点击 **"新增"** 按钮
|
||
2. 填写量表基本信息：
|
||
- **量表编码**：唯一标识，如 `SCL_90`、`EPQ_001`（必填）
|
||
- **量表名称**：如 `症状自评量表SCL-90`（必填）
|
||
- **量表类型**：选择类型（情绪、人格、行为等）
|
||
- **量表简介**：简短介绍
|
||
- **量表描述**：详细描述
|
||
- **题目数量**：预计题目数（如 `90`）
|
||
- **预计完成时间**：分钟数（如 `30`）
|
||
- **适用人群**：如 `一般人群`、`青少年`等
|
||
- **作者**：量表作者
|
||
- **来源**：量表来源
|
||
- **状态**：选择 `正常`（启用）或 `停用`
|
||
3. 点击 **"确定"** 保存
|
||
|
||
**注意事项**：
|
||
- 量表编码必须唯一
|
||
- 状态选择 `正常` 后，量表才会在测评选择页面显示
|
||
- 题目数量可以后续修改
|
||
|
||
---
|
||
|
||
### 步骤2：添加题目（题目管理）
|
||
|
||
**路径**：`心理测评管理` → `量表管理` → 点击量表行的 **"题目管理"** 按钮
|
||
|
||
**操作步骤**：
|
||
1. 在量表列表中找到刚创建的量表
|
||
2. 点击该行的 **"题目管理"** 按钮
|
||
3. 进入题目管理页面后，点击 **"新增"** 按钮
|
||
4. 填写题目信息：
|
||
- **题目序号**：如 `1`、`2`、`3`...（必填，用于排序）
|
||
- **题目内容**：题目的完整文字内容（必填）
|
||
- **题目类型**：选择 `单选题` 或 `多选题`
|
||
- **是否必答**：选择 `是` 或 `否`
|
||
- **排序**：数字越小越靠前（可选）
|
||
5. 点击 **"确定"** 保存
|
||
6. 重复步骤3-5，添加所有题目
|
||
|
||
**批量添加技巧**：
|
||
- 可以一次性添加多个题目，然后逐个配置选项
|
||
- 建议先添加所有题目，再统一配置选项
|
||
|
||
**注意事项**：
|
||
- 题目序号建议连续，从1开始
|
||
- 题目内容支持富文本（如果需要）
|
||
- 题目类型决定了后续选项的配置方式
|
||
|
||
---
|
||
|
||
### 步骤3：为每个题目添加选项（选项管理）
|
||
|
||
**路径**：在题目管理页面，点击题目行的 **"选项管理"** 按钮
|
||
|
||
**操作步骤**：
|
||
1. 在题目列表中，找到要配置选项的题目
|
||
2. 点击该行的 **"选项管理"** 按钮
|
||
3. 在弹出的对话框中，点击 **"新增"** 按钮
|
||
4. 填写选项信息：
|
||
- **选项编码**：如 `A`、`B`、`C`、`D` 或 `1`、`2`、`3`、`4`（必填）
|
||
- **选项内容**：选项的文字内容（必填）
|
||
- **选项分数**：该选项对应的分数（必填，如 `0`、`1`、`2`、`3`）
|
||
- **排序**：数字越小越靠前（可选）
|
||
5. 点击 **"确定"** 保存
|
||
6. 重复步骤3-5，为该题目添加所有选项
|
||
7. 点击对话框的 **"关闭"** 按钮
|
||
8. 重复步骤1-7，为所有题目配置选项
|
||
|
||
**选项配置示例**：
|
||
|
||
**单选题示例**（如焦虑自评量表）：
|
||
- 选项A：没有或很少时间（分数：1）
|
||
- 选项B：小部分时间（分数：2）
|
||
- 选项C：相当多时间（分数：3）
|
||
- 选项D：绝大部分或全部时间（分数：4）
|
||
|
||
**多选题示例**（如症状自评量表）：
|
||
- 选项A：没有（分数：0）
|
||
- 选项B：很轻（分数：1）
|
||
- 选项C：中等（分数：2）
|
||
- 选项D：偏重（分数：3）
|
||
- 选项E：严重（分数：4）
|
||
|
||
**注意事项**：
|
||
- 选项编码在同一题目内必须唯一
|
||
- 选项分数用于后续计分，必须准确
|
||
- 单选题通常每个选项对应一个分数
|
||
- 多选题可能需要累加分数或取最高分
|
||
|
||
---
|
||
|
||
### 步骤4：添加因子（因子管理）
|
||
|
||
**路径**：`心理测评管理` → `量表管理` → 点击量表行的 **"因子管理"** 按钮
|
||
|
||
**操作步骤**：
|
||
1. 在量表列表中找到量表
|
||
2. 点击该行的 **"因子管理"** 按钮
|
||
3. 进入因子管理页面后，点击 **"新增"** 按钮
|
||
4. 填写因子信息：
|
||
- **因子编码**：如 `F1`、`F2`、`F3` 或 `躯体化`、`强迫`等（必填）
|
||
- **因子名称**：如 `躯体化因子`、`强迫症状因子`（必填）
|
||
- **因子描述**：因子的详细说明（可选）
|
||
- **排序**：数字越小越靠前（可选）
|
||
5. 点击 **"确定"** 保存
|
||
6. 重复步骤3-5，添加所有因子
|
||
|
||
**因子配置示例**（如SCL-90量表）：
|
||
- 因子1：躯体化
|
||
- 因子2：强迫症状
|
||
- 因子3：人际关系敏感
|
||
- 因子4：抑郁
|
||
- 因子5：焦虑
|
||
- 因子6：敌对
|
||
- 因子7：恐怖
|
||
- 因子8：偏执
|
||
- 因子9：精神病性
|
||
|
||
**注意事项**：
|
||
- 因子编码在同一量表内必须唯一
|
||
- 因子用于后续的计分规则配置和结果解释
|
||
- 如果量表没有因子（只有总分），可以跳过此步骤
|
||
|
||
---
|
||
|
||
### 步骤5：配置因子计分规则（计分规则管理）
|
||
|
||
**路径**：在因子管理页面，点击因子行的 **"计分规则"** 按钮
|
||
|
||
**操作步骤**：
|
||
1. 在因子列表中，找到要配置计分规则的因子
|
||
2. 点击该行的 **"计分规则"** 按钮
|
||
3. 在弹出的对话框中，点击 **"新增规则"** 按钮
|
||
4. 在表格中配置规则：
|
||
- **题目**：从下拉框中选择题目（显示题目序号和内容）
|
||
- **选项**：从下拉框中选择选项（多选，可选，留空表示所有选项）
|
||
- **权重**：该规则在计分中的权重（0-10，默认1.00）
|
||
- **计算方式**：选择 `求和`、`平均`、`最大`、`最小`
|
||
5. 重复步骤3-4，为该因子添加所有计分规则
|
||
6. 点击 **"保存"** 按钮保存所有规则
|
||
7. 重复步骤1-6，为所有因子配置计分规则
|
||
|
||
**计分规则配置示例**：
|
||
|
||
**示例1：简单求和**（如SCL-90的躯体化因子）：
|
||
- 规则1：题目1 → 所有选项 → 权重1.00 → 计算方式：求和
|
||
- 规则2：题目4 → 所有选项 → 权重1.00 → 计算方式：求和
|
||
- 规则3：题目12 → 所有选项 → 权重1.00 → 计算方式：求和
|
||
- ...（包含所有属于该因子的题目）
|
||
|
||
**示例2：加权求和**（如某些量表的因子）：
|
||
- 规则1：题目1 → 选项A,B → 权重2.00 → 计算方式：求和
|
||
- 规则2：题目2 → 所有选项 → 权重1.00 → 计算方式：求和
|
||
|
||
**注意事项**：
|
||
- 计分规则决定了因子分数的计算方式
|
||
- 如果某个题目属于多个因子，需要为每个因子都配置规则
|
||
- 计算方式：
|
||
- **求和**：所有选中选项的分数之和 × 权重
|
||
- **平均**：所有选中选项的分数平均值 × 权重
|
||
- **最大**：所有选中选项的分数最大值 × 权重
|
||
- **最小**：所有选中选项的分数最小值 × 权重
|
||
|
||
---
|
||
|
||
### 步骤6：配置结果解释（解释配置）
|
||
|
||
**路径**：`心理测评管理` → `解释配置`
|
||
|
||
**操作步骤**：
|
||
1. 进入解释配置页面
|
||
2. 点击 **"新增"** 按钮
|
||
3. 填写解释信息：
|
||
- **量表**：从下拉框中选择量表（可选，留空表示通用解释）
|
||
- **因子**：从下拉框中选择因子（可选，留空表示总体解释；需先选择量表）
|
||
- **分数下限**：该解释适用的最低分数（必填）
|
||
- **分数上限**：该解释适用的最高分数（必填）
|
||
- **等级**：如 `低`、`中`、`高`（可选）
|
||
- **等级名称**：如 `轻度`、`中度`、`重度`（可选）
|
||
- **解释标题**：解释的标题（必填）
|
||
- **解释内容**：详细的解释说明（可选）
|
||
- **建议指导**：针对该分数段的建议或指导（可选）
|
||
- **排序**：数字越小越靠前（可选）
|
||
4. 点击 **"确定"** 保存
|
||
5. 重复步骤2-4，为所有分数段配置解释
|
||
|
||
**结果解释配置示例**（如SCL-90的躯体化因子）：
|
||
- 解释1：量表=SCL-90，因子=躯体化，分数范围=0-10，等级=低，解释标题="正常范围"
|
||
- 解释2：量表=SCL-90，因子=躯体化，分数范围=11-20，等级=中，解释标题="轻度症状"
|
||
- 解释3：量表=SCL-90，因子=躯体化，分数范围=21-30，等级=高，解释标题="中度症状"
|
||
- 解释4：量表=SCL-90，因子=躯体化，分数范围=31-40，等级=高，解释标题="重度症状"
|
||
|
||
**注意事项**：
|
||
- 分数范围不能重叠（系统会根据分数自动匹配解释）
|
||
- 可以为量表总体配置解释（因子留空）
|
||
- 可以为特定因子配置解释（选择因子）
|
||
- 可以为通用情况配置解释（量表和因子都留空）
|
||
|
||
---
|
||
|
||
### 步骤7：配置预警规则（可选）
|
||
|
||
**路径**：`心理测评管理` → `预警规则配置`
|
||
|
||
**操作步骤**：
|
||
1. 进入预警规则配置页面
|
||
2. 点击 **"新增"** 按钮
|
||
3. 填写预警规则信息：
|
||
- **量表**：从下拉框中选择量表（必填）
|
||
- **因子**：从下拉框中选择因子（可选，留空表示针对总分）
|
||
- **规则名称**：如 `重度抑郁预警`（必填）
|
||
- **预警等级**：选择 `低`、`中`、`高`、`紧急`（必填）
|
||
- **分数下限**：触发预警的最低分数（可选）
|
||
- **分数上限**：触发预警的最高分数（可选）
|
||
- **百分位下限**：触发预警的最低百分位（可选）
|
||
- **百分位上限**：触发预警的最高百分位（可选）
|
||
- **自动解除**：是否自动解除预警（可选）
|
||
- **解除条件**：自动解除的条件（可选）
|
||
- **状态**：选择 `正常`（启用）或 `停用`
|
||
4. 点击 **"确定"** 保存
|
||
5. 重复步骤2-4，配置所有预警规则
|
||
|
||
**预警规则配置示例**：
|
||
- 规则1：量表=SCL-90，因子=抑郁，预警等级=高，分数范围=30-40，状态=正常
|
||
- 规则2：量表=SCL-90，因子=焦虑，预警等级=紧急，分数范围=35-40，状态=正常
|
||
|
||
**注意事项**：
|
||
- 预警规则用于在测评结果异常时自动向管理员发出警告
|
||
- 可以针对特定因子配置，也可以针对总分配置
|
||
- 预警等级决定了警告的严重程度
|
||
- 只有状态为 `正常` 的规则才会生效
|
||
|
||
---
|
||
|
||
### 步骤8：启用量表并测试
|
||
|
||
**操作步骤**：
|
||
1. 返回 `量表管理` 页面
|
||
2. 确认量表状态为 `正常`（如果为 `停用`，点击修改改为 `正常`）
|
||
3. 确认所有配置已完成：
|
||
- ✅ 量表基本信息已填写
|
||
- ✅ 题目已添加（至少1题）
|
||
- ✅ 每个题目都有选项（至少1个选项）
|
||
- ✅ 因子已添加（如果有因子）
|
||
- ✅ 因子计分规则已配置（如果有因子）
|
||
- ✅ 结果解释已配置（至少1条）
|
||
4. 测试量表：
|
||
- 进入 `测评管理` → `开始测评`
|
||
- 选择刚创建的量表
|
||
- 填写被测评人信息
|
||
- 开始答题，完成所有题目
|
||
- 提交测评
|
||
- 查看生成的报告，验证：
|
||
- 分数计算是否正确
|
||
- 因子分数是否正确（如果有因子）
|
||
- 结果解释是否正确显示
|
||
- 预警是否正常触发（如果配置了预警规则）
|
||
|
||
---
|
||
|
||
## 📊 配置检查清单
|
||
|
||
在完成量表导入后，使用以下清单检查配置是否完整：
|
||
|
||
### 基本信息
|
||
- [ ] 量表编码已填写且唯一
|
||
- [ ] 量表名称已填写
|
||
- [ ] 量表状态为 `正常`
|
||
- [ ] 题目数量与实际题目数一致
|
||
|
||
### 题目配置
|
||
- [ ] 至少添加了1个题目
|
||
- [ ] 所有题目都有题目序号
|
||
- [ ] 所有题目都有题目内容
|
||
- [ ] 题目类型已选择（单选/多选）
|
||
|
||
### 选项配置
|
||
- [ ] 每个题目至少添加了1个选项
|
||
- [ ] 所有选项都有选项编码
|
||
- [ ] 所有选项都有选项内容
|
||
- [ ] 所有选项都有选项分数
|
||
|
||
### 因子配置（如果有因子）
|
||
- [ ] 至少添加了1个因子
|
||
- [ ] 所有因子都有因子编码
|
||
- [ ] 所有因子都有因子名称
|
||
|
||
### 计分规则配置（如果有因子）
|
||
- [ ] 每个因子至少配置了1条计分规则
|
||
- [ ] 计分规则中的题目都已选择
|
||
- [ ] 计分规则中的权重已设置
|
||
- [ ] 计分规则中的计算方式已选择
|
||
|
||
### 结果解释配置
|
||
- [ ] 至少配置了1条结果解释
|
||
- [ ] 结果解释的分数范围已设置
|
||
- [ ] 结果解释的解释标题已填写
|
||
- [ ] 结果解释的解释内容已填写（建议）
|
||
|
||
### 预警规则配置（可选）
|
||
- [ ] 预警规则已配置（如果需要）
|
||
- [ ] 预警规则的量表已选择
|
||
- [ ] 预警规则的预警等级已选择
|
||
- [ ] 预警规则的状态为 `正常`
|
||
|
||
---
|
||
|
||
## 🔍 常见问题
|
||
|
||
### Q1：量表创建后，在测评选择页面看不到？
|
||
**A**：检查以下几点：
|
||
- 量表状态是否为 `正常`
|
||
- 量表是否有至少1个题目
|
||
- 刷新浏览器页面
|
||
|
||
### Q2：题目添加后，选项管理按钮点击没反应？
|
||
**A**：检查以下几点：
|
||
- 题目是否已保存
|
||
- 浏览器控制台是否有错误
|
||
- 尝试刷新页面
|
||
|
||
### Q3：因子计分规则配置后，分数计算不正确？
|
||
**A**：检查以下几点：
|
||
- 选项分数是否正确
|
||
- 计分规则中的题目是否选择正确
|
||
- 计分规则中的计算方式是否合适
|
||
- 权重设置是否正确
|
||
|
||
### Q4：结果解释不显示？
|
||
**A**：检查以下几点：
|
||
- 是否配置了结果解释
|
||
- 结果解释的分数范围是否覆盖了实际分数
|
||
- 结果解释的量表和因子是否匹配
|
||
|
||
### Q5：预警规则不触发？
|
||
**A**：检查以下几点：
|
||
- 预警规则的状态是否为 `正常`
|
||
- 预警规则的分数范围是否设置正确
|
||
- 测评结果是否满足预警条件
|
||
|
||
---
|
||
|
||
## 📚 相关文档
|
||
|
||
- [功能使用指南](./使用指南-功能测试说明.md)
|
||
- [用户注册和量表权限管理功能开发](./14-用户注册和量表权限管理功能开发.md)
|
||
|
||
---
|
||
|
||
## ✅ 完成标志
|
||
|
||
当以下所有条件满足时，量表导入完成：
|
||
|
||
1. ✅ 量表在测评选择页面可以正常选择
|
||
2. ✅ 可以正常开始测评并答题
|
||
3. ✅ 提交测评后可以正常生成报告
|
||
4. ✅ 报告中的分数计算正确
|
||
5. ✅ 报告中的结果解释正确显示
|
||
6. ✅ 预警规则正常触发（如果配置了）
|
||
|
||
---
|
||
|
||
**最后更新**：2025-11-06
|
||
|